Metadata-Version: 2.4
Name: pyminima
Version: 1.0.0
Summary: Automação de framework para cloud
Project-URL: Homepage, https://github.com/brailog/minima
Project-URL: Documentation, https://minima-br.readthedocs.io/pt-br/latest/
Project-URL: Repository, https://github.com/brailog/minima
Project-URL: Bug Tracker, https://github.com/brailog/minima/issues
Author-email: bielrammos@gmail.com, grro@cin.ufpe.br
License: Apache-2.0
License-File: LICENSE
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.12
Requires-Dist: ffmpeg-python>=0.2.0
Requires-Dist: openai-whisper>=20240106
Requires-Dist: openai>=1.55.0
Requires-Dist: pandas>=2.2.2
Requires-Dist: playwright-stealth>=1.3.2
Requires-Dist: playwright>=1.50.0
Requires-Dist: pydantic-settings>=2.12.1
Requires-Dist: pydantic>=2.10.1
Requires-Dist: python-dotenv>=1.1.1
Requires-Dist: pyyaml>=6.0.2
Requires-Dist: selenium>=4.22.0
Requires-Dist: webdriver-manager>=4.0.1
Description-Content-Type: text/markdown

## Overview

Minima is built on the philosophy that automation should be as intuitive as manual interaction. By separating human inputs (keyboard and mouse) from the core browser engine, Minima allows developers to build robust scripts that are easy to read, maintain, and scale.

## 📚 Documentation

For complete usage instructions and API references, check out our newly added docs:
- [Introduction & Philosophy](docs/index.md)
- [Getting Started](docs/getting-started.md)
- [API Reference](docs/api-reference.md)
- [Token Economics & Readability Hypothesis](docs/token-economics-hypothesis.md)

## Project Structure

The repository is organized to ensure a strict separation of concerns and responsibility based on the follow diagram:


```text
.
├── engine/             # Selenium Dependencia & Core Logic
│   ├── context.py      # BrowserSession & Decorators
│   └── controller.py   # BrowserController (URL Nav, Element Search)
├── input/              # Input Controller (Human Actions)
│   ├── keyboard.py     # Keyboard Mapping (Shortcuts, Enter, Fn keys)
│   └── mouse.py        # Mouse Actions (Click, Hover, Drag n Drop)
├── ui/                 # Widget Layer
│   └── base.py         # Base Widget & WidgetDecompose classes
├── settings/           # Configuration & Resources
│   ├── settings.py     # Binary PATHs & OS Configs
│   └── exceptions.py   # Custom Minima Exceptions
├── logs/               # Traceability
│   └── logger_utils.py # Logging utilities
└── tests/              # Validation
    ├── code-examples/  # Playground scripts
    └── unit_tests.py   # System verification

```

## 🛠️ Getting Started

### Prerequisites

* **Python 3.10+**

### Installation

Minima uses Poetry to ensure environment stability. To get started, clone the repository and install the dependencies:

```bash
git clone https://github.com/your-username/minima.git
cd minima

```

## ⚖️ License

Distributed under the **MIT License**. See `LICENSE` for more information.
