diff options
author | kotfu <kotfu@kotfu.net> | 2019-07-03 11:23:58 -0600 |
---|---|---|
committer | kotfu <kotfu@kotfu.net> | 2019-07-03 11:23:58 -0600 |
commit | 51ea4ba9fbcdfc785a5e9d6bafcac69334e535a8 (patch) | |
tree | b9b6aa7273040f5dd9132e94706c91ac3de601fe /docs/overview/integrating.rst | |
parent | 11da5ba65a43c63364e702de726a7bf09a1241b4 (diff) | |
download | cmd2-git-51ea4ba9fbcdfc785a5e9d6bafcac69334e535a8.tar.gz |
Revise menu structure
- collapse menu structure in sidebar so not everything is always shown
- updates to Getting Started section
Diffstat (limited to 'docs/overview/integrating.rst')
-rw-r--r-- | docs/overview/integrating.rst | 27 |
1 files changed, 27 insertions, 0 deletions
diff --git a/docs/overview/integrating.rst b/docs/overview/integrating.rst new file mode 100644 index 00000000..b3770559 --- /dev/null +++ b/docs/overview/integrating.rst @@ -0,0 +1,27 @@ +Integrate cmd2 into your project +-------------------------------- + +[TODO - show how to use semantic versions to add the correct version string to setup.py ] + +[TODO - this is probably outdated advice] + +``cmd2`` is contained in a small number of Python files, which can be easily +copied into your project. *The copyright and license notice must be retained*. + +This is an option suitable for advanced Python users. You can simply include +the files within your project's hierarchy. If you want to modify ``cmd2``, this +may be a reasonable option. Though, we encourage you to use stock ``cmd2`` and +either composition or inheritance to achieve the same goal. + +This approach will obviously NOT automatically install the required 3rd-party +dependencies, so you need to make sure the following Python packages are +installed: + + * attrs + * colorama + * pyperclip + * wcwidth + +On Windows, there is an additional dependency: + + * pyreadline
\ No newline at end of file |