Metadata-Version: 2.3
Name: pyinfra-lxd-connector
Version: 0.1.3
Summary: The @lxd connector allows you to run commands on LXD containers on a remote machine (via SSH).
License: MIT
Author: Spirkop
Author-email: contact@spirkop.com
Requires-Python: >=3.10,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Information Technology
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
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: Topic :: System :: Systems Administration
Classifier: Topic :: System :: Installation/Setup
Classifier: Topic :: Utilities
Requires-Dist: pyinfra (>=3.7,<4.0)
Project-URL: Repository, https://codeberg.org/spirkop/pyinfra-lxd-connector
Description-Content-Type: text/markdown

# pyinfra-lxd-connector

Add an @lxd connector for pyinfra. It allows to run commands on LXD containers on a remote machine (via SSH).

## Installation

```shell
# With pip.
pip install pyinfra-lxd-connector

# With pipx.
pipx inject pyinfra pyinfra-lxd-connector

# With uv.
uv tool install pyinfra --with pyinfra-lxd-connector
```

## Usage

```
pyinfra @lxd/remotehost:container ...
```

If you need sudo to use lxd commands, you can specify the `lxd_sudo` to `True` in your inventory.

## Options

- `lxd_sudo`: Use sudo to call LXD command. (default to `True`)
- `lxd_sudo_user`: Use an another sudo user to run LXD commands. (default to `None`)


## Support

If you have any feature requests, bug reports or security issues, please log them on our issue tracker.

## License

The pyinfra-lxd-connector code is released under MIT.

