Metadata-Version: 2.1
Name: fs-toolkit
Version: 1.0.3
Summary: Classes for filesystem usage utilities
License: BSD
Author: Ilkka Tuohela
Author-email: hile@iki.fi
Requires-Python: >=3.9,<4.0
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: BSD License
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Utilities
Requires-Dist: sys-toolkit (>=2,<3)
Description-Content-Type: text/markdown

![Unit Tests](https://github.com/hile/fs-toolkit/actions/workflows/unittest.yml/badge.svg)
![Style Checks](https://github.com/hile/fs-toolkit/actions/workflows/lint.yml/badge.svg)

# Filesystem information tools

This module contains utilities to query local filesystem information as python objects,
including mount points, disk usage and fstab contents.

This tool does similar things as `psutil` package: it may be better suited to
your use and has many features missing from this module.

## Installing

```bash
pip install fs-toolkit
```

## Basic examples

Some usage examples

Fstab:

```bash
from fs_toolkit.fstab import Fstab
fstab = Fstab()
fstab.get_by_mountpoint('/var/my-secrets').uuid
```

Mounts and df (linked together):

```bash
from fs_toolkit.mounts import Mountpoints
print('\n'.join(f'{mp.usage.used:10} {mp.mountpoint}' for mp in Mountpoints()))
```

