Metadata-Version: 2.4
Name: pyptp
Version: 0.0.32
Summary: Open-source Python SDK for electrical grid calculations and modelling
Author-email: Phase to Phase <pyptp@phasetophase.com>
License: GPL-3.0-or-later
License-File: LICENSE
Keywords: distribution-networks,dso,electrical-engineering,gaia,grid-calculations,low-voltage,medium-voltage,network-modeling,power-systems,vision
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: dataclasses-json<1,>=0.6.7
Requires-Dist: networkx<4,>=3.4.2
Requires-Dist: openpyxl<4,>=3.1.5
Requires-Dist: pandas<3,>=2.2.3
Requires-Dist: pydantic-settings<3,>=2.0
Requires-Dist: requests<3,>=2.31.0
Description-Content-Type: text/markdown

# [PyPtP](https://github.com/phasetophase/pyptp)

Open-source Python SDK for electrical grid calculations and modelling.

PyPtP enables Distribution System Operators (DSOs) and developers to integrate with Phase to Phase's electrical network modeling ecosystem. Access electrical network data in the native formats used by Gaia (LV networks) and Vision (MV networks) software.

> **Alpha status**: PyPtP is currently in alpha. The library provides full coverage of VNF and GNF data models and we aim for production-quality code, but documentation is still limited and the API may change between releases. We make every effort to minimize disruption, but reserve the right to make breaking changes as we refine the library based on real-world usage.
>
> Moving to beta is contingent on API stability. The best way to support the library right now is to share feedback on developer experience, usage patterns, and API design—via [email](mailto:pyptp@phasetophase.com), [GitHub Discussions](https://github.com/phasetophase/pyptp/discussions), or [Issues](https://github.com/phasetophase/pyptp/issues).

## Installation

```bash
pip install pyptp
```

Or with [uv](https://docs.astral.sh/uv/):

```bash
uv add pyptp
```

## Documentation

- **Docs**: [pyptp.com](https://pyptp.com) — guides, API reference, and samples
- **Examples**: [`docs/samples/`](docs/samples/) — runnable code snippets

## Contributing

We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for:

- How to report bugs and request features
- Development setup and coding standards
- Pull request process
- Contributor License Agreement (CLA)

## License

This project is licensed under the GNU General Public License v3.0 or later (GPL-3.0-or-later).

See [LICENSE](LICENSE) for the full license text.

## Support

- **Issues & Features**: [GitHub Issues](https://github.com/phasetophase/pyptp/issues)
- **Questions**: [GitHub Discussions](https://github.com/phasetophase/pyptp/discussions)
- **Email**: pyptp@phasetophase.com

---

**Developed by [Phase to Phase](https://phasetophase.com)**
