Metadata-Version: 2.1
Name: e3-core
Version: 22.6
Summary: E3 core. Tools and library for building and testing software
Author: AdaCore's IT Team
License: GPLv3
Project-URL: Repository, https://github.com/AdaCore/e3-core
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Build Tools
Description-Content-Type: text/markdown
License-File: COPYING3
Requires-Dist: colorama
Requires-Dist: pyyaml
Requires-Dist: python-dateutil
Requires-Dist: requests
Requires-Dist: requests-cache
Requires-Dist: requests-toolbelt
Requires-Dist: tqdm
Requires-Dist: stevedore >1.20.0
Requires-Dist: setuptools
Requires-Dist: packaging
Requires-Dist: psutil ; sys_platform == "darwin"
Requires-Dist: psutil ; sys_platform == "linux"
Requires-Dist: distro ; sys_platform == "linux"
Requires-Dist: psutil ; sys_platform == "linux2"
Requires-Dist: distro ; sys_platform == "linux2"
Requires-Dist: psutil ; sys_platform == "win32"
Provides-Extra: check
Requires-Dist: mypy ==1.8.0 ; extra == 'check'
Requires-Dist: pytest ; extra == 'check'
Requires-Dist: bandit ; extra == 'check'
Requires-Dist: pip-audit ; extra == 'check'
Requires-Dist: types-colorama ; extra == 'check'
Requires-Dist: types-mock ; extra == 'check'
Requires-Dist: types-psutil ; extra == 'check'
Requires-Dist: types-python-dateutil ; extra == 'check'
Requires-Dist: types-PyYAML ; extra == 'check'
Requires-Dist: types-requests ; extra == 'check'
Requires-Dist: types-setuptools ; extra == 'check'
Provides-Extra: config
Requires-Dist: tomlkit ; extra == 'config'
Requires-Dist: typeguard <3.0.0 ; extra == 'config'
Provides-Extra: test
Requires-Dist: coverage ; extra == 'test'
Requires-Dist: mock ; extra == 'test'
Requires-Dist: requests-mock ; extra == 'test'
Requires-Dist: pytest ; extra == 'test'
Requires-Dist: pytest-html ; extra == 'test'
Requires-Dist: pytest-socket ; extra == 'test'
Requires-Dist: ansi2html ; extra == 'test'
Requires-Dist: httpretty ; extra == 'test'
Requires-Dist: ptyprocess ; (sys_platform != "win32") and extra == 'test'

The `e3` Project
================

[![Build Status](https://github.com/AdaCore/e3-core/workflows/build/badge.svg)](https://github.com/AdaCore/e3-core/actions?query=branch%3Amaster)
[![Checked with mypy](http://www.mypy-lang.org/static/mypy_badge.svg)](http://mypy-lang.org/)
[![Documentation Status](https://readthedocs.org/projects/e3-core/badge/?version=latest)](http://e3-core.readthedocs.io/en/latest/?badge=latest)
[![codecov](https://codecov.io/gh/AdaCore/e3-core/branch/master/graph/badge.svg)](https://codecov.io/gh/AdaCore/e3-core)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/979/badge)](https://bestpractices.coreinfrastructure.org/projects/979)

This present project (`e3`) is a Python framework to ease the development
of portable automated build systems (compilation, dependencies management,
binary code packaging, and automated testing).

The `e3` framework is split across multiple Python packages named `e3-<name>`
and sharing the same namespace: `e3`.

`e3-core` content
=================

`e3-core` package is organized in several packages and modules:

- *anod*: build system handling dependencies management and binary code
  packaging. This includes a driver that can parse `.anod` specification
  files.
- *archive*: support for reading and writing tar and zip archives
- *collection*: generic collections, e.g. an implementation of Direct Acyclic
  Graphs
- *cve*: small interface to NVD API to query CVE impacting a CPE
- *decorator*: Python decorators, e.g. a memoize decorator
- *diff*: functions to compute a diff or apply it
- *electrolyt*: support for parsing build plans
- *env*: global environment handling
- *error*: `e3` exceptions
- *event*: interface for notifying external services
- *fingerprint*: support for creating a synthetic view of set of
  conditions and determining whether those conditions have changed
  or not.
- *fs*: high-level file system operations, using globbing, walk,...
- *hash*: computation of sha1, md5
- *log*: logging helpers
- *main*: main program initialization, command line parsing,...
- *mainloop*: generic loop for running jobs
- *net*: network utilities
  - *net.http*: helper for sending http requests and downloading files
  - *net.smtp*: helper for sending emails through smtp
- *os*: platform independent interface to Operating System functions
  - *os.fs*: low-level file system operations, no logging involved
  - *os.platform*: tools to detect the platform
  - *os.process*: interface to run process, to control the execution time,...
  - *os.timezone*: platform independent interface to get the machine timezone
- *platform*: generic interface for providing platform information
- *platform_db*: knowledge base for computing platform information
- *spdx*: simple interface for generating SPDX files
- *store*: interface to download and store resources in a store
- *sys*: `e3` information, sanity check, ...
- *text*: text formatting and transformation
- *vcs*: high level interface to VCS repositories
- *yaml*: helpers for parsing yaml data

See [e3-core documentation](http://e3-core.readthedocs.io/en/latest/) for
more details.


Install
=======

requires: Python >=3.9

e3-core releases are available on PyPI and can be installed by running:

```bash
pip install e3-core
```

To install from the source package, run:

```bash
python setup.py install
```

All `e3` dependencies will also be installed.

Contributing
============

See [CONTRIBUTING.md](CONTRIBUTING.md).
