Metadata-Version: 2.2
Name: pyforged
Version: 0.2.5
Summary: The PyForged EcoSystem (core).
Author-email: DirtyWork Solutions Limited <pyforge-core@open.dirtywork.solutions>
License: # MIT License
        
        ##### Copyright (c) 2025  -  DirtyWork Solutions Limited
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: Homepage, https://open.dirtywork.solutions/pyforged
Project-URL: Documentation, https://github.com/DirtyWork-Solutions/RuneCaller/docs/INDEX.md
Project-URL: Source, https://github.com/DirtyWork-Solutions/RuneCaller
Project-URL: Issues, https://github.com/DirtyWork-Solutions/RuneCaller/tree/main/.github/ISSUE_TEMPLATE
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Topic :: System
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Classifier: Topic :: System :: Installation/Setup
Requires-Python: >=3.13
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: antlr4-python3-runtime~=4.9.3
Requires-Dist: pytest~=8.3.5
Requires-Dist: pytest-metadata~=3.1.1
Requires-Dist: pydantic~=2.10.6
Requires-Dist: cryptography~=44.0.2
Provides-Extra: suite
Requires-Dist: bedrocked~=0.1.4; extra == "suite"
Requires-Dist: runecaller~=0.1.4; extra == "suite"
Requires-Dist: wardkeeper~=0.1.0; extra == "suite"
Provides-Extra: std
Requires-Dist: bedrocked~=0.1.4; extra == "std"
Requires-Dist: runecaller~=0.1.4; extra == "std"
Requires-Dist: wardkeeper~=0.1.0; extra == "std"
Provides-Extra: dev

# ⚒️ PyForged

A modular Python ecosystem, comprised of a suite of separate but interoperable packages designed to accelerate deployment.
### 🔹 Key Features

#### ✅ Modularity & Extensibility
Packages work independently or together.
Extend functionality with plugins, hooks, and dynamic loading.
Flexible configuration options (file-based, DB-backed, in-memory).


## The Ecosystem

The ecosystem is available altogether or 

### Projects under the PyForged umbrella

| Project Name          | Description                                                                                                   | Pain Point(s)                                                                                      | Status                         |
|-----------------------|---------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------|--------------------------------|
| **PyForged** 🔥       | The very core for the ecosystem. All elements can be installed with: <br/><br/> *pip install pyforged[suite]* | N/A                                                                                                | **Alpha** </br> - v*0.2.0*     | 
| **Bedrocked** 🪨      | Foundation library offering essential utilities for configuration, logging, error handling, and more.         | Inconsistent configurations, poor logging standards, lack of reusable utility functions            | **Alpha** </br> - v*0.1.0*     | 
| **RuneCaller** 🀄     | Flexible framework for event management, hooks, and dynamic plugin systems.                                   | Lack of structured event handling, limited extensibility, poor observability of dynamic processes. | **Alpha** </br> - v*0.1.0*     |
| **WardKeeper** 🔑     | Security and access control framework handling authentication, authorization, and policy enforcement.         | Fragmented security implementations, inconsistent access controls, limited integration options.	   | 🔐 *CLOSED ALPHA PRODUCTION* ❌ |
| **EssenceBinder** 🖇️ | Abstraction, interaction, and management of anything and everything.                                          | Ad-hoc data models, poor lifecycle management, fragile interfaces between components.              | 🔐 *CLOSED ALPHA PRODUCTION* ❌ |
| **Concordance** ✈️    | Distributed synchronization and data consistency management across processes and systems.                     | Data drift across services, lack of real-time sync, high operational complexity.                   | 🔐 *CLOSED ALPHA PRODUCTION* ❌ |
| **FlowSculptor** 🔀   | Workflow orchestration and process automation system for defining and managing complex workflows.             | Manual processes, brittle automation, poor visibility into multi-step processes.                   | 🔐 *CLOSED ALPHA PRODUCTION* ❌ |
| **HexCrafter** 🪄     | Automation & Intelligent Actions.  	                                                                          |                                                                                                    | 🔐 *CLOSED ALPHA PRODUCTION* ❌ |
| **WatchTowered** 📊   | Real-time monitoring, performance metrics collection, and analytics aggregation.                              | Fragmented monitoring, reactive issue detection, no unified performance view.	                     | 🔐 *CLOSED ALPHA PRODUCTION* ❌ |
| **VaultKeeper** 🗄️	  | Data storage abstraction layer providing flexible storage management across databases, files, and services.   | Inconsistent data access, limited portability across storage backends, redundant integration code	 | 🔐 *CLOSED ALPHA PRODUCTION* ❌ |
| **CovenantLedger** 📖 | Audit logging, compliance tracking, and regulatory reporting framework for full traceability.                 | Missing audit trails, compliance gaps, difficult regulatory reporting.                             | 🔐 *CLOSED ALPHA PRODUCTION* ❌ |
| **ChimeBringer** 📣   | Centralized messaging and notification delivery system with extensible channels and formats.                  | Notification silos, lack of centralized message management, poor multi-channel support             | 🔐 *CLOSED ALPHA PRODUCTION* ❌ |

. 

--------------------------------------------

## Installation

To install the entire suite, use the following command:

```sh
pip install pyforged[suite]
```

To install individual packages, use:

```sh
pip install pyforged[package_name]
```

Replace package_name with the desired package, e.g., bedrocked, runecaller, etc.

### Installation Mixes

*PyForged* is available with purposefully utile and or interoperable combinations of the ecosystems packages, shown below, that are installed just as demonstrated above after replacing '_suite_' with the name of the mix.


#### Available Installation Mixes

| Package // Mix     | suite | std |   |   |   |          | | 
|--------------------|-------|-----|---|---|---|----------|-|
| **Bedrocked**      | ❎     | ❎   | ❎ | ❎ | ❌ | 
| **RuneCaller**     | ❎     | ❎   |   |   |   |          |
| **WardKeeper**     | ❎     | ❎   |   |   |   |          |
| **EssenceBinder**  | ❎     |     |   |   |   |          |
| **Concordance**    | ❎     |     |   |   |   |          |
| **HexCrafter**     | ❎     |     |   |   |   |          |
| **CovenantLedger** | ❎     |     |   |   |   |          |
.

--------------------------------------------

## Usage



You can find the **_[full docs here](docs/INDEX.md)_**.

--------------------------------------------

## The Project

The package not the ecosystem.

### Contributing
We welcome contributions! Please read our Contributing Guidelines for more details.  

### License
This project is licensed under the MIT License - see the [LICENSE file](LICENSE.md) for details.

### Acknowledgments
Thanks to all contributors and maintainers.
Special thanks to the open-source community
