GitLocker: The Coding Marketplace

Description:

pyexecutor 1.0.9

PyExecutor - A light-weight module to run shell / commander commands and get output with Python.

Work with both Linux, Windows and MacOS, compatible with executable files like executor, executor.exe and executor.bat.

Requirement
Python >= 3.5

Compatible with Python 3.5 3.6 3.7 3.8

Installation
Install with pip
pip install pyexecutor
QuickStart
Import and run with python
from pyexecutor import Executor

python = Executor('python')

version = python.run('--version')

print(version)

"""
Python 3.8.0
"""

Usage Examples
Run with executor
Get command execution result in string
from pyexecutor import Executor

kubectl = Executor('kubectl')

# Run 'kubectl version --client --short'
result = kubectl.run('version --client --short')

# Set trailer string of executor
kubectl.set_trailer('-o=json')

# Run 'kubectl version --client --short -o=json'
result = kubectl.run('version --client --short')

# Get command output in JSON object (<type 'dict'>), exception will be raised if result string is not JSON serializable.
result = kubectl.run('version --client --short', json_output=True)

Run with commander
from pyexecutor import Commander

commander = Commander()

# Run 'kubectl version --short --client'
result = commander.run('kubectl', 'version --short --client')

# Get command output message.
# {
# "clientVersion": {
# "major": "1",
# "minor": "19",
# "gitVersion": "v1.19.7",
# "gitCommit": "1dd5338295409edcfff11505e7bb246f0d325d15",
# "gitTreeState": "clean",
# "buildDate": "2021-01-13T13:23:52Z",
# "goVersion": "go1.15.5",
# "compiler": "gc",
# "platform": "darwin/amd64"
# }
# }
result.output()

# Get command output in JSON object (<type 'dict'>), exception will be raised if result string is not JSON serializable.
# {'clientVersion': {'major': '1', 'minor': '19', 'gitVersion': 'v1.19.7', 'gitCommit': '1dd5338295409edcfff11505e7bb246f0d325d15', 'gitTreeState': 'clean', 'buildDate': '2021-01-13T13:23:52Z', 'goVersion': 'go1.15.5', 'compiler': 'gc', 'platform': 'darwin/amd64'}}
result.json()

# Get command error message.
# ""
result.error()

# If command exit with zero.
result.ok() == True

# If command exit with non zero.
result.fail() == True

Logging
Loging in executor
import logging
from pyexecutor import Executor

kubectl = Executor('kubectl', logger=logging.getLogger())

Logging in commander
import logging
from pyexecutor import Commander

Commander(logger=logging.getLogger())