No project description provided
Project description
Welcome to Invokify
Invokify is a lightweight library that allows you to run functions from a string or list of values.
Installing
Invokify is published on PyPI so you can easily install it with either pip
or poetry
.
pip install invokify
poetry add invokify
This package is for python 3.10+
Getting started
Let's create a simple command-line command.
We can start by importing the InvokeEngine
from invokify:
from invokify import InvokeEngine
Now we need to create an engine to hold our commands:
engine = InvokeEngine()
Once we have our engine set up, all we need to do is decorate our target function using the engine's command
method:
@engine.command
def greet(user: str):
print(f"Hello {user}!")
Congrats, that's all you need to do to create a command! Our next goal will be to parse our command by feeding our engine's parse
method a list of values.
cmd, args, callstack = engine.parse(["greet", "Jeff"])
The parse
method will return a tuple containing three values:
- The command if one was found. If no command was found, it will return
None
- Any remaining arguments that were passed. The
parse
method will recursively look for subcommands until it cannot find any, and the remaining arguments will be passed back. - The callstack. A list of the commands and subcommands that were passed in.
Once you have your command, you can execute it easily just by calling it. If your command accept arguments, you can pass args
to it.
cmd(*args)
Output:
Hello Jeff!
To actually run commands on the command line, we can just set up a simple input loop.
Invokify has a simple built-in parser called string_to_args()
that can turn a string into a list of arguments, keeping things like strings and lists intact, and converting numbers automatically.
while True:
user = input()
cleaned = string_to_args(user)
cmd, args, cs = engine.parse(cleaned)
if cmd:
cmd(*args)
else:
print("No command was found.")
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.