Metadata-Version: 2.4
Name: athena-sanity
Version: 0.1.0b3
Summary: Open Source Sanity Checking framework
Home-page: https://github.com/gpijat/athena
Author: Gregory Pijat
Author-email: pijat.gregory@gmail.com
Project-URL: Bug Tracker, https://github.com/gpijat/athena/issues
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
Classifier: Topic :: Multimedia :: Graphics :: 3D Rendering
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Athena: Sanity Checking Framework

![PythonVersion](https://img.shields.io/pypi/pyversions/athena-sanity)
![PyPi](https://img.shields.io/pypi/v/athena-sanity)
[![License](https://img.shields.io/badge/License-GPL3.0-blue.svg)](https://opensource.org/license/gpl-3-0/)

Athena is a versatile sanity checking framework designed to simplify the process of creating and running validation procedures, known as Sanity-Check. These checks can be executed in any software environments with Python interpreters, especially in DCC (Digital Content Creation) software, or in standalone across all operating systems.

[<img src="https://vumbnail.com/880496852.jpg" width="600" height="300"/>](https://vimeo.com/880496852)


## Getting Started

To quickly get started with Athena, follow these steps:

### Prerequisites

Ensure you have Python 3.8+ installed. Athena has no external dependencies.

### Installing

You can install Athena using pip:
```bash
pip install athena-sanity
```

Or download the latest release [here](https://github.com/gpijat/athena/releases).

### Usage Example

You can load a Blueprint and run all it's processes, or query one single process to run:
When part of a `Blueprint`, a `Process` can have extra configuration to modify it's behavior or interaction with other
processes within the blueprint.
```python
from athena import atCore

register = atCore.AtSession().register
register.load_blueprint_from_python_import_path('athena.examples.blueprint.exampleBlueprint')
blueprint = register.blueprint_by_name('exampleBlueprint')
# processor = blueprint.processor_by_name('exampleProcess')  # To get a single `Processor` from the `Blueprint`.

for processor in blueprint.processors:
    result = processor.check()
    
    for container in result:
        print(container, container.status)
        for feedback in container:
            print('\t' + str(feedback))

```

Alternatively, you can skip the blueprint and just run a process with a default configuration or use your own by passing extra arguments to the `Processor`:
```py
from athena import atCore

# The `Processor` takes full import path to the `Process` class. The same way you'd define it in the `Blueprint`.
processor = atCore.Processor('athena.examples.process.exampleProcess.AthenaExampleProcess')

result = processor.check()
for container in result:
    print(container, container.status)
    for feedback in container:
        print('\t' + str(feedback))

```

You can find examples on how to write a Process or Blueprint [here](https://github.com/gpijat/athena/tree/master/src/athena/examples)

## Running the Tests

Full support for unit test will come later.

## Versioning

Athena follows the principles of [Semantic Versioning (SemVer)](http://semver.org/). Check the [tags on this repository](https://github.com/gpijat/athena/tags) for available versions.

## Authors

* **Gregory Pijat** - *Author* - [GitHub](https://github.com/gpijat)

See the list of [contributors](https://github.com/gpijat/athena/contributors) who participated in this project.

## License

This project is licensed under the GPL-3.0 License - see the [LICENSE](LICENSE) file for details.

## More

For an enhanced experience, check out the available UI on Gumroad. (Available *soon*)
