Knack
_ _ | | ___ __ __ _ ___| | __ | |/ / '_ \ / _` |/ __| |/ / | <| | | | (_| | (__| < |_|\_\_| |_|\__,_|\___|_|\_\
A Command-Line Interface framework
Installation is easy via pip:
pip install knackKnack can be installed as a non-privileged user to your home directory by adding “–user” as below:
pip install knack --userUsage
import sys
from collections import OrderedDict
from knack import CLI, ArgumentsContext, CLICommandsLoader
from knack.commands import CommandGroup
def abc_str(length=3):
import string
return string.ascii_lowercase[:length]
class MyCommandsLoader(CLICommandsLoader):
def load_command_table(self, args):
with CommandGroup(self, 'abc', '__main__#{}') as g:
g.command('str', 'abc_str')
return OrderedDict(self.command_table)
def load_arguments(self, command):
with ArgumentsContext(self, 'abc str') as ac:
ac.argument('length', type=int)
super(MyCommandsLoader, self).load_arguments(command)
mycli = CLI(cli_name='mycli', commands_loader_cls=MyCommandsLoader)
exit_code = mycli.invoke(sys.argv[1:])
sys.exit(exit_code)
# $ python mycli.py abc str
# "abc"
# $ python mycli.py abc str --length 5
# "abcde"
# $ python mycli.py abc str --length 100
# "abcdefghijklmnopqrstuvwxyz"More samples and snippets are available at examples.
Documentation
Documentation is available at docs.
Developer Setup
In a virtual environment, install the requirements.txt file.
pip install -r requirements.txt
pip install -e .Run Automation
This project supports running automation using tox.
pip install tox
toxReal-world uses
Azure CLI: The Azure CLI 2.0 is Azure’s new command line experience for managing Azure resources.
VSTS CLI: A command-line interface for Visual Studio Team Services (VSTS) and Team Foundation Server (TFS). With the VSTS CLI, you can manage and work with resources including pull requests, work items, builds, and more.
Service Fabric CLI: A command-line interface for interacting with Azure Service Fabric clusters and their related entities.
Do you use knack in your CLI as well? Open a pull request to include it here. We would love to have it in our list.
Release History
See GitHub Releases.
Contribute Code
This project has adopted the Microsoft Open Source Code of Conduct.
For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
If you would like to become an active contributor to this project, please follow the instructions provided in Contribution License Agreement.
License
Knack is licensed under MIT.
Release files for knack 0.5.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| knack-0.5.4.tar.gz | 40.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| knack-0.5.4-py2.py3-none-any.whl | Python 2, Python 3 | none | any | Details |
Total release size: 91.7 kB
Release files / knack-0.5.4.tar.gz
| Download URL | knack-0.5.4.tar.gz |
|---|---|
| Size | 40.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0bf55d4e37864058fd5501210840436d4cf13c831d94d68152646673ec201640
|
|
BLAKE2b-256 checksum How to use checksums |
763d4a6a243441a9a479b3056ef4215b3bddb0d7827f12b19c72472211256231
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.3
|
Release files / knack-0.5.4-py2.py3-none-any.whl
| Download URL | knack-0.5.4-py2.py3-none-any.whl |
|---|---|
| Size | 51.5 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
67db84d6a949f49d4fd90bce162c83f6fa2e7c4c23053904b8f00a02767ba92d
|
|
BLAKE2b-256 checksum How to use checksums |
bcf8a3c3142d76b40c53272928b0f9e4d0675055c8cc13f67d65558e7d5029aa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.3
|
