Metadata-Version: 2.4
Name: eptalights
Version: 0.0.1
Summary: Eptalights Code Analysis Python Library is a powerful Python package designed to help hackers, researchers, and developers effortlessly perform code analysis, discover bugs, conduct variant analysis, and leverage advanced AI for deeper program analysis and faster research workflows.
Author-email: Eptalights Research <samuelasirifi1@gmail.com>
License: Eptalights Research
Project-URL: Documentation, https://eptalights.readthedocs.io/en/latest/
Project-URL: Source, https://github.com/eptalights/eptalights-python
Keywords: code-analysis,program-analysis,gimple,soot,zend,java,php,C++,C,eptalights,dataflow,dataflow analysis
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: pydantic==2.12.5
Requires-Dist: SQLAlchemy==2.0.36
Requires-Dist: msgpack==1.1.2
Requires-Dist: Pygments==2.19.2
Requires-Dist: dill==0.4.1
Requires-Dist: requests==2.32.5
Requires-Dist: tabulate==0.9.0
Provides-Extra: dev
Requires-Dist: black; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Provides-Extra: docs
Requires-Dist: Sphinx; extra == "docs"
Requires-Dist: sphinx-book-theme; extra == "docs"
Requires-Dist: sphinx-rtd-theme; extra == "docs"
Dynamic: license-file

# eptalights-python

The **Eptalights Code Analysis Python Library** is a powerful Python package designed to help hackers, researchers, and developers effortlessly perform code analysis, discover bugs, conduct variant analysis, and leverage advanced AI for deeper program analysis and faster research workflows.

Easily access functions, instructions, callsites, variables, control flow graphs (CFG), and other code elements in a simple, Pythonic way. Think of it as Binary Ninja but for source code.

## Documentation

For detailed documentation, please visit [Eptalights Documentation](https://eptalights.readthedocs.io/en/latest/).

You can also check out this [blog post](https://eptalights.com/blog/01-introduction-to-eptalights-technology/) for an introduction to Eptalights's Technology.

## Installation

install the Python package eptalights-python with:
```sh
pip install eptalights
```

Alternatively, you may install from GitHub:

```sh
pip install git+https://github.com/eptalights/eptalights-python.git

# or build from source (git assumed to be available)

git clone https://github.com/eptalights/eptalights-python.git
pip install path/to/eptalights-python
```


## Setting up a Development Environment

The latest code under development is available on GitHub at https://github.com/eptalights/eptalights-python.  
To obtain this version for experimental features or for development:

```bash
git clone https://github.com/eptalights/eptalights-python.git
cd eptalights-python
pip install -e ".[dev]"
```

To run tests and styling checks:

```bash
pytest
flake8 src tests
black --check src tests
```

## Building Documentation

We use the Sphinx framework. The documentation source files are in `docs/`.
The public documentation is accessible at https://eptalights.readthedocs.io/en/latest/.
The doc build is configured by `.readthedocs.yaml`. 

To build the documentation locally (for testing and development),
install the full doc-related dependencies: `pip install -r docs/requirements.txt`,
then run `sphinx-build -b html docs/ docs/build/`.

## Contributing

See `CONTRIBUTING.md` for information about contributing to this project.

## License

See `LICENSE` for details.
