Update from original - master

.github/workflows/ci.yml

@@ -0,0 +1,41 @@
+name: CI
+on:
+  pull_request:
+    branches: [master]
+  push:
+    branches: [docopts-go, master]
+
+jobs:
+  ci:
+    name: CI - Go ${{ matrix.go-version }}, ${{ matrix.os }}
+
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        go-version: ["1.14"]
+        os: [ubuntu-latest, macOS-latest]
+
+    steps:
+    - name: Checkout repo
+      uses: actions/checkout@v3
+    - name: Setup Go ${{ matrix.go-version }}
+      uses: actions/setup-go@v3
+      with:
+        go-version: ${{ matrix.go-version }}
+        # cache: true # TODO: cache needs path to go.sum per https://github.com/actions/setup-go#caching-dependency-files-and-build-outputs
+    - name: Install
+      run: |
+        bash --version ; type bash
+        # hack for speedup on mac build with our own bash5
+        ./ci/get_bash5_macos.sh
+        ./ci/get_bats-core.sh
+        go get github.com/docopt/docopt-go
+        # get our official repos too
+        go get github.com/docopt/docopts
+    - name: Test
+      run: make test
+
+      # For debugging, create reverse SSH tunnel (this should be run on failure too)
+      # - name: Debug
+      #   if: runner.os == "macOS"
+      #   run: bash -x ./ci/reverse_ssh_tunnel.sh

.gitignore

@@ -1,3 +1,5 @@
-build
-dist
-docopts.egg-info
+docopts
+*.swp
+env
+build/docopts_*
+build/docopts.go

API_proposal.md

@@ -0,0 +1,68 @@
+# New API proposal for docopts - docopt on shell (bash)
+
+## Update: 2021-09-16
+
+[docopts.sh](docopts.sh) has been publised as a `docopts` companion its documentation live here:
+[docs/README.md](docs/README.md).
+
+It offer some API alternatives and allow to build external wrapper.
+
+## new cli API proposal for 2021
+
+* use verb for action
+* stop using `-h` `<msg>` for reading help
+* keep compatibily with old syntax trough a new verb: `compat`
+* introduce more useful error message
+
+
+### new verb
+
+### replace `-h`
+
+```
+Usage:
+   docopts [options] parse USAGE : [<argv>...]
+   docopts [options] parse [--no-declare] -A <name> USAGE : [<argv>...]
+   docopts [options] parse -G <prefix> USAGE : [<argv>...]
+```
+
+Example:
+
+```
+docopts parse "$USAGE" : <option passed here>
+```
+
+`-h` still available trough `compat`
+
+```
+docopts compat -h "$USAGE" : <option passed here>
+```
+
+### generate usage completion
+
+generate usage completion (as `kubect completion` done by [cobra](https://github.com/spf13/cobra/blob/master/shell_completions.md))
+
+```
+docopts completion "$usage"
+```
+
+### debug mode:
+
+```
+Usage:
+   docopts debug [--explain-parsed] USAGE : [<argv>...]
+   docopts debug [--show-argument-match] USAGE : [<argv>...]
+```
+
+### `docopt.sh` compatibile generator
+
+```
+Usage:
+   docopts generate USAGE
+   docopts generate -f FILENAME
+```
+
+
+## Dropped JSON API proposal
+
+old [API_proposal.md](https://github.com/docopt/docopts/blob/031ceb2f0700ac0e40303d72167b91586a6d60da/API_proposal.md)

Changelog.md

@@ -0,0 +1,4 @@
+# Change history
+
+See deployment.yml
+

LICENSE-MIT

@@ -1,4 +1,4 @@
-Copyright (c) 2012 Vladimir Keleshev, <[email protected]>
+Copyright (c) 2013 Vladimir Keleshev, <[email protected]>
                    Lari Rasku, <[email protected]>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of

Makefile

@@ -0,0 +1,61 @@
+#
+# Makefile for managing docopts build
+#
+# See also: deploy.sh
+
+PREFIX ?= /usr/local
+
+# keep docopts: as first target for development
+
+# govvv define main.Version with the contents of ./VERSION file, if exists
+BUILD_FLAGS=$(shell ./get_ldflags.sh)
+docopts: docopts.go Makefile
+	go build -o $@ -ldflags "${BUILD_FLAGS} ${LDFLAGS}"
+
+# dependancies
+install_builddep:
+	go get github.com/docopt/docopts
+	go get github.com/docopt/docopt-go
+	go get github.com/mitchellh/gox
+	go get github.com/itchio/gothub
+	go get gopkg.in/yaml.v2
+	go get github.com/ahmetb/govvv
+
+all: install_builddep docopts README.md
+	./deploy.sh build current
+
+############################ cross compile, we use gox now inside deploy.sh
+
+## build 32 bits version too
+#docopts-32bits: docopts.go
+#	env GOOS=linux GOARCH=386 go build -o docopts-32bits docopts.go
+#
+## build for OSX
+#docopts-OSX: docopts.go
+#	env GOOS=darwin go build -o docopts-OSX docopts.go
+#
+## build 32 bits version too
+#docopts-arm: docopts.go
+#	env GOOS=linux GOARCH=arm go build -o docopts-arm docopts.go
+
+###########################
+
+# requires write access to $PREFIX
+install: all
+	install -m 755 docopts    $(PREFIX)/bin
+	install -m 755 docopts.sh $(PREFIX)/bin
+
+test: docopts
+	./docopts --version
+	go test -v
+	python3 language_agnostic_tester.py ./testee.sh
+	cd ./tests/ && bats .
+
+# README.md is composed with external source too
+# Markdown hidden markup are used to insert some text form the dependancies
+README.md: examples/legacy_bash/rock_hello_world.sh examples/legacy_bash/rock_hello_world_with_grep.sh docopts build_doc.sh
+	./build_doc.sh README.md > README.tmp
+	mv README.tmp README.md
+
+clean:
+	rm -f docopts-* docopts README.tmp build/*

PROGRESS.md

@@ -0,0 +1,18 @@
+# current work in PROGRRESS
+
+## releasing v0.6.3-rc2
+
+- finish release in docs/release.md
+- OK: tests/get_doctops.bats DRY previous VERSION
+- OK: fix: not ok 21 docopt_get_help_string on macos
+
+## grammar programming
+
+Testing https://github.com/alecthomas/participle
+
+## provide test on old environment
+
+docker?
+32bits
+bash 3
+