Metadata-Version: 2.4
Name: craft-providers
Version: 3.7.1
License-Expression: LGPL-3.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: packaging>=14.1
Requires-Dist: pydantic~=2.4
Requires-Dist: pylxd>=2.3.5
Requires-Dist: pyyaml
Requires-Dist: requests>=2.31
Requires-Dist: requests_unixsocket2>=0.4.0
Dynamic: license-file

# Craft providers

[![Documentation Status][rtd-badge]][rtd-latest]
[![Codecov Status][codecov-badge]][codecov-status]
[![Ruff status][ruff-badge]][ruff-site]

Craft Providers supplies a collection of Python interfaces for instantiating and
executing containerized builds with [LXD](https://ubuntu.com/lxd) or
[Multipass](https://multipass.run). This allows dependent apps to build software
without knowing the specifics of the target environment or system.

## Documentation

The [Craft Providers documentation][rtd-latest] describes the library's key components
and provides guidance on its usage.

## Community and support

You can report any issues or bugs on the project's [GitHub
repository](https://github.com/canonical/craft-providers/issues).

Craft Providers is covered by the [Ubuntu Code of
Conduct](https://ubuntu.com/community/ethos/code-of-conduct).

## Contribute to Craft Providers

Craft Providers is open source and part of the Canonical family. We would love your
help.

If you're interested, start with the [contribution guide](CONTRIBUTING.md).

We welcome any suggestions and help with the docs. The [Canonical Open Documentation
Academy](https://github.com/canonical/open-documentation-academy) is the hub for doc
development, including Craft Providers docs. No prior coding experience is required.

## License and Copyright

Craft Providers is licensed under the [LGPL-3.0 license](LICENSE).

[rtd-badge]: https://readthedocs.com/projects/canonical-craft-providers/badge/?version=latest
[rtd-latest]: https://canonical-craft-providers.readthedocs-hosted.com/en/latest/
[ruff-badge]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json
[ruff-site]: https://github.com/astral-sh/ruff
[codecov-badge]: https://codecov.io/github/canonical/craft-providers/coverage.svg?branch=main
[codecov-status]: https://codecov.io/github/canonical/craft-providers?branch=main
