warpdotdev/command-signatures

Profil warpdotdev

Dernière activité source enregistrée: 4 août 2026 à 23:01

Catalogue SkillsMP mis à jour: 17 octobre 2026 à 00:09

skills collectés: 5

Étoiles GitHub: 6
Forks GitHub: 10

README du dépôt

Fichier source du README : README.md

Lire le README source

Afficher le README complet

# command-signatures ## JSON Command Signatures The command signatures, a.k.a. "specs", are stored in the `./command-signatures/json`. All the specs in `./command-signatures/json/*.json` are hand-written. Those which are generated programmatically are in `./command-signatures/json/autogenerated/**/*.json`. Currently, we only autogenerate specs for PowerShell cmdlets. You can trigger this process with: ```sh cargo run --bin autogenerate_powershell ``` This must be rerun any time we change our autogeneration logic or Microsoft updates PowerShell's cmdlets. When making changes to this script, put the git hunks for the autogenerated specs into a separate commit to make PR review easier. ### Overriding Autogenerated Commands We often need to augment autogenerated specs with hand-written data. Hand-written data cannot be defined in an autogenerated file, but must live in a separate, persistent set of files. That is what `./command-signatures/json/overrides/**/*.json` is for. When running the autogeneration script, it'll check this dir and merge the data there into the generated result. You can _kind of_ think of the override process as a recursive object merge _a.la._ [Lodash's merge](https://lodash.com/docs/latest#merge), but this isn't totally accurate. Options' names are not object keys, and so a true recursive merge isn't the semantics we want. Furthermore, positional arguments are arrays and we need the ability to override at arbitrary positions, e.g. override argument 2 without needing to override 0 and 1. Options are therefore matched by the `OptionOverrides::name` field and positional arguments are matched by `ArgOverrides::index`, e.g. for PowerShell's `Set-Location` cmdlet: ```json { "args": [ { "index": 0, "template": ["folders"] } ], "options": [ { "name": "-Path", "args": { "index": 0, "template": ["folders"] } }, { "name": "-LiteralPath", "args": { "index": 0, "template": ["folders"] } } ] } ``` **Note:** Overrides for all fields on `fig_types::{Arg, Option}` may not be implemented yet. At the time of writing, _only_ `template` is supported. Others will need to be added as needed. ## License This project is licensed under the MIT License. See the LICENSE file for details. Many of the signatures were adapted from Fig (https://github.com/withfig/autocomplete), which is also licensed under the MIT License. Warp requires contributors to sign a contributor license agreement (CLA) before their contributions can be merged. You can read and sign our CLA at https://cla.warp.dev.

Chargement du README du dépôt…

Skills dans ce dépôt

Administrateurs de réseaux et de systèmes informatiques Analystes en assurance qualité des logiciels et testeurs Développeurs de logiciels

3 catégories métier · 100% classifié

skill

métier

description

mis à jour

review-pr-local

Analystes en assurance qualité des logiciels et testeurs

Repo-specific review guidance for command-signatures. Only the categories declared overridable by the core review-pr skill may be specialized here.