Metadata-Version: 2.4
Name: wslx
Version: 0.1.1
Summary: Manage Ubuntu WSL virtual machines from the command line
Keywords: wsl,windows,ubuntu,vm,cloud-init
Author: Optersoft, S.L.
Author-email: Optersoft, S.L. <david@optersoft.com>
License-Expression: MIT OR Apache-2.0
License-File: LICENSE-APACHE
License-File: LICENSE-MIT
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: System :: Systems Administration
Requires-Dist: httpx>=0.27
Requires-Dist: rich>=13.7
Requires-Dist: typer>=0.12
Requires-Python: >=3.11
Project-URL: Homepage, https://academy.optersoft.com/tool/wsl
Project-URL: Documentation, https://academy.optersoft.com/tool/wsl
Project-URL: Repository, https://github.com/optersoft/wsl
Project-URL: Issues, https://github.com/optersoft/wsl/issues
Description-Content-Type: text/markdown

# wslx

Manage Ubuntu **WSL** virtual machines from the command line.

`wslx` imports an Ubuntu rootfs as a WSL distribution, seeds it with cloud-init
(a passwordless-sudo `box` user, the hostname, a few conveniences) and gets you
a shell in it — one command per lifecycle step, no manual `wsl --import`
juggling.

## Documentation

**All instructions and the tutorial live at
<https://academy.optersoft.com/tool/wsl>.**

## Install

```console
uv tool install wslx
```

or run it without installing:

```console
uvx wslx list
```

`pip install wslx` works too. Python 3.11+, Windows (every command needs
`wsl.exe` on `PATH`).

## Development

```console
uv sync --all-groups
uv run pytest
uv run ruff check
```

The package installs and imports on macOS and Linux so it can be developed and
tested there; the Windows-only paths are covered through their pure helpers
(output parsing, cloud-init rendering, path resolution) and the platform guard.

## License

Licensed under either of [MIT](LICENSE-MIT) or [Apache-2.0](LICENSE-APACHE),
at your option. Unless you state otherwise, any contribution you submit for
inclusion is dual-licensed on those same terms.

Copyright © 2026 Optersoft, S.L.
