summaryrefslogtreecommitdiff
path: root/docs/overview/integrating.rst
diff options
context:
space:
mode:
authorkotfu <kotfu@kotfu.net>2019-07-03 11:23:58 -0600
committerkotfu <kotfu@kotfu.net>2019-07-03 11:23:58 -0600
commit51ea4ba9fbcdfc785a5e9d6bafcac69334e535a8 (patch)
treeb9b6aa7273040f5dd9132e94706c91ac3de601fe /docs/overview/integrating.rst
parent11da5ba65a43c63364e702de726a7bf09a1241b4 (diff)
downloadcmd2-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.rst27
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