kingkybel-pyprocess 2.0.0__tar.gz

kingkybel_pyprocess-2.0.0/PKG-INFO

@@ -0,0 +1,151 @@
+Metadata-Version: 2.4
+Name: kingkybel-pyprocess
+Version: 2.0.0
+Summary: Comprehensive Python utility library for file system operations and process management
+Author-email: Dieter J Kybelksties <github@kybelksties.com>
+Maintainer-email: Dieter J Kybelksties <github@kybelksties.com>
+License-Expression: GPL-2.0-only
+Project-URL: Homepage, https://github.com/kingkybel/PyProcess
+Project-URL: Documentation, https://github.com/kingkybel/PyProcess#readme
+Project-URL: Repository, https://github.com/kingkybel/PyProcess
+Project-URL: Issues, https://github.com/kingkybel/PyProcess/issues
+Project-URL: Changelog, https://github.com/kingkybel/PyProcess/blob/main/CHANGELOG.md
+Keywords: filesystem,process,utilities,path,subprocess
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Filesystems
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: psutil>=5.0.0
+Requires-Dist: kingkybel-pyflashlogger>=2.2.0
+Requires-Dist: kingkybel-pyfundamentals>=0.1.1
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx; extra == "docs"
+Requires-Dist: sphinx-rtd-theme; extra == "docs"
+Provides-Extra: build
+Requires-Dist: build; extra == "build"
+Requires-Dist: twine; extra == "build"
+
+![PyProcess banner](assets/banners/pyprocess-banner.svg)
+# kingkybel-pyprocess
+
+Comprehensive Python utility library for file system operations and process management.
+
+## Features
+
+- 📂 **File System Operations**: Robust implementations of `mkdir`, `touch`, `remove`, and `symbolic_link` with glob support
+- 🛡️ **Path Protection**: Absolute path validation with automatic protection of critical Linux system directories
+- 🥞 **Directory Stack**: `pushd` and `popd` functionality for clean working directory management
+- 🔍 **Advanced Finding**: Flexible `find` utility with type filtering, name patterns, exclusion, and sorting
+- 📝 **File Utilities**: Easy `read_file` and `write_file` operations with automatic directory creation
+- ⚙️ **Env Parsing**: Simple `.env` file parser for configuration management
+- 🚀 **Process Management**: Run standard and interactive commands with real-time output monitoring and thread-safe capture
+- 🌐 **Network Tools**: Simple `ping` implementation and IP retrieval
+- 🛠️ **Tool Validation**: Check for installed system tools and versions
+- 🪵 **Logger Integration**: Built-in support for `PyFlashLogger` for command and error logging
+- ✅ **Comprehensive Testing**: Robust test suite using Python's `unittest` framework
+
+## Installation
+
+```bash
+pip install kingkybel-pyprocess
+```
+
+Or from source:
+```bash
+git clone https://github.com/kingkybel/PyProcess.git
+cd PyProcess
+pip install -e .
+```
+
+## Quick Start
+
+### File System Operations
+
+```python
+from pyprocess import mkdir, touch, remove, pushdir, popdir
+
+# Create directories and files
+mkdir("path/to/my/project")
+touch("path/to/my/project/config.ini")
+
+# Directory stack management
+pushdir("path/to/my/project")
+# ... do something ...
+popdir()
+
+# Clean up
+remove("path/to/my/project")
+```
+
+### Process Management
+
+```python
+from pyprocess import run_command, run_interactive_command
+
+# Run a simple command
+reval, stdout, stderr = run_command("ls -la", cwd="/tmp")
+
+# Run an interactive command (e.g., top, vim)
+run_interactive_command("top")
+```
+
+### Advanced Finding
+
+```python
+from pyprocess import find, FileSystemObjectType, FindSortField
+
+# Find all python files, sorted by name
+py_files = find(
+    paths=".",
+    file_type_filter=FileSystemObjectType.FILE,
+    name_patterns="*.py",
+    sort_field=FindSortField.BY_NAME
+)
+```
+
+## Releasing to PyPI
+
+1. Bump the package version in `pyprocess/__init__.py` (`__version__`).
+2. Clean old build artifacts:
+   ```bash
+   rm -rf build dist *.egg-info
+   ```
+3. Build distributions:
+   ```bash
+   python -m build
+   ```
+4. Upload to TestPyPI first (recommended):
+   ```bash
+   python -m twine upload --repository testpypi dist/*
+   ```
+5. Upload to PyPI:
+   ```bash
+   python -m twine upload dist/*
+   ```
+
+## License
+
+GPLv2 - See the LICENSE file for details.
+
+## Contributing
+
+Contributions welcome! Please open issues for bugs or feature requests.
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests if applicable
+5. Submit a pull request

kingkybel_pyprocess-2.0.0/README.md

@@ -0,0 +1,111 @@
+![PyProcess banner](assets/banners/pyprocess-banner.svg)
+# kingkybel-pyprocess
+
+Comprehensive Python utility library for file system operations and process management.
+
+## Features
+
+- 📂 **File System Operations**: Robust implementations of `mkdir`, `touch`, `remove`, and `symbolic_link` with glob support
+- 🛡️ **Path Protection**: Absolute path validation with automatic protection of critical Linux system directories
+- 🥞 **Directory Stack**: `pushd` and `popd` functionality for clean working directory management
+- 🔍 **Advanced Finding**: Flexible `find` utility with type filtering, name patterns, exclusion, and sorting
+- 📝 **File Utilities**: Easy `read_file` and `write_file` operations with automatic directory creation
+- ⚙️ **Env Parsing**: Simple `.env` file parser for configuration management
+- 🚀 **Process Management**: Run standard and interactive commands with real-time output monitoring and thread-safe capture
+- 🌐 **Network Tools**: Simple `ping` implementation and IP retrieval
+- 🛠️ **Tool Validation**: Check for installed system tools and versions
+- 🪵 **Logger Integration**: Built-in support for `PyFlashLogger` for command and error logging
+- ✅ **Comprehensive Testing**: Robust test suite using Python's `unittest` framework
+
+## Installation
+
+```bash
+pip install kingkybel-pyprocess
+```
+
+Or from source:
+```bash
+git clone https://github.com/kingkybel/PyProcess.git
+cd PyProcess
+pip install -e .
+```
+
+## Quick Start
+
+### File System Operations
+
+```python
+from pyprocess import mkdir, touch, remove, pushdir, popdir
+
+# Create directories and files
+mkdir("path/to/my/project")
+touch("path/to/my/project/config.ini")
+
+# Directory stack management
+pushdir("path/to/my/project")
+# ... do something ...
+popdir()
+
+# Clean up
+remove("path/to/my/project")
+```
+
+### Process Management
+
+```python
+from pyprocess import run_command, run_interactive_command
+
+# Run a simple command
+reval, stdout, stderr = run_command("ls -la", cwd="/tmp")
+
+# Run an interactive command (e.g., top, vim)
+run_interactive_command("top")
+```
+
+### Advanced Finding
+
+```python
+from pyprocess import find, FileSystemObjectType, FindSortField
+
+# Find all python files, sorted by name
+py_files = find(
+    paths=".",
+    file_type_filter=FileSystemObjectType.FILE,
+    name_patterns="*.py",
+    sort_field=FindSortField.BY_NAME
+)
+```
+
+## Releasing to PyPI
+
+1. Bump the package version in `pyprocess/__init__.py` (`__version__`).
+2. Clean old build artifacts:
+   ```bash
+   rm -rf build dist *.egg-info
+   ```
+3. Build distributions:
+   ```bash
+   python -m build
+   ```
+4. Upload to TestPyPI first (recommended):
+   ```bash
+   python -m twine upload --repository testpypi dist/*
+   ```
+5. Upload to PyPI:
+   ```bash
+   python -m twine upload dist/*
+   ```
+
+## License
+
+GPLv2 - See the LICENSE file for details.
+
+## Contributing
+
+Contributions welcome! Please open issues for bugs or feature requests.
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests if applicable
+5. Submit a pull request

kingkybel_pyprocess-2.0.0/kingkybel_pyprocess.egg-info/PKG-INFO

@@ -0,0 +1,151 @@
+Metadata-Version: 2.4
+Name: kingkybel-pyprocess
+Version: 2.0.0
+Summary: Comprehensive Python utility library for file system operations and process management
+Author-email: Dieter J Kybelksties <github@kybelksties.com>
+Maintainer-email: Dieter J Kybelksties <github@kybelksties.com>
+License-Expression: GPL-2.0-only
+Project-URL: Homepage, https://github.com/kingkybel/PyProcess
+Project-URL: Documentation, https://github.com/kingkybel/PyProcess#readme
+Project-URL: Repository, https://github.com/kingkybel/PyProcess
+Project-URL: Issues, https://github.com/kingkybel/PyProcess/issues
+Project-URL: Changelog, https://github.com/kingkybel/PyProcess/blob/main/CHANGELOG.md
+Keywords: filesystem,process,utilities,path,subprocess
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Filesystems
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: psutil>=5.0.0
+Requires-Dist: kingkybel-pyflashlogger>=2.2.0
+Requires-Dist: kingkybel-pyfundamentals>=0.1.1
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx; extra == "docs"
+Requires-Dist: sphinx-rtd-theme; extra == "docs"
+Provides-Extra: build
+Requires-Dist: build; extra == "build"
+Requires-Dist: twine; extra == "build"
+
+![PyProcess banner](assets/banners/pyprocess-banner.svg)
+# kingkybel-pyprocess
+
+Comprehensive Python utility library for file system operations and process management.
+
+## Features
+
+- 📂 **File System Operations**: Robust implementations of `mkdir`, `touch`, `remove`, and `symbolic_link` with glob support
+- 🛡️ **Path Protection**: Absolute path validation with automatic protection of critical Linux system directories
+- 🥞 **Directory Stack**: `pushd` and `popd` functionality for clean working directory management
+- 🔍 **Advanced Finding**: Flexible `find` utility with type filtering, name patterns, exclusion, and sorting
+- 📝 **File Utilities**: Easy `read_file` and `write_file` operations with automatic directory creation
+- ⚙️ **Env Parsing**: Simple `.env` file parser for configuration management
+- 🚀 **Process Management**: Run standard and interactive commands with real-time output monitoring and thread-safe capture
+- 🌐 **Network Tools**: Simple `ping` implementation and IP retrieval
+- 🛠️ **Tool Validation**: Check for installed system tools and versions
+- 🪵 **Logger Integration**: Built-in support for `PyFlashLogger` for command and error logging
+- ✅ **Comprehensive Testing**: Robust test suite using Python's `unittest` framework
+
+## Installation
+
+```bash
+pip install kingkybel-pyprocess
+```
+
+Or from source:
+```bash
+git clone https://github.com/kingkybel/PyProcess.git
+cd PyProcess
+pip install -e .
+```
+
+## Quick Start
+
+### File System Operations
+
+```python
+from pyprocess import mkdir, touch, remove, pushdir, popdir
+
+# Create directories and files
+mkdir("path/to/my/project")
+touch("path/to/my/project/config.ini")
+
+# Directory stack management
+pushdir("path/to/my/project")
+# ... do something ...
+popdir()
+
+# Clean up
+remove("path/to/my/project")
+```
+
+### Process Management
+
+```python
+from pyprocess import run_command, run_interactive_command
+
+# Run a simple command
+reval, stdout, stderr = run_command("ls -la", cwd="/tmp")
+
+# Run an interactive command (e.g., top, vim)
+run_interactive_command("top")
+```
+
+### Advanced Finding
+
+```python
+from pyprocess import find, FileSystemObjectType, FindSortField
+
+# Find all python files, sorted by name
+py_files = find(
+    paths=".",
+    file_type_filter=FileSystemObjectType.FILE,
+    name_patterns="*.py",
+    sort_field=FindSortField.BY_NAME
+)
+```
+
+## Releasing to PyPI
+
+1. Bump the package version in `pyprocess/__init__.py` (`__version__`).
+2. Clean old build artifacts:
+   ```bash
+   rm -rf build dist *.egg-info
+   ```
+3. Build distributions:
+   ```bash
+   python -m build
+   ```
+4. Upload to TestPyPI first (recommended):
+   ```bash
+   python -m twine upload --repository testpypi dist/*
+   ```
+5. Upload to PyPI:
+   ```bash
+   python -m twine upload dist/*
+   ```
+
+## License
+
+GPLv2 - See the LICENSE file for details.
+
+## Contributing
+
+Contributions welcome! Please open issues for bugs or feature requests.
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests if applicable
+5. Submit a pull request

kingkybel_pyprocess-2.0.0/kingkybel_pyprocess.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+README.md
+pyproject.toml
+setup.py
+kingkybel_pyprocess.egg-info/PKG-INFO
+kingkybel_pyprocess.egg-info/SOURCES.txt
+kingkybel_pyprocess.egg-info/dependency_links.txt
+kingkybel_pyprocess.egg-info/not-zip-safe
+kingkybel_pyprocess.egg-info/requires.txt
+kingkybel_pyprocess.egg-info/top_level.txt
+pyprocess/__init__.py
+pyprocess/file_system_object.py
+pyprocess/file_utils.py
+pyprocess/processes.py
+test/test_file_system_object.py
+test/test_file_utils.py
+test/test_processes.py

kingkybel_pyprocess-2.0.0/kingkybel_pyprocess.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

kingkybel_pyprocess-2.0.0/kingkybel_pyprocess.egg-info/not-zip-safe

@@ -0,0 +1 @@
+

kingkybel_pyprocess-2.0.0/kingkybel_pyprocess.egg-info/requires.txt

@@ -0,0 +1,16 @@
+psutil>=5.0.0
+kingkybel-pyflashlogger>=2.2.0
+kingkybel-pyfundamentals>=0.1.1
+
+[build]
+build
+twine
+
+[dev]
+pytest
+black
+mypy
+
+[docs]
+sphinx
+sphinx-rtd-theme

kingkybel_pyprocess-2.0.0/kingkybel_pyprocess.egg-info/top_level.txt

@@ -0,0 +1,3 @@
+assets
+dist
+pyprocess

kingkybel_pyprocess-2.0.0/pyprocess/__init__.py

@@ -0,0 +1,6 @@
+from .file_utils import *
+from .__init__ import *
+from .file_system_object import *
+from .processes import *
+
+__version__ = "2.0.0"