{
  "id": "cargo-release",
  "name": "cargo-release",
  "homepage": "https://github.com/crate-ci/cargo-release",
  "description": "Cargo subcommand `release`: everything about releasing a rust crate",
  "executables": [
    "cargo-release"
  ],
  "dotfiles": {
    "paths": [
      "~/.release.toml",
      "[configHome]/cargo-release/release.toml"
    ],
    "secret": []
  },
  "commands": {
    "format": 1,
    "label": "Release crate",
    "description": "Bump the version, publish, tag and push a crate. Dry-run is the default; tick Execute to really release. Per-step subcommands, sign options and certificate settings are left out.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": true,
      "short_bundles": false
    },
    "source": [
      {
        "id": "help",
        "kind": "help",
        "url": "https://github.com/crate-ci/cargo-release/blob/master/docs/reference.md",
        "revision": "2026-10-27",
        "evidence": "Usage: cargo release [OPTIONS] [LEVEL|VERSION]\n  [LEVEL|VERSION]  Either bump by LEVEL or set the VERSION for all selected packages [possible\n                   values: major, minor, patch, release, rc, beta, alpha]\n      --manifest-path <PATH>         Path to Cargo.toml\n  -p, --package <SPEC>               Package to process (see `cargo help pkgid`)\n      --workspace                    Process all packages in the workspace\n      --exclude <SPEC>               Exclude packages from being processed\n      --unpublished                  Process all packages whose current version is unpublished\n  -x, --execute                      Actually perform a release. Dry-run mode is the default\n      --no-confirm                   Skip release confirmation and version preview\n  -v, --verbose...                   Pass many times for more log output\n      --no-publish           Do not run cargo publish on release\n      --no-tag               Do not create git tag\n      --no-push             Do not run git push in the last step\n"
      }
    ],
    "field": [
      {
        "id": "level",
        "label": "Level or version",
        "description": "Bump level, or leave empty to use the default.",
        "type": "enum",
        "position": 0,
        "choices": [
          {
            "value": "major",
            "label": "major"
          },
          {
            "value": "minor",
            "label": "minor"
          },
          {
            "value": "patch",
            "label": "patch"
          },
          {
            "value": "release",
            "label": "release"
          },
          {
            "value": "rc",
            "label": "rc"
          },
          {
            "value": "beta",
            "label": "beta"
          },
          {
            "value": "alpha",
            "label": "alpha"
          }
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "manifest_path",
        "label": "Cargo.toml",
        "type": "path",
        "option": [
          "--manifest-path"
        ],
        "path": {
          "kind": "file",
          "role": "input"
        },
        "sources": [
          "help"
        ]
      },
      {
        "id": "package",
        "label": "Package",
        "type": "string",
        "option": [
          "--package",
          "-p"
        ],
        "multiple": true,
        "sources": [
          "help"
        ]
      },
      {
        "id": "workspace",
        "label": "Whole workspace",
        "type": "boolean",
        "option": [
          "--workspace"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "exclude",
        "label": "Exclude package",
        "type": "string",
        "option": [
          "--exclude"
        ],
        "multiple": true,
        "sources": [
          "help"
        ]
      },
      {
        "id": "unpublished",
        "label": "Only unpublished",
        "type": "boolean",
        "option": [
          "--unpublished"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "execute",
        "label": "Execute for real",
        "description": "Without this, only a dry run is performed.",
        "type": "boolean",
        "option": [
          "--execute",
          "-x"
        ],
        "effect": "exec",
        "sources": [
          "help"
        ]
      },
      {
        "id": "no_confirm",
        "label": "Skip confirmation",
        "type": "boolean",
        "option": [
          "--no-confirm"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "no_publish",
        "label": "Do not publish",
        "type": "boolean",
        "option": [
          "--no-publish"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "no_tag",
        "label": "Do not tag",
        "type": "boolean",
        "option": [
          "--no-tag"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "no_push",
        "label": "Do not push",
        "type": "boolean",
        "option": [
          "--no-push"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "verbose",
        "label": "Verbose",
        "type": "count",
        "option": [
          "--verbose",
          "-v"
        ],
        "sources": [
          "help"
        ]
      }
    ],
    "task": [
      {
        "id": "dry-run",
        "label": "Dry run a release",
        "fields": [
          "level",
          "workspace",
          "package",
          "verbose"
        ],
        "required": [
          "level"
        ]
      },
      {
        "id": "release",
        "label": "Perform the release",
        "fields": [
          "level",
          "workspace",
          "package",
          "execute",
          "no_confirm"
        ],
        "required": [
          "level",
          "execute"
        ],
        "set": {
          "execute": [
            true
          ]
        }
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "level",
          "manifest_path",
          "package",
          "workspace",
          "exclude",
          "unpublished",
          "execute"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "no_confirm",
          "no_publish",
          "no_tag",
          "no_push",
          "verbose"
        ]
      }
    ]
  }
}