DNF5-ALIASES(7)

NAMN
dnf5-aliases — Alias för kommandoradsargument

BESKRIVNING

Det är möjligt att definiera anpassade alias som sedan kan användas som dnf-kommandon eller -flaggor för att förkorta längre kommando- och flaggsekvenser.

Aliasen kan konfigureras i formatet TOML och konfigurationsfilerna laddas från dessa instickskataloger:

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

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

•   $XDG_CONFIG_HOME/dnf5/aliases.d/

  Syntax:

Konfigurationsfilen måste börja med attributet version satt till en nödvändig version, till exempel:

    version = '1.1'

Varje alias definieras i en separat sektion, med par nyckel = värde, till exempel:

    ['in']
    type = 'command'
    attached_command = 'install'
    descr.C = "Alias for 'install'"
    descr.sv_SE = "Alias för 'install'"

Sektionsnamnet identifierar unikt aliaset. Det har formen av en sökväg, d.v.s. en eller flera strängar avdelade med punkter, vilket definierar räckvidden för aliaset. Till exempel skulle strängen ”group.list.in” identifiera ett alias som bara är användbart inom underkommandot group list.

Det finns följande sorters alias:

•   command

•   cloned_named_arg

•   named_arg

•   group

  Typ: command

Aliaset command definierar ett alias för ett kommando.

Nycklar:

•   type — Måste ha värdet command.

•   attached_command — Sökväg till ett kommando för vilket aliaset definieras.

•   descr.<lokal> — Beskrivning som kommer att visas i hjälpen. descr.C används om det inte finns någon beskrivning för den tillämpliga lokalen. Tillagt i konfigurationsfilversion 1.1.

•   descr — Beskrivning som kommer att visas i hjälpen. Avrådes från i version 1.1, men finns kvar som bakåtkompatibilitet. Stödjer inte lokaler.

•   group_id — En grupp som detta alias är en del av, om någon.

•   complete — Huruvida bashs automatkomplettering skall användas för detta alias, standard är false.

•   required_values — Värden (positionsargument) som används av kommandoaliaset. Formatet är en vektor med tabeller; var och en måste inkludera antingen value_help.<lokal> för den aktiva lokalen eller value_help.C, och kan inkludera descr.<lokal>. Standardvärdet är en tom vektor. Tillagt i konfigurationsfilsversion 1.1.

•   attached_named_args — Flaggor som kommer användas med kommandot. Formatet är en vektor av tabeller, där var och en måste innehålla en nyckel id_path för att ange sökvägen till en flagga, och kan även innehålla en nyckel value för att ange värdet på flaggan. Value kan innehålla platsmarkörer ${index} vilka ersätts av värden som används av kommandoaliaset (så som det definierats med required_values). Kommandoargument börjar med index 1. Index 0 refererar till kommandoaliaset självt. Om ingen nyckel value ges kommer en tom sträng skickas till namngivna argument som förväntar sig ett värde.

    De obligatoriska nycklarna är type och attached_command.

Exempel:

•   Aliasa grouplist för group list:

        ['grouplist']
        type = 'command'
        attached_command = 'group.list'
        descr.C = "Alias for 'group list'"
        descr.sv_SE = "Alias för 'group list'"
        descr.cs_CZ = "Alias pro 'group list'"

•   Aliasa group.ls för group list:

        ['group.ls']
        type = 'command'
        attached_command = 'group.list'
        descr.C = "Alias for 'group list'"
        descr.sv_SE = "Alias för 'group list'"
        descr.cs_CZ = "Alias pro 'group list'"
        complete = true

•   Aliasa list-fedora-all för --repo=fedora list --showduplicates:

        ['list-fedora-all']
        type = 'command'
        attached_command = 'list'
        descr.C = "Alias for '--repo=fedora list --showduplicates'"
        descr.sv_SE = "Alias för '--repo=fedora list --showduplicates'"
        descr.cs_CZ = "Alias pro '--repo=fedora list --showduplicates'"
        complete = true
        attached_named_args = [
            { id_path = 'repo', value = 'fedora' },
            { id_path = 'list.showduplicates' }
        ]

•   Aliasa whatrequires för repoquery --installed --whatrequires=<första_argment_till_requires>:

        ['whatrequires']
        type = 'command'
        attached_command = 'repoquery'
        descr = 'Alias for "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.sv_SE = 'Begränsa till paket som behöver någon av <förmågor>.descr.cs_CZ = 'Omezí se na balíčky vyžadující něco z <capabilities>.'
        [[whatrequires.attached_named_args]]
        id_path = 'repoquery.installed'
        [[whatrequires.attached_named_args]]
        id_path = 'repoquery.whatrequires'
        value='${1}'

  Typ: cloned_named_arg

Aliaset cloned_named_arg definierar ett annat namn för en given flagga.

Nycklar:

•   type — Måste ha värdet cloned_named_arg.

•   long_name — Namn på aliasflaggan.

•   short_name — Enbokstavsgenväg för namnet.

•   source — Sökväg till flaggan för vilken detta alias är definierat.

•   group_id — En grupp som detta alias är en del av, om någon.

•   complete — Huruvida bashs automatkomplettering skall användas för detta alias, standard är false.

    De obligatoriska nycklarna är type, antingen long_name eller short_name och source.

Exempel:

•   Aliasa --nobest för --no-best:

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

•   Aliasa repoquery --list eller repoquery -l för repoquery --files:

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

  Typ: named_arg

named_arg definierar ett alias som kan ersätta flera flaggor och kan definiera ett värde för var och en.

Nycklar:

•   type — Måste ha värdet named_arg.

•   long_name — Namn på aliasflaggan.

•   short_name — Enbokstavsgenväg för namnet.

•   descr.<lokal> — Beskrivning som kommer att visas i hjälpen. descr.C används om det inte finns någon beskrivning för den tillämpliga lokalen. Tillagt i konfigurationsfilversion 1.1.

•   descr — Beskrivning som kommer att visas i hjälpen. Avrådes från i version 1.1, men finns kvar som bakåtkompatibilitet. Stödjer inte lokaler.

•   has_value — Huruvida flaggan behöver ett värde. Värdet ersätter sedan strängen ${} i värden till attached_named_args. Standardvärdet är false.

•   value_help.<locale> — Strängen som visas i hjälpen för värdet (t.ex. CONFIG_FILE_PATH för --config=CONFIG_FILE_PATH). value_help.C används om det inte finns någon sträng för den tillämpliga lokalen. Tillagt i konfigurationsfilversion 1.1.

•   value_help — Strängen som visas i hjälpen för värdet (t.ex. CONFIG_FILE_PATH för --config=CONFIG_FILE_PATH). Avrådes från i version 1.1, men finns kvar som bakåtkompatibilitet. Stödjer inte lokaler.

•   const_value — Konstant standardvärde (anges bara om aliaset inte har något värde på kommandoraden). Värdet ersätter sedan strängen ${} i värdet av attached_named_args.

•   group_id — En grupp som detta alias är en del av, om någon.

•   complete — Huruvida bashs automatkomplettering skall användas för detta alias, standard är false.

•   attached_named_args — Flaggor som kommer användas. Formatet är en vektor av inline-tabeller, där var och en måste innehålla en nyckel id_path för att ange en viss sökväg till en flagga, och kan även innehålla en nyckel value för att ange värdet på flaggan.

    De obligatoriska nycklarna är type, och antingen long_name eller short_name.

Exempel:

•   Aliasa list --all-available för list --showduplicates --available:

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

•   Aliasa download --dest=DESTDIR för download --destdir=DESTDIR:

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

•   Aliasa --settsflags=TS_FLAGS för --setopt=tsflags=TS_FLAGS:

        ['settsflags']
        type = 'named_arg'
        long_name = 'settsflags'
        descr.C = 'Set transaction flags'
        descr.sv_SE = 'Sätt transaktionsflaggor'
        descr.cs_CZ = 'Nastavit parametry transakce'
        has_value = true
        value_help.C = 'TS_FLAGS'
        attached_named_args = [
         { id_path = 'setopt', value = 'tsflags=${}' }
        ]

  Typ: group

group definierar en grupp av flera kommandon eller flaggor.

Obligatoriska nycklar:

•   type — Måste ha värdet group.

•   header.<lokal> — Huvudet på gruppen som det kommer att visas i hjälpen. header.C används om det inte finns något huvud för den tillämpliga lokalen. Tillagt i konfigurationsfilsversion 1.1.

•   header — Huvudet på gruppen som det kommer att visas i hjälpen. Avrådes från i version 1.1, men finns kvar som bakåtkompatibilitet. Stödjer inte lokaler.

    De obligatoriska nycklarna är type och header.

    Aliasen läggs till i gruppen med nyckeln group_id i sina respektive sektioner.

Exempel:

•   En grupp query-aliases för underkommandot repo som innehåller aliasen repo.ls och repo.if:

        ['repo.query-aliases']
        type = 'group'
        header.C = 'Query Aliases:'
        header.sv_SE = 'Frågealias:'
        header.cs_CZ = 'Zkratky pro dotazy:'
        ['repo.ls']
        type = 'command'
        attached_command = 'repo.list'
        descr.C = "Alias for 'repo list'"
        descr.sv_SE = "Alias för 'repo list'"
        descr.cs_CZ = "Alias pro 'repo list'"
        group_id = 'query-aliases'
        ['repo.if']
        type = 'command'
        attached_command = 'repo.info'
        descr.C = "Alias for 'repo info'"
        descr.sv_SE = "Alias för 'repo info'"
        descr.cs_CZ = "Alias pro 'repo info'"
        group_id = 'query-aliases'

Upphovsman
Se AUTHORS.md i dnf5 källkodsdistribution.

Copyright
Medarbetare i dnf5-projektet.

ÖVERSÄTTNING
Den svenska översättningen av denna manualsida skapades av Göran Uddeborg <goeran@uddeborg.se>

Denna översättning är fri dokumentation; läs GNU General Public License Version 3 (https://www.gnu.org/licenses/gpl-3.0.html) eller senare för upphovsrättsvillkor. Vi tar INGET ANSVAR.

Om du hittar fel i översättningen av denna manualsida, skicka ett mail till Tp-sv@listor.tp-sv.se.