diff options
| -rw-r--r-- | MANIFEST.in | 6 | ||||
| -rwxr-xr-x | README.md | 79 | ||||
| -rwxr-xr-x | setup.py | 45 |
3 files changed, 72 insertions, 58 deletions
diff --git a/MANIFEST.in b/MANIFEST.in index 4b5aecd6..373f7b7b 100644 --- a/MANIFEST.in +++ b/MANIFEST.in @@ -1,3 +1,3 @@ -include CHANGES.md README.md LICENSE -recursive-include tests *.py *.txt -recursive-include examples *.py *.txt +include LICENSE +include README.md +include CHANGES.md @@ -1,46 +1,57 @@ -cmd2 -==== -[](https://travis-ci.org/python-cmd2/cmd2) -[](https://ci.appveyor.com/project/FedericoCeratto/cmd2) -[](http://cmd2.readthedocs.io/en/latest/?badge=latest) -[](https://pypi.python.org/pypi/cmd2/) +cmd2: a tool for building interactive command line applications +=============================================================== +[](https://pypi.python.org/pypi/cmd2/) +[](https://travis-ci.org/python-cmd2/cmd2) +[](https://ci.appveyor.com/project/FedericoCeratto/cmd2) [](https://codecov.io/gh/python-cmd2/cmd2) -[](https://pypi.python.org/pypi/cmd2/) +[](http://cmd2.readthedocs.io/en/latest/?badge=latest) -cmd2 is a tool for writing interactive command-line applications for Python 2.7 and Python 3.3+. It is based on the -Python Standard Library's [cmd](https://docs.python.org/3/library/cmd.html) module, and can be used any place cmd is used simply by importing cmd2 instead. It is -pure Python code with the only 3rd-party dependencies being on [six](https://pypi.python.org/pypi/six), [pyparsing](http://pyparsing.wikispaces.com), -and [pyperclip](https://github.com/asweigart/pyperclip). +cmd2 is a tool for building interactive command line applications in Python. Its goal is to make it quick and easy for developers to build feature-rich and user-friendly interactive command line applications. It provides a simple API which is an extension of Python's built-in [cmd](https://docs.python.org/3/library/cmd.html) module. cmd2 provides a wealth of features on top of cmd to make your life easier. + +Main Features +------------- +- Searchable command history (`history` command and `<Ctrl>+r`) +- Text file scripting of your application with `load` (`@`) and `_relative_load` (`@@`) +- Python scripting of your application with ``pyscript`` +- Run shell commands with ``!`` +- Pipe command output to shell commands with `|` +- Redirect command output to file with `>`, `>>`; input from file with `<` +- Bare `>`, `>>` with no filename send output to paste buffer (clipboard) +- `py` enters interactive Python console (opt-in `ipy` for IPython console) +- Multi-line, case-insensitive, and abbreviated commands +- Special-character command shortcuts (beyond cmd's `@` and `!`) +- Settable environment parameters +- Parsing commands with flags +- Unicode character support (*Python 3 only*) +- Good tab-completion of commands, file system paths, and shell commands` +- Python 2.7 and 3.3+ support +- Linux, macOS and Windows support +- Trivial to provide built-in help for all commands +- Built-in regression testing framework for your applications (transcript-based testing) -The latest documentation for cmd2 can be read online here: https://cmd2.readthedocs.io/en/latest/ +Installation +------------ +On all operating systems, the latest stable version of `cmd2` can be installed using pip: + +```bash +pip install -U cmd2 +``` -See the [Installation Instructions](https://cmd2.readthedocs.io/en/latest/install.html) in the cmd2 documentation for instructions on installing, upgrading, and -uninstalling cmd2. +cmd2 works with Python 2.7 and Python 3.3+ on Windows, macOS, and Linux. It is pure Python code with the only 3rd-party dependencies being on [six](https://pypi.python.org/pypi/six), [pyparsing](http://pyparsing.wikispaces.com), +and [pyperclip](https://github.com/asweigart/pyperclip). -Bug reports may be submitted directly to the [issue tracker](https://github.com/python-cmd2/cmd2/issues). Pull Requests are welcome, see the -[Contributor's Guide](https://github.com/python-cmd2/cmd2/blob/master/CONTRIBUTING.md) for more information. +For information on other installation options, see [Installation Instructions](https://cmd2.readthedocs.io/en/latest/install.html) in the cmd2 documentation. -Feature Support ---------------- +Documentation +------------- +The latest documentation for cmd2 can be read online here: https://cmd2.readthedocs.io/en/latest/ + +It is available in HTML, PDF, and ePub formats. -cmd2 provides the following features, in addition to those already existing in cmd: -- Searchable command history -- Load commands from file, save to file, edit commands in file -- Multi-line commands -- Case-insensitive commands -- Special-character shortcut commands (beyond cmd's `@` and `!`) -- Settable environment parameters -- Parsing commands with flags -- Redirection to file with `>`, `>>`; input from file with `<` -- Bare `>`, `>>` with no filename send output to paste buffer -- Pipe output to shell commands with `|` -- Simple transcript-based application testing -- Unicode character support (*Python 3 only*) -- Tab completion of file system paths for ``edit``, ``load``, ``pyscript``, ``save``, and ``shell`` commands -- Integrated Python scripting capability via ``pyscript`` and ``py`` commands -- (Optional) Embedded IPython shell integration via optional opt-in ``ipy`` command +Feature Overview +---------------- Instructions for implementing each feature follow. - Searchable command history @@ -6,31 +6,35 @@ Setuptools setup file, used to install or test 'cmd2' from setuptools import setup VERSION = '0.7.4' -DESCRIPTION = "Extra features for standard library's cmd module" - -LONG_DESCRIPTION = """cmd2 is an enhancement to the standard library's cmd module for Python 2.7 -and Python 3.3+. It is pure Python code with dependencies only on the six and pyparsing modules. +DESCRIPTION = "cmd2 - a tool for building interactive command line applications in Python" +LONG_DESCRIPTION = """cmd2 is a tool for building interactive command line applications in Python. Its goal is to make +it quick and easy for developers to build feature-rich and user-friendly interactive command line applications. It +provides a simple API which is an extension of Python's built-in cmd module. cmd2 provides a wealth of features on top +of cmd to make your life easier. The latest documentation for cmd2 can be read online here: https://cmd2.readthedocs.io/ -Drop-in replacement adds several features for command-prompt tools: +Main features: - * Searchable command history (commands: "history", "run") - * Load commands from file, save to file, edit commands in file - * Multi-line commands - * Case-insensitive commands - * Special-character shortcut commands (beyond cmd's "@" and "!") - * Settable environment parameters - * Parsing commands with flags - * > (filename), >> (filename) redirect output to file - * < (filename) gets input from file - * bare >, >>, < redirect to/from paste buffer - * accepts abbreviated commands when unambiguous - * `py` enters interactive Python console - * `pyscript` executes a Python script - * Good tab-completion of commands and file system paths - * test apps against sample session transcript (see examples/example.py) + - Searchable command history (`history` command and `<Ctrl>+r`) + - Text file scripting of your application with `load` (`@`) and `_relative_load` (`@@`) + - Python scripting of your application with ``pyscript`` + - Run shell commands with ``!`` + - Pipe command output to shell commands with `|` + - Redirect command output to file with `>`, `>>`; input from file with `<` + - Bare `>`, `>>` with no filename send output to paste buffer (clipboard) + - `py` enters interactive Python console (opt-in `ipy` for IPython console) + - Multi-line, case-insensitive, and abbreviated commands + - Special-character command shortcuts (beyond cmd's `@` and `!`) + - Settable environment parameters + - Parsing commands with flags + - Unicode character support (*Python 3 only*) + - Good tab-completion of commands, file system paths, and shell commands` + - Python 2.7 and 3.3+ support + - Linux, macOS and Windows support + - Trivial to provide built-in help for all commands + - Built-in regression testing framework for your applications (transcript-based testing) Usable without modification anywhere cmd is used; simply import cmd2.Cmd in place of cmd.Cmd. """ @@ -76,5 +80,4 @@ setup( keywords='command prompt console cmd', install_requires=INSTALL_REQUIRES, tests_require=TESTS_REQUIRE, - docs_require=DOCS_REQUIRE, ) |