DNF5-ALIASES(7)

NUME
dnf5-aliases - pseudonime (alias) pentru argumentele din linia de comandă

DESCRIERE

Este posibil să se definească pseudonime personalizate care pot fi apoi utilizate drept comenzi sau opțiuni dnf pentru a abrevia secvențe mai lungi de comenzi și opțiuni.

Pseudonimele pot fi configurate în formatul TOML iar fișierele de configurare sunt preluate din aceste directoare „drop-in”:

•   /usr/share/dnf5/aliases.d/

•   /etc/dnf/dnf5-aliases.d/

•   $XDG_CONFIG_HOME/dnf5/aliases.d/

  Sintaxă:

Fișierul de configurare trebuie să înceapă cu atributul version definit la o versiune cerută, de exemplu:

    version = '1.1'

Fiecare alias este definit într-o secțiune separată, utilizând, de exemplu, perechi cheie = valoare:

    ['in']
    type = 'command'
    attached_command = 'install'
    descr.C = "Alias for 'install'"
    descr.ro_RO = "Alias pentru 'install'"

Numele secțiunii identifică în mod unic pseudonimul. Acesta este sub forma unei rute, adică unul sau mai multe șiruri separate prin puncte, care definește domeniul de aplicare al pseudonimului. De exemplu, șirul „group.list.in” ar identifica un alias utilizabil numai în cadrul domeniului de aplicare al subcomenzii «group list».

Există următoarele tipuri de alias:

•   comanda

•   cloned_named_arg

•   named_arg

•   group

  Tipul: command

Pseudonimul command definește un alias pentru o comandă.

Chei:

•   type - Trebuie să aibă valoarea command.

•   attached_command - Ruta către o comandă pentru care este definit acest alias.

•   descr.<limba-sistemului> – Descrierea care va fi afișată în ajutor. descr.C este utilizată dacă nu este găsită o descriere pentru configurația regională corespunzătoare. Adăugată în versiunea 1.1 a fișierului de configurare.

•   descr – Descrierea care va fi afișată în ajutor. Depreciată în versiunea 1.1, dar rămâne compatibilă cu versiunile anterioare. Nu acceptă utilizarea configurației regionale a sistemului.

•   group_id - Un grup din care face parte acest alias, dacă există.

•   complete - Dacă autocompletarea bash ar trebui utilizată pentru acest alias, implicit este „false”.

•   Valori (argumente poziționale) consumate de comanda alias. Formatul este o matrice de tabele; fiecare trebuie să includă fie value_help.<limba-sistemului> pentru configurația regională activă, fie value_help.C, și poate include opțional descr.<limba-sistemului>. Valoarea implicită este o matrice goală. Adăugată în versiunea 1.1 a fișierului de configurare.

•   Opțiuni care vor fi utilizate cu comanda. Formatul este o matrice de tabele, fiecare dintre acestea trebuie să conțină o cheie id_path pentru a specifica ruta către o opțiune și poate conține și o cheie value pentru a specifica valoarea opțiunii. value poate conține marcaje de poziție ${index}, care sunt înlocuite cu valorile consumate de aliasul comenzii (astfel cum este definit de required_values). Argumentele comenzii încep la indexul 1. Indexul 0 se referă la comanda alias în sine. Dacă nu este furnizată nicio cheie value, un șir gol va fi transmis argumentelor numite care așteaptă o valoare.

    Cheile necesare sunt type, și attached_command.

Exemple:

•   Alias grouplist pentru group list:

        ['grouplist']
        type = 'command'
        attached_command = 'group.list'
        descr.C = "Alias for 'group list'"
        descr.ro_RO = "Alias pentru 'group list'"

•   Alias group.ls pentru group list:

        ['group.ls']
        type = 'command'
        attached_command = 'group.list'
        descr.C = "Alias for 'group list'"
        descr.ro_RO = "Alias pentru 'group list'"
        complete = true

•   Alias list-fedora-all pentru --repo=fedora list --showduplicates:

        ['list-fedora-all']
        type = 'command'
        attached_command = 'list'
        descr.C = "Alias for '--repo=fedora list --showduplicates'"
        descr.ro_RO = "Alias pentru '--repo=fedora list --showduplicates'"
        complete = true
        attached_named_args = [
            { id_path = 'repo', value = 'fedora' },
            { id_path = 'list.showduplicates' }
        ]

•   Alias whatrequires pentru repoquery --installed --whatrequires=<requires_first_argument>:

        ['whatrequires']
        type = 'command'
        attached_command = 'repoquery'
        descr = 'Alias pentru "repoquery --installed --whatrequires=<whatrequires_first_argument>"'
        complete = true
        [[whatrequires.required_values]]
        value_help.C = 'CAPABILITY,...'
        descr.C = 'Limit to packages that require any of <capabilities>.'
        descr.ro_RO = 'Limitează la pachetele care necesită oricare dintre <capabilities>.'
        [[whatrequires.attached_named_args]]
        id_path = 'repoquery.installed'
        [[whatrequires.attached_named_args]]
        id_path = 'repoquery.whatrequires'
        value='${1}'

  Tipul: cloned_named_arg

Numele-alias cloned_named_arg definește un alt nume pentru o anumită opțiune.

Chei:

•   type - Trebuie să aibă valoarea cloned_named_arg.

•   long_name - Numele opțiunii alias.

•   short_name - Prescurtarea cu o literă a numelui.

•   source - Ruta către opțiunea pentru care este definit acest alias.

•   group_id - Un grup din care face parte acest alias, dacă există.

•   complete - Dacă autocompletarea bash ar trebui utilizată pentru acest alias, implicit este „false”.

    Cheile necesare sunt type, fie long_name, fie short_name, și source.

Exemple:

•   Alias --nobest pentru --no-best:

        ['nobest']
        type = 'cloned_named_arg'
        long_name = 'nobest'
        source = 'no-best'

•   Alias repoquery --list sau repoquery -l pentru repoquery --files:

        ['repoquery.list']
        type = 'cloned_named_arg'
        long_name = 'list'
        short_name = 'l'
        source = 'repoquery.files'

  Tipul: named_arg

named_arg definește un alias care poate înlocui mai multe opțiuni și poate defini o valoare pentru fiecare.

Chei:

•   type - Trebuie să aibă valoarea named_arg.

•   long_name - Numele opțiunii alias.

•   short_name - Prescurtarea cu o literă a numelui.

•   descr.<limba-sistemului> – Descrierea care va fi afișată în ajutor. descr.C este utilizată dacă nu este găsită o descriere pentru configurația regională corespunzătoare. Adăugată în versiunea 1.1 a fișierului de configurare.

•   descr – Descrierea care va fi afișată în ajutor. Depreciată în versiunea 1.1, dar rămâne compatibilă cu versiunile anterioare. Nu acceptă utilizarea configurației regionale a sistemului.

•   has_value - Dacă opțiunea necesită o valoare. Valoarea este apoi înlocuită pentru șirurile ${} în valorile lui attached_named_args. Valoarea implicită este „false”.

•   value_help.<limba-sistemului> - Șirul afișat în ajutorul pentru valoare (de exemplu, CONFIG_FILE_PATH pentru --config=CONFIG_FILE_PATH). value_help.C este utilizat în cazul în care nu se găsește un șir pentru configurația regională corespunzătoare. Adăugată în versiunea 1.1 a fișierului de configurare.

•   value_help - Șirul afișat în ajutorul pentru valoare (de exemplu, CONFIG_FILE_PATH pentru --config=CONFIG_FILE_PATH). Depreciată în versiunea 1.1, dar rămâne compatibilă cu versiunile anterioare. Nu acceptă utilizarea configurației regionale a sistemului.

•   const_value - Valoarea constantă implicită (specificată numai dacă numele-alias nu are o valoare în linia de comandă). Valoarea este apoi înlocuită pentru șirurile ${} în valorile attached_named_args.

•   group_id - Un grup din care face parte acest alias, dacă există.

•   complete - Dacă autocompletarea bash ar trebui utilizată pentru acest alias, implicit este „false”.

•   attached_named_args - Opțiuni care vor fi utilizate. Formatul este o matrice de tabele în linie, fiecare dintre acestea trebuind să conțină o cheie id_path pentru a specifica ruta către o opțiune și poate conține și o cheie value pentru a specifica valoarea opțiunii.

    Cheile necesare sunt type, și fie long_name, fie short_name.

Exemple:

•   Alias list --all-available pentru list --showduplicates --available:

        ['list.all-available']
        type = 'named_arg'
        long_name = 'all-available'
        attached_named_args = [
            { id_path = 'list.showduplicates' },
            { id_path = 'list.available' }
        ]

•   Alias download --dest=DIRECTOR_DESTINAȚIE pentru download --destdir=DIRECTOR_DESTINAȚIE:

        ['download.dest']
        type = 'named_arg'
        long_name = 'dest'
        has_value = true
        value_help.C = 'DESTDIR'
        attached_named_args = [
            { id_path = 'download.destdir' }
        ]

•   Alias --settsflags=TS_FLAGS pentru --setopt=tsflags=TS_FLAGS:

        ['settsflags']
        type = 'named_arg'
        long_name = 'settsflags'
        descr.C = 'Set transaction flags'
        descr.ro_RO = 'Configurarea fanioanelor de tranzacție'
        has_value = true
        value_help.C = 'TS_FLAGS'
        attached_named_args = [
         { id_path = 'setopt', value = 'tsflags=${}' }
        ]

  Tipul: group

group definește un grup pentru mai multe comenzi sau opțiuni.

Cheile necesare::

•   type - Trebuie să aibă valoarea group.

•   header.<limba-sistemului> - Antetul grupului, așa cum va fi afișat în ajutor. header.C este utilizat dacă nu se găsește un antet pentru configurația regională corespunzătoare. Adăugată în versiunea 1.1 a fișierului de configurare.

•   header - Antetul grupului, așa cum va fi afișat în ajutor. Depreciată în versiunea 1.1, dar rămâne compatibilă cu versiunile anterioare. Nu acceptă utilizarea configurației regionale a sistemului.

    Cheile necesare sunt type și header.

    Numele-alias sunt adăugate la grup utilizând cheia group_id din secțiunile lor respective.

Exemple:

•   Grupul query-aliases pentru subcomanda repo care conține pseudonimele repo.ls și repo.if:

        ['repo.query-aliases']
        type = 'group'
        header.C = 'Query Aliases:'
        header.ro_RO = 'Alias pentru interogări:'
        ['repo.ls']
        type = 'command'
        attached_command = 'repo.list'
        descr.C = "Alias for 'repo list'"
        descr.ro_RO = "Alias pentru 'repo list'"
        group_id = 'query-aliases'
        ['repo.if']
        type = 'command'
        attached_command = 'repo.info'
        descr.C = "Alias for 'repo info'"
        descr.ro_RO = "Alias pentru 'repo info'"
        group_id = 'query-aliases'

Autor
A se vedea AUTHORS.md în distribuția sursei dnf5.

Drepturi de autor
Contribuitori la proiectul dnf5.

TRADUCERE
Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 (https://www.gnu.org/licenses/gpl-3.0.html) sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE.

Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.