Skip to main content

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

morbin-1.0.1.tar.gz (4.4 kB view details)

Uploaded Source

Built Distribution

morbin-1.0.1-py3-none-any.whl (5.6 kB view details)

Uploaded Python 3

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

Hashes for morbin-1.0.1.tar.gz
Algorithm Hash digest
SHA256 e84ff43fe8c3c883ac25d6dc1471f3f22a58222e539313645d965cd5fde86b3e
MD5 fa58f7ee83621d01a33f40c07a2b1756
BLAKE2b-256 59d15e2fd489e3f82c6dfc38b64c99d37e6095386dcc923f1234692c097a2b90

See more details on using hashes here.

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

Hashes for morbin-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 0c3a0b1482fb932ffd5e1fa43071bc9d6d27e8ce20060c5b26c8989158eddbe1
MD5 45eb7b286ec6b6f2aab666fddc8a93ad
BLAKE2b-256 8465fc4fab68dcbdfbbbb4bcd1a93744d48e0def4ef9e1b8ddb9dd7954191343

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page