====== RPM balicky ======
===== Inicializace prostredi =====
<WRAP center round important 60%>
Pro build balicku je durazne doporuceno pouzivat jineho / specialniho dedikovaneho uzivatele!
</WRAP>

  - Nejdrive je nutne nainstalovat potrebne zavislosti<code bash>
$ sudo dnf install gcc rpm-build rpm-devel rpmlint make python bash coreutils diffutils patch rpmdevtools
</code>
  - Vytvorime a prepneme se na noveho uzivatele<code bash>
$ sudo useradd <user>
$ sudo -iu <user>
</code>
  - Pote vytvorime adresare a nastavime promenne pro vybraneho uzivatele<code bash>
$ rpmdev-setuptree
</code>

===== Novy *.spec =====
<code bash>
$ rpmdev-newspec [<jmeno projektu>]
</code>

<WRAP center round tip 60%>
<code>$ ll /etc/rpmdevtools/</code>
Vypise dostupne sablony, jde o soubory //spectemplate-<jmeno>.spec//. Zadave se pouze //jmeno// sablony.
</WRAP>


===== Overeni / Linting =====
<code bash>
$ rpmlint <*.spec>|<*.rpm>|<*.src.rpm>
</code>

a seznam nejcastejsich chyb zde: https://fedoraproject.org/wiki/Common_Rpmlint_issues

===== Build balicku =====
<code bash>
$ rpmbuild [-ba|-bb|-bs] <spec file>
</code>

//Spec file// se zadava pouze jako jmeno bez plne cesty. Ke jmenu se predradi cesta k //RPM build root// - //~/rpmbuild/SPECS///, vytvorena pomoci [[#inicializace_prostredi|rpmdev-setuptree]]

===== Zvysovani verze balicku =====
<code bash>
$ rpmdev-bumpspec -c "blah blah" <*.spec>
</code>

===== COPR deploy =====
https://copr.fedorainfracloud.org
<file bash copr-build.sh>
#!/bin/bash
#
# Used to upload packages to COPR [ and that triggers build ]
#

set -eu

LOCAL_BUILD=""

function log {
   echo "BUILD.SH | $(date +"%Y/%m/%d %H:%M:%S") | $@"
}

function help {
    echo ""
    echo "Usage: ./build.sh [-h] [-l]"
    echo ""
    echo "Options:"
    echo "-h        show help"
    echo "-l        builds localy"
}

while getopts ":hl" opt; do
    case ${opt} in
        h ) # process option h
        help
        exit 0
        ;;
        l ) # process option l
        LOCAL_BUILD="1"
        ;;
        \? )
        echo "Unknown option: $OPTARG" 1>&2
        help
        exit 1
        ;;
    esac
done

# exit when uncommited changes are present
if ! git diff-index --quiet HEAD --; then
    log "Uncomitted changes detected. Aborting..." 1>&2
    exit 1
fi

# run linter on spec
log "Running linter..."
rpkg lint

if [ -n "$LOCAL_BUILD" ]; then
    log "Trying to build locally..."
    rpkg compile
else
    log "Tagging release..."
    rpkg tag

    log "Building in COPR..."
    #copr-cli build opentyrian "$PACKAGE"
    rpkg build -w nost23/opentyrian
fi

# vim: set ff=unix expandtab ts=4:
</file>

===== Tips =====
==== Vsechna preddefinovana makra ====
<code bash>$ less /usr/lib/rpm/macros</code>
https://docs.fedoraproject.org/en-US/packaging-guidelines/RPMMacros/

==== Potlaceni debug balicku ====
<WRAP center round tip 60%>
Mozne / nutne pouze v pripade pouziti maker //%make_*//.
</WRAP>

Na vrch //spec// souboru pridame:
<code>
%global debug_package %{nil}
</code>

==== SystemD ====
//Systemd units// nepatri do ///etc///, proto pouzijeme ve //spec file// v ceste promenou **%{_unitdir}**. Aby tato promena byla definovana, je nutne take uvest **BuildRequires: systemd**

<code>
BuildRequires:  systemd

...

%{_unitdir}/<service>.d/override.conf
</code>

<WRAP center round tip 60%>
Ke zjisteni cesty na aktualnim systemu, lze pouzit prikaz //rpm//:
<code>
$ rpm -E %{_unitdir}
</code>
</WRAP>

https://fedoraproject.org/wiki/Packaging:Systemd

==== Rebuild *.src.rpm ====
<code bash>
$ rpmbuild --rebuild <source-rpm>
$ rpmbuild --rebuild *.src.rpm
</code>

==== %files nastaveni opravneni / vlastnika  ====
<code>
%files
%defattr(-,root,root)
%doc %attr(0644,-,-) CREDITS
%doc NEWS
</code>

==== %find_lang makro ====
<code>
%install
...
%find_lang %{name}              # generate a special file list
...
  
%files -f %{name}.lang          # use the special file list
%defattr(-,root,root)           # list the other files
%doc README
...
</code>

nebo jazyky rucne

<code>
%files
%doc %lang(cs_CZ) %{_datadir}/%{name}/lang/cs-CZ/LC_MESSAGES/...
</code>

==== docasne soubory ====
aby doslo k odstraneni docasnych souboru spolecne s balickem, je nutne je oznacit jako **//%ghost//**
<code>
%install
touch $RPM_BUILD_ROOT%{_localstatedir}/log/blather.log
…
%files
…
%ghost %{_localstatedir}/log/blather.log
…
</code>

===== Links =====
https://rpm-packaging-guide.github.io

https://rpm-software-management.github.io/rpm/manual/macros.html