Integrate cmd2 Into Your Project¶
Once installed, you will want to ensure that your project’s dependencies
include cmd2
. Make sure your setup.py
includes the following:
install_requires=[
'cmd2>=1,<2',
]
The cmd2
project uses Semantic Versioning, which
means that any incompatible API changes will be release with a new major
version number. The public API is documented in the API Reference.
We recommend that you follow the advice given by the Python Packaging User
Guide related to install_requires.
By setting an upper bound on the allowed version, you can ensure that your
project does not inadvertently get installed with an incompatible future
version of cmd2
.
Windows Considerations¶
If you would like to use Completion, and you want
your application to run on Windows, you will need to ensure you install the
pyreadline3
or pyreadline
package. Make sure to include the following
in your setup.py
:
install_requires=[
'cmd2>=1,<2',
":sys_platform=='win32'": [
"pyreadline ; python_version<'3.8'",
"pyreadline3 ; python_version>='3.8'", # pyreadline3 is a drop-in replacement for Python 3.8 and above
],
]