{"author":"cmd2 Contributors","author_email":null,"bugtrack_url":null,"classifiers":["Development Status :: 5 - Production/Stable","Environment :: Console","Intended Audience :: Developers","Intended Audience :: System Administrators","License :: OSI Approved :: MIT License","Operating System :: OS Independent","Programming Language :: Python :: 3 :: Only","Programming Language :: Python :: 3.10","Programming Language :: Python :: 3.11","Programming Language :: Python :: 3.12","Programming Language :: Python :: 3.13","Programming Language :: Python :: 3.8","Programming Language :: Python :: 3.9","Topic :: Software Development :: Libraries :: Python Modules"],"description":"

cmd2 : immersive interactive command line applications

\n\n[![Latest Version](https://img.shields.io/pypi/v/cmd2.svg?style=flat-square&label=latest%20stable%20version)](https://pypi.python.org/pypi/cmd2/)\n[![GitHub Actions](https://github.com/python-cmd2/cmd2/workflows/CI/badge.svg)](https://github.com/python-cmd2/cmd2/actions?query=workflow%3ACI)\n[![codecov](https://codecov.io/gh/python-cmd2/cmd2/branch/master/graph/badge.svg)](https://codecov.io/gh/python-cmd2/cmd2)\n[![Documentation Status](https://readthedocs.org/projects/cmd2/badge/?version=latest)](http://cmd2.readthedocs.io/en/latest/?badge=latest)\n $\"Chat\"$ \n\n

\n Developer's Toolbox •\n Philosophy •\n Installation •\n Documentation •\n Tutorials •\n Hello World •\n Projects using cmd2 •\n

\n\n[![Screenshot](https://raw.githubusercontent.com/python-cmd2/cmd2/master/cmd2.png)](https://youtu.be/DDU_JH6cFsA)\n\ncmd2 is a tool for building interactive command line applications in Python. Its goal is to make it\nquick and easy for developers to build feature-rich and user-friendly interactive command line\napplications. It provides a simple API which is an extension of Python's built-in\n[cmd](https://docs.python.org/3/library/cmd.html) module. cmd2 provides a wealth of features on top\nof cmd to make your life easier and eliminates much of the boilerplate code which would be necessary\nwhen using cmd.\n\n## The developers toolbox\n\n![system schema](https://raw.githubusercontent.com/python-cmd2/cmd2/master/.github/images/graph.drawio.png)\n\nWhen creating solutions developers have no shortage of tools to create rich and smart user interfaces.\nSystem administrators have long been duct taping together brittle workflows based on a menagerie of simple command line tools created by strangers on github and the guy down the hall.\nUnfortunately, when CLIs become significantly complex the ease of command discoverability tends to fade quickly.\nOn the other hand, Web and traditional desktop GUIs are first in class when it comes to easily discovering functionality.\nThe price we pay for beautifully colored displays is complexity required to aggregate disperate applications into larger systems.\n`cmd2` fills the niche between high [ease of command discovery](https://clig.dev/#ease-of-discovery) applications and smart workflow automation systems.\n\nThe `cmd2` framework provides a great mixture of both worlds. Application designers can easily create complex applications and rely on the cmd2 library to offer effortless user facing help and extensive tab completion.\nWhen users become comfortable with functionality, cmd2 turns into a feature rich library enabling a smooth transition to full automation. If designed with enough forethought, a well implemented cmd2 application can serve as a boutique workflow tool. `cmd2` pulls off this flexibility based on two pillars of philosophy:\n\n- Tab Completion\n- Automation Transition\n\n## Philosophy\n\n $\"made$ \n\nDeep extensive tab completion and help text generation based on the argparse library create the first pillar of 'ease of command discovery'. The following is a list of features in this category.\n\n- Great tab completion of commands, subcommands, file system paths, and shell commands.\n- Custom tab completion for user designed commands via simple function overloading.\n- Tab completion from `persistent_history_file` sources added with very little friction.\n- Automatic tab completion of `argparse` flags and optional arguments.\n- Path completion easily enabled.\n- When all else fails, custom tab completion based on `choices_provider` can fill any gaps.\n\n $\"made$ \n\ncmd2 creates the second pillar of 'ease of transition to automation' through alias/macro creation, command line argument parsing and execution of cmd2 scripting.\n\n- Flexible alias and macro creation for quick abstraction of commands.\n- Text file scripting of your application with `run_script` (`@`) and `_relative_run_script` (`@@`)\n- Powerful and flexible built-in Python scripting of your application using the `run_pyscript` command\n- Transcripts for use with built-in regression can be automatically generated from `history -t` or `run_script -t`\n\n## Installation\n\nOn all operating systems, the latest stable version of `cmd2` can be installed using pip:\n\n```bash\npip install -U cmd2\n```\n\ncmd2 works with Python 3.8+ on Windows, macOS, and Linux. It is pure Python code with few 3rd-party dependencies.\n\nFor information on other installation options, see\n[Installation Instructions](https://cmd2.readthedocs.io/en/latest/overview/installation.html) in the cmd2\ndocumentation.\n\n## Documentation\n\nThe latest documentation for cmd2 can be read online here: https://cmd2.readthedocs.io/en/latest/\n\nIt is available in HTML, PDF, and ePub formats.\n\nThe best way to learn the cmd2 api is to delve into the example applications located in source under examples.\n\n## Tutorials\n\n- PyOhio 2019 presentation:\n - [video](https://www.youtube.com/watch?v=pebeWrTqIIw)\n - [slides](https://github.com/python-cmd2/talks/blob/master/PyOhio_2019/cmd2-PyOhio_2019.pdf)\n - [example code](https://github.com/python-cmd2/talks/tree/master/PyOhio_2019/examples)\n- [Cookiecutter](https://github.com/cookiecutter/cookiecutter) Templates from community\n - Basic cookiecutter template for cmd2 application : https://github.com/jayrod/cookiecutter-python-cmd2\n - Advanced cookiecutter template with external plugin support : https://github.com/jayrod/cookiecutter-python-cmd2-ext-plug\n- [cmd2 example applications](https://github.com/python-cmd2/cmd2/tree/master/examples)\n - Basic cmd2 examples to demonstrate how to use various features\n- [Advanced Examples](https://github.com/jayrod/cmd2-example-apps)\n - More complex examples that demonstrate more featuers about how to put together a complete application\n\n## Hello World\n\n```python\n#!/usr/bin/env python\n\"\"\"A simple cmd2 application.\"\"\"\nimport cmd2\n\n\nclass FirstApp(cmd2.Cmd):\n \"\"\"A simple cmd2 application.\"\"\"\n\n def do_hello_world(self, _: cmd2.Statement):\n self.poutput('Hello World')\n\nif __name__ == '__main__':\n import sys\n c = FirstApp()\n sys.exit(c.cmdloop())\n\n```\n\n## Found a bug?\n\nIf you think you've found a bug, please first read through the open [Issues](https://github.com/python-cmd2/cmd2/issues). If you're confident it's a new bug, go ahead and create a new GitHub issue. Be sure to include as much information as possible so we can reproduce the bug. At a minimum, please state the following:\n\n- `cmd2` version\n- Python version\n- OS name and version\n- What you did to cause the bug to occur\n- Include any traceback or error message associated with the bug\n\n## Projects using cmd2\n\n| Application Name | Description | Organization or Author |\n| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |\n| [CephFS Shell](https://github.com/ceph/ceph) | The Ceph File System, or CephFS, is a POSIX-compliant file system built on top of Ceph’s distributed object store | [ceph](https://ceph.com/) |\n| [garak](https://github.com/NVIDIA/garak) | LLM vulnerability scanner that checks if an LLM can be made to fail in a way we don't want | [NVIDIA](https://github.com/NVIDIA) |\n| [medusa](https://github.com/Ch0pin/medusa) | Binary instrumentation framework that that automates processes for the dynamic analysis of Android and iOS Applications | [Ch0pin](https://github.com/Ch0pin) |\n| [InternalBlue](https://github.com/seemoo-lab/internalblue) | Bluetooth experimentation framework for Broadcom and Cypress chips | [Secure Mobile Networking Lab](https://github.com/seemoo-lab) |\n| [SCCMHunter](https://github.com/garrettfoster13/sccmhunter) | A post-ex tool built to streamline identifying, profiling, and attacking SCCM related assets in an Active Directory domain | [Garret Foster](https://github.com/garrettfoster13) |\n| [Unipacker](https://github.com/unipacker/unipacker) | Automatic and platform-independent unpacker for Windows binaries based on emulation | [unipacker](https://github.com/unipacker) |\n| [Frankenstein](https://github.com/seemoo-lab/frankenstein) | Broadcom and Cypress firmware emulation for fuzzing and further full-stack debugging | [Secure Mobile Networking Lab](https://github.com/seemoo-lab) |\n| [Poseidon](https://github.com/faucetsdn/poseidon) | Leverages software-defined networks (SDNs) to acquire and then feed network traffic to a number of machine learning techniques. | [Faucet SDN](https://github.com/faucetsdn) |\n| [DFTimewolf](https://github.com/log2timeline/dftimewolf) | A framework for orchestrating forensic collection, processing and data export | [log2timeline](https://github.com/log2timeline) |\n| [GAP SDK](https://github.com/GreenWaves-Technologies/gap_sdk) | SDK for Greenwaves Technologies' GAP8 IoT Application Processor | [GreenWaves Technologies](https://github.com/GreenWaves-Technologies) |\n| [REW Sploit](https://github.com/REW-sploit/REW-sploit) | Emulate and Dissect Metasploit Framework (MSF) and other attacks | [REW-sploit](https://github.com/REW-sploit) |\n| [tomcatmanager](https://github.com/tomcatmanager/tomcatmanager) | A command line tool and python library for managing a tomcat server | [tomcatmanager](https://github.com/tomcatmanager) |\n| [Falcon Toolkit](https://github.com/CrowdStrike/Falcon-Toolkit) | Unleash the power of the CrowdStrike Falcon Platform at the CLI | [CrowdStrike](https://github.com/CrowdStrike) |\n| [EXPLIoT](https://gitlab.com/expliot_framework/expliot) | Internet of Things Security Testing and Exploitation framework | [expliot_framework](https://gitlab.com/expliot_framework/) |\n\nPossibly defunct but still good examples\n\n| Application Name | Description | Organization or Author |\n| ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------------- |\n| [Katana](https://github.com/JohnHammond/katana) | Automatic CTF Challenge Solver | [John Hammond](https://github.com/JohnHammond) |\n| [SatanSword](https://github.com/Lucifer1993/SatanSword) (in Chinese) | Comprehensive Penetration Framework for Red Teaming | [Lucifer1993](https://github.com/Lucifer1993) |\n| [Jok3r](http://www.jok3r-framework.com) | Network & Web Pentest Automation Framework | [Koutto](https://github.com/koutto) |\n| [Counterfit](https://github.com/Azure/counterfit) | a CLI that provides a generic automation layer for assessing the security of ML models | [Microsoft Azure](https://github.com/Azure) |\n| [Overlord](https://github.com/qsecure-labs/overlord) | Red Teaming Infrastructure Automation | [QSecure Labs](https://github.com/qsecure-labs) |\n| [Automated Reconnaissance Pipeline](https://github.com/epi052/recon-pipeline) | An automated target reconnaissance pipeline | [epi052](https://github.com/epi052) |\n| [JSShell](https://github.com/Den1al/JSShell) | An interactive multi-user web JavaScript (JS) shell | [Den1al](https://github.com/Den1al) |\n| [RedShell](https://github.com/Verizon/redshell) | An interactive command prompt for red teaming and pentesting | [Verizon](https://github.com/Verizon) |\n| [FLASHMINGO](https://github.com/mandiant/flashmingo) | Automatic analysis of SWF files based on some heuristics. Extensible via plugins. | [Mandiant](https://github.com/mandiant) |\n| [psiTurk](https://github.com/NYUCCL/psiTurk) | An open platform for science on Amazon Mechanical Turk | [NYU Computation and Cognition Lab](https://github.com/NYUCCL) |\n\nNote: If you have created an application based on `cmd2` that you would like us to mention here, please get in touch.\n","description_content_type":"text/markdown","docs_url":null,"download_url":null,"downloads":{"last_day":-1,"last_month":-1,"last_week":-1},"dynamic":null,"home_page":null,"keywords":"CLI, cmd, command, interactive, prompt, Python","license":"The MIT License (MIT)\n \n Copyright (c) 2008-2024 Catherine Devlin and others\n \n Permission is hereby granted, free of charge, to any person obtaining a copy\n of this software and associated documentation files (the \"Software\"), to deal\n in the Software without restriction, including without limitation the rights\n to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n copies of the Software, and to permit persons to whom the Software is\n furnished to do so, subject to the following conditions:\n \n The above copyright notice and this permission notice shall be included in\n all copies or substantial portions of the Software.\n \n THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n THE SOFTWARE.\n ","license_expression":null,"license_files":null,"maintainer":null,"maintainer_email":null,"name":"cmd2","package_url":"https://pypi.org/project/cmd2/","platform":null,"project_url":"https://pypi.org/project/cmd2/","project_urls":null,"provides_extra":null,"release_url":"https://pypi.org/project/cmd2/2.5.11/","requires_dist":["gnureadline>=8; platform_system == \"Darwin\"","pyperclip>=1.8","pyreadline3>=3.4; platform_system == \"Windows\"","wcwidth>=0.2.10"],"requires_python":">=3.8","summary":"cmd2 - quickly build feature-rich and user-friendly interactive command line applications in Python","version":"2.5.11","yanked":false,"yanked_reason":null}

Dependencies of cmd2 (4).
Dependency	Optional
gnureadline	false
pyperclip	false
pyreadline3	false
wcwidth	false

Package search

cmd2

project_urls

Dependencies

All package metadata

Releases