docopt.rs
argc
docopt.rs | argc | |
---|---|---|
4 | 14 | |
752 | 643 | |
- | - | |
0.0 | 9.3 | |
about 3 years ago | 6 days ago | |
Rust | Rust | |
The Unlicense | Apache License 2.0 |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
docopt.rs
-
Docopt.sh – Command-Line Argument Parser for Bash 3.2, 4, and 5
Consider using clap or possibly structopt instead.
It's a lovely way to internalize the CLI argument cultural norms, decrease confusing and verbose argument parsing, make argument parsing work-free for the developer, and make argument parsing a copy-paste across languages. There's no greater pleasure than iteratively adding options to your program by just adding a line of text
-n, --new-option Do something new
I honestly think making a docopt parser is just very hard, which may limit its future prospects.
[the docopt rust repo.]: https://github.com/docopt/docopt.rs
-
Fedora to disallow CC0-licensed code
Ditto, I guess? :P (But obviously with the position on the Unlicense flipped.)
To address your indictment head-on: you suggesting the 0BSD as a better alternative is really missing my point. The 0BSD is not an alternative for my use case. The Unlicense is one of the very few overt "political" acts that I inject into the software I produce. Its purpose is to make a statement. The 0BSD doesn't do that IMO, so it's not actually an alternative that meets my advocacy goal.
You and Rick Moen seem to have the same apparent blind spot for this. See my conversation with him that started here (which might also clarify some aspects of my own position): https://github.com/docopt/docopt.rs/issues/1#issuecomment-42...
And finally, note that my dual licensing scheme is exactly a response to the "problems pointed out by quite a few people": https://github.com/BurntSushi/byteorder/issues/26
-
Docopt
I like Docopt for quick scripts, used it both in Python and Rust projects. It is quite unflexible though.
The Rust Docopt implementation¹ was deprecated this year, which is probably good because clap v3 (https://github.com/clap-rs/clap) is so awesome. In a project of mine (tealdeer), I noticed that docopt.rs was responsible for the huge majority of CPU instructions when running the binary: https://github.com/dbrgn/tealdeer/issues/106#issuecomment-59... I then switched² to clap and shaved off almost a megabyte from the release binary³. Performance improved as well, time required for rendering a tldr page went down from ~15.9 ms to ~12.4 ms⁴. With the migration, we also managed to reduce a lot of custom validation logic and move this logic into the derive macro attributes.
¹ https://github.com/docopt/docopt.rs
- clap 3.0.0-rc.7
argc
- Argc: Easily create feature-rich CLIs in bash
- Easily create a feature-rich command-line application in Bash.
- Docopt.sh – Command-Line Argument Parser for Bash 3.2, 4, and 5
-
Runme: A shell-script based task runner written in rust
Runme is based on argc, which can flexibly define task parameters and generate informative completions
- Whats the easiest way to configure argument parsing in bash
- GitHub - fumieval/clap4shell: Standalone wrapper of clap for shell scripts
- Argc: A bash cli framework, also a task management & automation tool.
-
A cross-plaform task runner
See docs/task-runner for more details.
- Argc: The easiest way to handle bash command-line options
-
IT Pro Tuesday #194 - AutoHotkey Scripts, Command-Line Tool, PowerShell Tutorial & More
Argc is an easier way to handle sh/bash cli parameters. Allows you to create a command line program by simply describing the options, parameters, and subcommands in comments. Once you set it to work, Argc extracts parameter definitions from comments, parses command line arguments, outputs error text/help info for an abnormal parameter or the parsed parameter variable for a normal one, and finally, calls any subcommand function. A shout out to sigoden for this suggestion.
What are some alternatives?
clap-rs - A full featured, fast Command Line Argument Parser for Rust
argi - Argument parsing for the future 🚀
structopt - Parse command line arguments by defining a struct.
docopts - Shell interpreter for docopt, the command-line interface description language.
easy_flag - Simple command line flag parser for rust.
slap - Painless shell argument parsing and dependency check.
byteorder - Rust library for reading/writing numbers in big-endian and little-endian.
Trash-Generator - A Rust program that generates files containing random characters (AKA trash)
docopt-ng - Humane command line arguments parser. Now with maintenance, typehints, and complete test coverage.
clap4shell - Standalone wrapper of clap for shell scripts
typer - Typer, build great CLIs. Easy to code. Based on Python type hints.
docopt - This project is no longer maintained. Please see https://github.com/jazzband/docopt-ng