Implement a Quickstart CLI / Scaffolding Generator

[jmvrbanac]

Setting up a new Falcon API takes longer than it probably should. Also, quite a few newer contributors ask questions about how to start up and structure a new Falcon API project. While we have some documentation around this, it would be great if we make this much easier. This would be sort of like sphinx-quickstart only for Falcon.

[kgriffs]

Just a thought, but perhaps we could roll this into a "falcon-cli" that could start a development server, generate a QuickStart project template, and maybe even pull down templates from GitHub repos or something.

[kgriffs]

Just got a request for this feature via the Gitter channel, copying here for the record:

do we have a sample "manage.py" to run one-off CLI commands in falcon, similar to django or flask ?

[phoenix911]

I'm working on something similar. falacon_setup . M planning to add cli later.

[kgriffs]

Based on discussions with other members of the maintainer's team during PyCon I think we have come to a rough consensus that our first iteration on this will simply output a simple scaffolding with inline comments showing where people can plug in their favorite libraries for config, logging, DB, etc.

[kgriffs]

P.S. - We should also provide a basic layout suggestion for a project in the docs that mirrors whatever the CLI tool generates (see also: #1520)

[nZac]

@phoenix911 that is cool, thanks for sharing. I noticed you organized things around Falcon concepts (hooks, controllers, middlewares) instead of app/business concepts (user, account, etc) which then contain hooks/controllers/middlewares.

Just curious if you had thoughts structuring based on app concepts?