Metadata-Version: 2.4
Name: eclypse
Version: 0.9.1
Summary: an Edge-CLoud pYthon Platform for Simulated runtime Environments
Author: Jacopo Massa, Valerio De Caro
Author-email: Jacopo Massa <jacopo.massa@di.unipi.it>, Valerio De Caro <valerio@valeriodecaro.com>
License-File: LICENSE
Requires-Dist: aiofiles>=25.1.0
Requires-Dist: loguru>=0.7.3
Requires-Dist: networkx>=3.6.1
Requires-Dist: pandas>=3.0.6
Maintainer: Jacopo Massa, Valerio De Caro
Maintainer-email: Jacopo Massa <jacopo.massa@di.unipi.it>, Valerio De Caro <valerio@valeriodecaro.com>
Requires-Python: >=3.11, <3.15
Project-URL: Homepage, https://github.com/eclypse-org/eclypse
Project-URL: Repository, https://github.com/eclypse-org/eclypse
Description-Content-Type: text/markdown

<p align="center">
<picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/eclypse-org/eclypse/refs/heads/main/docs/_static/images/dark.png?"><img width=450 alt="eclypse-logo" src="https://raw.githubusercontent.com/eclypse-org/eclypse/refs/heads/main/docs/_static/images/light.png"/>
</picture>
</p>

![PyPI - Version](https://img.shields.io/pypi/v/eclypse)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/eclypse)
[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&)](https://github.com/pre-commit/pre-commit)
[![codecov](https://codecov.io/github/eclypse-org/eclypse/graph/badge.svg?token=cxoy6qx1tF)](https://codecov.io/github/eclypse-org/eclypse)
[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/eclypse-org/eclypse/main.svg)](https://results.pre-commit.ci/latest/github/eclypse-org/eclypse/main)

[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
[![Checked with mypy](http://www.mypy-lang.org/static/mypy_badge.svg)](http://mypy-lang.org/)
[![Import sorted with isort](https://img.shields.io/badge/isort-checked-brightgreen)](https://pycqa.github.io/isort/)
[![Doc style: docformatter](https://img.shields.io/badge/doc%20style-docformatter-blue)](https://github.com/PyCQA/docformatter)

**ECLYPSE** (**E**dge-**CL**oud p**Y**thon **P**latform for **S**imulated runtime **E**nvironments) is the first simulation library entirely written in Python, for experimenting with deployment strategies in varying infrastructure conditions. It provides an interface to simulate deployments of service-based applications onto life-like infrastructures, without and with an actual application implementation to be deployed.

## Installation

To install ECLYPSE and all its dependencies, you can run the following commands:

```bash

pip install eclypse

```

**N.B.** We **strongly** suggest the installation of ECLYPSE in a virtual environment.

## Documentation

The documentation for ECLYPSE can be found [here](https://eclypse.readthedocs.io/en/latest/).

## Publication

ECLYPSE is described and assessed in:

> Jacopo Massa, Valerio De Caro, Stefano Forti, Patrizio Dazzi, Davide Bacciu, Antonio Brogi<br>
> [**ECLYPSE: a Python Framework for Simulation and Emulation of the Cloud-Edge Continuum**](https://doi.org/10.1002/smr.70081), <br>
> Journal of Software: Evolution and Process, 2026.

If you want to cite ECLYPSE in your work, you can use the following BibTeX entry:

```bibtex
@article{massa2026eclypse,
  title     = {{ECLYPSE: A Python Framework for Simulation and Emulation of the Cloud-Edge Continuum}},
  author    = {Massa, Jacopo and De Caro, Valerio and Forti, Stefano and Dazzi, Patrizio and Bacciu, Davide and Brogi, Antonio},
  journal   = {Journal of Software: Evolution and Process},
  volume    = {38},
  number    = {1},
  pages     = {e70081},
  year      = {2026},
  month     = {1},
  doi       = {10.1002/smr.70081},
}
```

## Maintainers

ECLYPSE is maintained by [Jacopo Massa](https://github.com/jacopo-massa) and
[Valerio De Caro](https://github.com/vdecaro).

## Contact Us

If you want to get in touch with us, [drop us an e-mail](mailto:jacopo.massa@di.unipi.it,valerio@valeriodecaro.com?subject=[ECLYPSE]%20Request%20for%20information)!
