command text parser and command processor
Project description
Installation
pip install --upgrade cmdtools-py
install latest commit from GitHub
pip install git+https://github.com/HugeBrain16/cmdtools.git
Examples
more examples here
Basic example
import cmdtools
def ping():
print("pong.")
cmd = cmdtools.Cmd('/ping')
cmd.process_cmd(ping)
Command with arguments
import cmdtools
def give(name, item_name, item_amount):
print(f"You gave {item_amount} {item_name}s to {name}")
# surround argument that contains whitespaces with quotes
# set `convert_args` to `True` to automatically convert numbers argument
# this will raise an exception,
# if the number of arguments provided is less than the number of positional callback parameters.
cmd = cmdtools.Cmd('/give Josh "Golden Apple" 10', convert_args=True)
# check for command instance arguments data type.
# format indicates ['str','str','int'].
# integer or float can also match string format, and character 'c' if the argument only has 1 digit.
# `max_args` set to 3, check the first 3 arguments, the rest will get ignored,
# otherwise if it set to default,
# it will raise an exception if the number of arguments is not equal to the number of formats
if cmd.match_args('ssi', max_args=3):
cmd.process_cmd(give)
else:
print('Correct Usage: /give <name: [str]> <item-name: [str]> <item-amount: [int]>')
Links
PyPI project: https://pypi.org/project/cmdtools-py
Source code: https://github.com/HugeBrain16/cmdtools
Issues tracker: https://github.com/HugeBrain16/cmdtools/issues
Documentation: https://cmdtools-py.readthedocs.io/en/latest
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
cmdtools-py-2.4.9.tar.gz
(9.0 kB
view hashes)
Built Distribution
Close
Hashes for cmdtools_py-2.4.9-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 20324c9647de02f0be1f86f45ab89cae8a0e8dd362a4640b5d6bda2f25c072f3 |
|
MD5 | 3a0bbaf822bf104ab691baa95785bf43 |
|
BLAKE2b-256 | 13d3f9a05ecb5e2f12bb314ac0ec37d9d51840af38aa67ad829969ca82fb37d0 |