jonasbn/cheatset
Docker encapsulation of the cheatset command for generating Docsets for the Dash.app
561
cheatset
(GitHub) is a Ruby application for generating documentation sets (Docsets) for Dash.app, primarily focused on cheat sheets.
This repository is a Docker encapsulation for cheatset
for those of us, who generate Docsets, but do not have a Ruby toolchain available or want the hassle of maintaining one.
Based on this repository you can either:
The Docker image is based on the official Ruby Docker image, using the latest 2.5 version available of this image. See the Dockerfile
for details.
It is based on the larger image, not the slim version since the dependencies of cheatset
require compilation of C-based libraries.
The images are build from the GitHub repository master branch.
The recommended use is to use the latest release with a version tag. See Changelog.md
for details. Whereas the tag latest
just reflect the latest build based on the master branch.
The master branch might contain changes not tagged as released yet and can be regarded as unstable or experimental. Changes such as corrections to documentation etc. will not be tagged until separately as a general rule, unless the changes are significant, but the aim is to keep the documentation relevant and up to date.
The prebuilt cheatset
Docker image is available on DockerHub, or you can build it yourself based on this repository, see the section below on building.
$ docker pull jonasbn/cheatset:0.16.0
$ docker run --rm --volume $PWD:/tmp jonasbn/cheatset:0.16.0
And if you are want the latest build:
$ docker pull jonasbn/cheatset:latest
$ docker run --rm --volume $PWD:/tmp jonasbn/cheatset:latest
As mentioned latest
can be considered unstable or experimental. Development is kept in branches, but new experimental features might make into master for wider evaluation.
With a single argument:
$ docker run --rm --volume "$PWD":/tmp -it --name cheatset jonasbn/cheatset help
Commands:
cheatset generate FILE # Generates cheat sheet out of a file
cheatset help [COMMAND] # Describe available commands or one specific command
With two arguments:
$ docker run --rm -it --name cheatset jonasbn/cheatset help generate
Usage:
cheatset generate FILE
Generates cheat sheet out of a file
Now lets generate something:
docker run --rm -it --volume $PWD:/tmp --name cheatset jonasbn/cheatset generate sample.rb
And in our directory a Sample.docset
directory appears.
Do note the Sample.docset
was lifted from the cheatset GitHub repository and is under respective copyright under the referenced repository and available under the MIT license.
This can be imported into Dash.app:
+
)+
below the docsetsSample.docset
Remember that upon regenerating you have to repeat the above steps, since changes are not automatically detected and imported, which mean that you can evaluate changes, without changing your other additions, which is also a good thing.
The Docker invocation is a bit tedious, so it is recommended to either create a shell wrapper or a shell alias.
# run cheatset docker image in current directory and cleanup the image afterwards
$ alias cheatset='docker run --rm --volume "$PWD":/tmp -it --name cheatset jonasbn/cheatset'
Try it out:
$ cheatset
Commands:
cheatset generate FILE # Generates cheat sheet out of a file
cheatset help [COMMAND] # Describe available commands or one specific command
$ docker build -t jonasbn/cheatset .
Now that you have build the image, you can skip back to the "Run the image" section, which demonstrates how to use it.
cheatset
uses the Ruby Gem thor
for command line argument parsing.
thor
returns 0
when not able to parse the provided arguments.
There is hope that this might get addressed since 0
normally would indicate error. With the introduction of the warning from: thor
.
Deprecation warning: Thor exit with status 0 on errors. To keep this behavior, you must define `exit_on_failure?` in `Cheatset::CLI`
You can silence deprecations warning by setting the environment variable THOR_SILENCE_DEPRECATION.
See also the related issue on GitHub.
ERROR: "cheatset generate" was called with no arguments
The complete error:
ERROR: "cheatset generate" was called with no arguments
Usage: "cheatset generate FILE"
Deprecation warning: Thor exit with status 0 on errors. To keep this behavior, you must define `exit_on_failure?` in `Cheatset::CLI`
You can silence deprecations warning by setting the environment variable THOR_SILENCE_DEPRECATION.
sample.rb
docker run --rm -it --volume $PWD:/tmp --name cheatset jonasbn/cheatset generate sample.rb
See also the Incompatibilities section.
No such file or directory
Traceback (most recent call last):
10: from /usr/local/bundle/bin/cheatset:23:in `<main>'
9: from /usr/local/bundle/bin/cheatset:23:in `load'
8: from /usr/local/bundle/gems/cheatset-1.4.0/bin/cheatset:6:in `<top (required)>'
7: from /usr/local/bundle/gems/thor-1.0.1/lib/thor/base.rb:485:in `start'
6: from /usr/local/bundle/gems/thor-1.0.1/lib/thor.rb:392:in `dispatch'
5: from /usr/local/bundle/gems/thor-1.0.1/lib/thor/invocation.rb:127:in `invoke_command'
4: from /usr/local/bundle/gems/thor-1.0.1/lib/thor/command.rb:27:in `run'
3: from /usr/local/bundle/gems/cheatset-1.4.0/lib/cheatset/cli.rb:26:in `generate'
2: from /usr/local/bundle/gems/cheatset-1.4.0/lib/cheatset/cli.rb:26:in `new'
1: from /usr/local/bundle/gems/cheatset-1.4.0/lib/cheatset/dsl/context.rb:5:in `initialize'
/usr/local/bundle/gems/cheatset-1.4.0/lib/cheatset/dsl/context.rb:5:in `read': No such file or directory @ rb_sysopen - dzil.rb (Errno::ENOENT)
docker run --rm -it --volume $PWD:/tmp --name cheatset jonasbn/cheatset generate sample.rb
You can possibly adjust the Docker invocation accordingly.
Jun Xiong (@suredream), indirect contributor
Jakub Holý (@holyjak), contributor
Bogdan Popescu (@kapeli), author of cheatset
and Dash.app
docker pull jonasbn/cheatset