darca-executor 0.1.0

Execution module for reuse along projects..

A secure and structured subprocess command executor for Python projects, featuring rich logging, customizable execution parameters, and robust exception handling.

Overview

darca-executor wraps Python’s subprocess with enhanced logging, structured error reporting, and testability. It is designed to work securely in both use_shell=True and use_shell=False modes.

Features

• Shell and non-shell subprocess support

• Built-in timeout, working directory, and environment handling

• Captures stdout/stderr output

• Integrates with custom Darca logging facility

• Raises DarcaExecError with detailed metadata on failure

• 100% test coverage with Pytest

Quick Start

from darca_executor import DarcaExecutor

executor = DarcaExecutor(use_shell=False)
result = executor.run(["echo", "Hello, Darca!"])
print(result.stdout)

Installation

Install dependencies using make and Poetry:

make install

Testing

Run all unit tests and generate a coverage report:

make test

Documentation

Build the documentation with:

make docs

License

This project is licensed under the MIT License.

Badges