Metadata-Version: 2.4
Name: lid-cli
Version: 0.7
Summary: gio-based volume mounting and unmounting tool.
Author: Christian Heinze
License-Expression: MIT
License-File: LICENSES/MIT.txt
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Dist: msgspec>=0.21
Requires-Dist: rich>=14.3
Requires-Dist: typer>=0.24
Requires-Python: >=3.14
Project-URL: Repository, https://codeberg.org/christianheinze/lid-cli
Description-Content-Type: text/markdown

# `gio`-based volume handling tool `lid`

## (Un)Install

To install, run

```bash
uv tool install lid-cli
```

Then run

```bash
yd --install-completion
```

to install auto-completion in your shell.

In `bash`, the completion code is stored in `~/.bash_completions/lid.sh` and that file is sourced from `~/.bashrc`.
Remove both and call `uv tool uninstall lid-cli` to remove this tool.

## (Un)Mounting

Currently, `lid` allows to (un)mount volumes using `gio`.

To find available volumes, run `lid ls` (add the `--mounted` option to restrict to mounted volumes).

Use `lid mount NAME` to mount a volume wherein name is the name displayed by `lid ls`.

Use `lid umount NAME` to unmount. `lid` will only unmount what it has itself mounted.
This allows to sandwich another action between a `lid mount` and a `lid umount` call to have the volume mounted during the action and retain the initial state afterwards
(if the volume was mounted before calling `lid mount` it is still mounted after `lid umount`).
