Metadata-Version: 2.4
Name: alumnium
Version: 0.20.0a4
Summary: Pave the way towards AI-powered test automation.
Author: Sasha Koss, Alex Rodionov, Tatiana Shepeleva
Author-email: Sasha Koss <koss@nocorp.me>, Alex Rodionov <p0deje@gmail.com>, Tatiana Shepeleva <tati.shep@gmail.com>
License-Expression: MIT
Requires-Dist: alumnium-cli==0.20.0a1 ; (platform_machine == 'AMD64' and sys_platform == 'darwin') or (platform_machine == 'ARM64' and sys_platform == 'darwin') or (platform_machine == 'aarch64' and sys_platform == 'darwin') or (platform_machine == 'amd64' and sys_platform == 'darwin') or (platform_machine == 'arm64' and sys_platform == 'darwin') or (platform_machine == 'x86_64' and sys_platform == 'darwin') or (platform_machine == 'AMD64' and sys_platform == 'linux') or (platform_machine == 'ARM64' and sys_platform == 'linux') or (platform_machine == 'aarch64' and sys_platform == 'linux') or (platform_machine == 'amd64' and sys_platform == 'linux') or (platform_machine == 'arm64' and sys_platform == 'linux') or (platform_machine == 'x86_64' and sys_platform == 'linux') or (platform_machine == 'AMD64' and sys_platform == 'win32') or (platform_machine == 'ARM64' and sys_platform == 'win32') or (platform_machine == 'aarch64' and sys_platform == 'win32') or (platform_machine == 'amd64' and sys_platform == 'win32') or (platform_machine == 'arm64' and sys_platform == 'win32') or (platform_machine == 'x86_64' and sys_platform == 'win32')
Requires-Dist: appium-python-client>=5.1.1,<6.0.0
Requires-Dist: playwright>=1.49,<2.0
Requires-Dist: portpicker>=1.6.0
Requires-Dist: pydantic>=2.10.0,<3.0.0
Requires-Dist: requests>=2.33.1
Requires-Dist: retry2>=0.9,<0.10
Requires-Dist: rich>=14.0.0,<15.0.0
Requires-Dist: selenium>=4.0,<5.0
Requires-Python: >=3.10, <4.0
Project-URL: Homepage, https://alumnium.ai
Project-URL: Repository, https://github.com/alumnium-hq/alumnium
Description-Content-Type: text/markdown

<h1>
    <p align="center">
        <img src="https://raw.githubusercontent.com/alumnium-hq/alumnium.github.io/efb2afaf0ced7ec07c241445e7b381914281edaf/src/assets/logo.svg" height="128" alt="Logo" />
        <br />
        Alumnium
    </p>
</h1>
<p align="center">
    Pave the way towards AI-powered test automation.
    <br />
    <a href="#installation">Installation</a>
    ·
    <a href="#quick-start">Quick Start</a>
    ·
    <a href="https://alumnium.ai/docs/">Documentation</a>
</p>

Alumnium is an experimental project that builds upon the existing test automation ecosystem, offering a higher-level abstraction for testing. It simplifies interactions with applications and provides more robust mechanisms for verifying assertions. It works with Appium, Playwright, or Selenium.

## Installation

```bash
pip install alumnium
```

## Quick Start

```python
import os
from alumnium import Alumni
from selenium.webdriver import Chrome

os.environ["OPENAI_API_KEY"] = "..."

driver = Chrome()
driver.get("https://search.brave.com")

al = Alumni(driver)
al.do("type 'selenium' into the search field, then press 'Enter'")
al.check("page title contains selenium")
al.check("search results contain selenium.dev")
assert al.get("atomic number") == 34

al.quit()
```

Check out [documentation][1] and more [examples][2]!

## Contributing

See the [contributing guidelines][4] for information on how to get involved in the project and develop locally.


[1]: https://alumnium.ai/docs/
[2]: https://github.com/alumnium-hq/alumnium/tree/main/packages/python/examples/
[3]: https://alumnium.ai/docs/getting-started/configuration/
[4]: https://github.com/alumnium-hq/alumnium/tree/main/CONTRIBUTING.md
[5]: https://www.lambdatest.com/
