Argc Versions Save

A Bash CLI framework, also a Bash-based command runner.

v1.17.0

3 weeks ago

What's Changed

fix: load dotenv before handle @env https://github.com/sigoden/argc/pull/308
feat: add @meta version and @meta author https://github.com/sigoden/argc/pull/309
feat: support assigned options https://github.com/sigoden/argc/pull/310
feat: parameters binding environment variables https://github.com/sigoden/argc/pull/312
feat: support @meta require-tools https://github.com/sigoden/argc/pull/316
feat: improve default subcommand https://github.com/sigoden/argc/pull/317
feat: abandon no-inherit-env meta https://github.com/sigoden/argc/pull/318

Full Changelog: https://github.com/sigoden/argc/compare/v1.16.0...v1.17.0

v1.16.0

1 month ago

What's Changed

feat: add --argc-mangen to generate man pages https://github.com/sigoden/argc/pull/300
fix: compgen should contain help/version flags https://github.com/sigoden/argc/pull/301
fix: incorrect pwd when running symlink argcfile https://github.com/sigoden/argc/pull/304
fix: bash completion for values containing COMP_WORDBREAKS https://github.com/sigoden/argc/pull/305

Full Changelog: https://github.com/sigoden/argc/compare/v1.15.0...v1.16.0

v1.15.0

2 months ago

New Features

`--argc-build`

Build a single standalone bash script without argc dependency.

argc --argc-build <SCRIPT> [OUTPATH]

`--argc-shell-path`

Print current shell path

argc --argc-shell-path

`@env`

Define a environment

# @env EA                 optional
# @env EB!                required
# @env EC=true            default
# @env EDA[dev|prod]      choices
# @env EDB[=dev|prod]     choices + default

default subcommand

use @meta default-subcommand to set the current subcommand as the default.

hooks

Argc supports two hooks:

_argc_before: call before running the command function (after initialized variables) _argc_after: call after running the command function

dotenv

Load a .env file from a custom path, if persent.

# @meta dotenv
# @meta dotenv ~/.env

What's Changed

chore: fix typos by @cclauss in https://github.com/sigoden/argc/pull/280
feat: improve function parsing by @sigoden in https://github.com/sigoden/argc/pull/281
feat: support hooks by @sigoden in https://github.com/sigoden/argc/pull/282
feat: support @meta dotenv by @sigoden in https://github.com/sigoden/argc/pull/284
feat: sync nushell changes to completion scripts by @sigoden in https://github.com/sigoden/argc/pull/286
feat: support @env by @sigoden in https://github.com/sigoden/argc/pull/287
refactor: render multiline help by @sigoden in https://github.com/sigoden/argc/pull/289
feat: support argc build by @sigoden in https://github.com/sigoden/argc/pull/295
feat: support default subcommand by @sigoden in https://github.com/sigoden/argc/pull/296
feat: change generated variables for prefixed options by @sigoden in https://github.com/sigoden/argc/pull/297
refactor: improve failed parsing by @sigoden in https://github.com/sigoden/argc/pull/298
feat: support --argc-shell-path by @sigoden in https://github.com/sigoden/argc/pull/299

New Contributors

@cclauss made their first contribution in https://github.com/sigoden/argc/pull/280

Full Changelog: https://github.com/sigoden/argc/compare/v1.14.0...v1.15.0

v1.14.0

5 months ago

What's Changed

feat: replace argc__last_flag_option with argc__option https://github.com/sigoden/argc/pull/279

Full Changelog: https://github.com/sigoden/argc/compare/v1.13.0...v1.14.0

v1.13.0

5 months ago

What's Changed

refactor: optimize the search for bash.exe in windows https://github.com/sigoden/argc/pull/275
feat: support tcsh https://github.com/sigoden/argc/pull/276
refactor: argc help text https://github.com/sigoden/argc/pull/277
refactor: improve tests and examples https://github.com/sigoden/argc/pull/278

Full Changelog: https://github.com/sigoden/argc/compare/v1.12.1...v1.13.0

v1.12.1

5 months ago

What's Changed

fix: shell completion scripts by @sigoden in https://github.com/sigoden/argc/pull/272

Full Changelog: https://github.com/sigoden/argc/compare/v1.12.0...v1.12.1

v1.12.0

5 months ago

What's Changed

refactor: help rendering of multi-occurs/multi-values options https://github.com/sigoden/argc/pull/256
fix: completion problem on bash/zsh https://github.com/sigoden/argc/pull/258
feat: support symbol parameter https://github.com/sigoden/argc/pull/260
feat: support option starts with + https://github.com/sigoden/argc/pull/261
feat: support allow-empty option https://github.com/sigoden/argc/pull/262
feat: auto-search completion script in ARGC_COMPLETIONS_PATH https://github.com/sigoden/argc/pull/264
refactor: compgen path if no argc script is found for the command https://github.com/sigoden/argc/pull/267
feat: value notation modifier https://github.com/sigoden/argc/pull/268

Full Changelog: https://github.com/sigoden/argc/compare/v1.11.0...v1.12.0

v1.11.0

6 months ago

What's Changed

refactor: change @meta syntax by @sigoden in https://github.com/sigoden/argc/pull/252
fix: incorrect ignore one-char subcommand by @sigoden in https://github.com/sigoden/argc/pull/253
feat: distinct multi-occurs and unlimited multi-args by @sigoden in https://github.com/sigoden/argc/pull/255

Full Changelog: https://github.com/sigoden/argc/compare/v1.10.0...v1.11.0

v1.10.0

7 months ago

What's Changed

refactor: prefixed option endsWith -* https://github.com/sigoden/argc/pull/236
fix: compgen prefixed option with nospace https://github.com/sigoden/argc/pull/237
feat: compgen file proto https://github.com/sigoden/argc/pull/238
refactor: nushell completion deprecate let-env https://github.com/sigoden/argc/pull/239
refactor: prefixed option supports multi/non-multi https://github.com/sigoden/argc/pull/240
fix: notations are seperated by only one space https://github.com/sigoden/argc/pull/241
refactor: change value color to default https://github.com/sigoden/argc/pull/242
refactor: compgen ignore commands's 1char aliases https://github.com/sigoden/argc/pull/243
feat: export argc__last_flag_option https://github.com/sigoden/argc/pull/244
feat: support @meta https://github.com/sigoden/argc/pull/245
feat: support @meta combine-shorts https://github.com/sigoden/argc/pull/246
feat: support @meta inherit-flag-options https://github.com/sigoden/argc/pull/247
feat: option multi arguments/occurences https://github.com/sigoden/argc/pull/248
fix: compgen incomplete if last arg is subcommand https://github.com/sigoden/argc/pull/249

Full Changelog: https://github.com/sigoden/argc/compare/v1.9.0...v1.10.0

v1.9.0

8 months ago

What's Changed

refactor: param data struct https://github.com/sigoden/argc/pull/218
feat: support profixed option https://github.com/sigoden/argc/pull/219
feat: support flag command https://github.com/sigoden/argc/pull/220
feat: run Argcfile.sh without child process https://github.com/sigoden/argc/pull/222
feat: sanitize command name https://github.com/sigoden/argc/pull/223
feat: option name supports special chars https://github.com/sigoden/argc/pull/224
fix: sanitize command name don't replace _ to - https://github.com/sigoden/argc/pull/225
refactor: use tailing '-' to mark prefixed option https://github.com/sigoden/argc/pull/226
refactor: change match logic of option with multi value https://github.com/sigoden/argc/pull/227
fix: compgen add help to candidates https://github.com/sigoden/argc/pull/228
fix: don't match subcmd if prev arg have not match any subcmd https://github.com/sigoden/argc/pull/229
feat: compgen export argc__cmd_fn https://github.com/sigoden/argc/pull/230
refactor: export json https://github.com/sigoden/argc/pull/231
fix: dashes parsing https://github.com/sigoden/argc/pull/233
refactor: rename argc__index to argc__cmd_arg_index https://github.com/sigoden/argc/pull/234
refactor: rename ARGC_FILTER to ARGC_CWORD https://github.com/sigoden/argc/pull/235

Full Changelog: https://github.com/sigoden/argc/compare/v1.8.0...v1.9.0