Base class for creating modules that are bindings for command line tools.
Project description
morbin
Base class for creating bindings for command line tools.
Installation
Install with:
pip install morbin
Usage
The easiest way to start is to use the bundled template generator.
The only argument it requires is the name of the program you want to create bindings for.
As an example we'll do Pip
.
Running morbin pip
in your terminal will produce a file named pip.py
in your current directory.
It should look like this:
from morbin import Morbin, Output class Pip(Morbin): @property def program(self) -> str: return "pip"
Additional functions should be built on top of the run
function and return its output.
After adding functions for install
and upgrade
the class should look like this:
from morbin import Morbin, Output class Pip(Morbin): @property def program(self) -> str: return "pip" def install(self, package:str, *args:str)->Output: return self.run("install", package, *args) def upgrade(self, package:str)->Output: return self.install(package, "--upgrade") def install_requirements(self)->Output: return self.install("-r", "requirements.txt")
It can be used like:
pip = Pip() output = pip.install_requirements()
The Output
object each function returns is a dataclass
with three fields: return_code
, stdout
, and stderr
.
@dataclass class Output: """Dataclass representing the output of a terminal command. #### Fields: * `return_code: list[int]` * `stdout: str` * `stderr: str`""" return_code: list[int] stdout: str = "" stderr: str = "" def __add__(self, output: Self) -> Self: return Output( self.return_code + output.return_code, self.stdout + output.stdout, self.stderr + output.stderr, )
By default stdout
and stderr
are not captured.
They are sent to wherever they normally would be and the stdout
and stderr
fields of the Output
object will be empty strings.
stdout
and stderr
can be captured by either setting the capture_output
property of a class instance to True
or by using the capturing_output
context manager.
To get the output of install_requirements
:
pip = Pip(capture_output=True) text = pip.install_requirements().stdout
or
pip = Pip() with pip.capturing_output(): text = pip.install_requirements().stdout
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file morbin-1.0.1.tar.gz
.
File metadata
- Download URL: morbin-1.0.1.tar.gz
- Upload date:
- Size: 4.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | e84ff43fe8c3c883ac25d6dc1471f3f22a58222e539313645d965cd5fde86b3e |
|
MD5 | fa58f7ee83621d01a33f40c07a2b1756 |
|
BLAKE2b-256 | 59d15e2fd489e3f82c6dfc38b64c99d37e6095386dcc923f1234692c097a2b90 |
File details
Details for the file morbin-1.0.1-py3-none-any.whl
.
File metadata
- Download URL: morbin-1.0.1-py3-none-any.whl
- Upload date:
- Size: 5.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0c3a0b1482fb932ffd5e1fa43071bc9d6d27e8ce20060c5b26c8989158eddbe1 |
|
MD5 | 45eb7b286ec6b6f2aab666fddc8a93ad |
|
BLAKE2b-256 | 8465fc4fab68dcbdfbbbb4bcd1a93744d48e0def4ef9e1b8ddb9dd7954191343 |