Add a CLI reference page to the docs, inspired by sqlite-utils

[simonw]

Thought of this while posting this comment: #1591 (comment)

I added https://sqlite-utils.datasette.io/en/stable/cli-reference.html to sqlite-utils in simonw/sqlite-utils#383 and I really like it - it's a page showing the --help output of every CLI command for that tool.

It's maintained using cog. One of the benefits is that I get a free commit history of changes to --help at https://github.com/simonw/sqlite-utils/commits/main/docs/cli-reference.rst

[simonw]

The implementation can be almost exactly the same as this: https://github.com/simonw/sqlite-utils/blame/74586d3cb26fa3cc3412721985ecdc1864c2a31d/docs/cli-reference.rst#L11-L76

I need to do something extra to ensure the output of datasette --help-settings is shown too.

[simonw]

I went with a simpler pattern that sqlite-utils because Datasette has a lot less commands:

datasette/docs/cli-reference.rst

Lines 9 to 35 in 4b23f01

	.. [[[cog
	from datasette import cli
	from click.testing import CliRunner
	import textwrap
	commands = [
	["--help"],
	["serve", "--help"],
	["serve", "--help-settings"],
	["plugins", "--help"],
	["publish", "--help"],
	["publish", "cloudrun", "--help"],
	["publish", "heroku", "--help"],
	["package", "--help"],
	["inspect", "--help"],
	["install", "--help"],
	["uninstall", "--help"],
	]
	for command in commands:
	title = "datasette " + " ".join(command)
	cog.out(title + "\n")
	cog.out(("=" * len(title)) + "\n\n")
	cog.out("::\n\n")
	result = CliRunner().invoke(cli.cli, command)
	output = result.output.replace("Usage: cli ", "Usage: datasette ")
	cog.out(textwrap.indent(output, ' '))
	cog.out("\n\n")
	.. ]]]

[simonw]

https://docs.datasette.io/en/latest/cli-reference.html