Want to take your software engineering career to the next level? Join the mailing list for career tips & advice Click here


docopt - A command line option parser that will make you smile.

Subscribe to updates I use docopt.coffee

Statistics on docopt.coffee

Number of watchers on Github 149
Number of open issues 15
Average time to close an issue over 1 year
Main language CoffeeScript
Average time to merge a PR about 13 hours
Open pull requests 5+
Closed pull requests 1+
Last commit about 7 years ago
Repo Created almost 8 years ago
Repo Last Updated about 2 years ago
Size 252 KB
Organization / Authordocopt
Page Updated
Do you use docopt.coffee? Leave a review!
View open issues (15)
View docopt.coffee activity
View on github
Fresh, new opensource launches 🚀🚀🚀
Software engineers: It's time to get promoted. Starting NOW! Subscribe to my mailing list and I will equip you with tools, tips and actionable advice to grow in your career.
Evaluating docopt.coffee for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)

docopt command line option parser, that will make you smile

docopt is a language for description of command-line interfaces. This is docopt implementation in CoffeeScript, that could be used for server-side CoffeeScript and JavaScript programs.

Isn't it awesome how modern command-line arguments parsers generate help message based on your code?!

Hell no! You know what's awesome? It's when the option parser is generated based on the help message that you write yourself! This way you don't need to write this stupid repeatable parser-code, and instead can write a beautiful help message (the way you want it!), which adds readability to your code.

Now you can write an awesome, readable, clean, DRY code like that:

doc = """
  quick_example.coffee tcp <host> <port> [--timeout=<seconds>]
  quick_example.coffee serial <port> [--baud=9600] [--timeout=<seconds>]
  quick_example.coffee -h | --help | --version

{docopt} = require '../docopt'

console.log docopt(doc, version: '0.1.1rc')

Hell yeah! The option parser is generated based on doc string above, that you pass to the docopt function.

API {docopt} = require 'docopt'

options = docopt(doc, {argv: process.argv[2..], help: true, version: null})

docopt takes 1 required and 3 optional keyword arguments:

  • doc should be a string with help message, written according to rules of docopt language. Here is a quick example of such a string:

    Usage: your_program [options]
    -h --help     Show this.
    -v --verbose  Print more text.
    --quiet       Print less text.
    -o FILE       Specify output file [default: ./test.txt].
  • argv is an optional argument vector; by default it is the argument vector passed to your program (process.argv[2..]). You can supply it with an array of strings (similar to process.argv) e.g. ['--verbose', '-o', 'hai.txt'].

  • help, by default true, specifies whether the parser should automatically print the help message (supplied as doc) in case -h or --help options are encountered. After showing the usage-message, the program will terminate. If you want to handle -h or --help options manually (as all other options), set help=false.

  • version, by default null, is an optional argument that specifies the version of your program. If supplied, then, if the parser encounters --version option, it will print the supplied version and terminate. version could be any printable object, but most likely a string, e.g. '2.1.0rc1'.

Note, when docopt is set to automatically handle -h, --help and --version options, you still need to mention them in the options description (doc) for your users to know about them.

The return value is an Object with properties (giving long options precedence), e.g:

{'--timeout': '10',
 '--baud': '4800',
 '--version': false,
 '--help': false,
 '-h': false,
 serial: true,
 tcp: false,
 '<host>': false,
 '<port>': '/dev/ttyr01'}
docopt.coffee open issues Ask a question     (View All Issues)
  • about 4 years Unexpected repeated arguments when using repeated option.
  • over 5 years Extra newlines break docopt
  • over 5 years Two long options can result in "specified ambiguously" error
  • over 5 years Default value on continuation line
  • almost 6 years Cleaner module.exports
  • about 7 years Docopt breaks lots of JS modules.
  • over 7 years Multiple identical arguments to satisfy a list option
docopt.coffee open pull requests (View All Pulls)
  • Update license attribute
  • "throw" errors instead of trying to "raise" them
  • Fix for multiple argument values
  • Add JS usage section to readme
  • Fix MarkDown syntax in README
docopt.coffee list of languages used
Other projects in CoffeeScript