Python tools for querying Flexible File Structure
Project description
ffs
Python tools for querying a Flexible File Structure as specified in https://gitlab.com/cardonazlaticlabs/data-policy
The name of the PyPI package is flexfs
to avoid naming collisions with the unrelated ffs
project.
The import and CLI name is ffs
.
Usage
The entry point is a command line tool called ffs
with a number of subcommands:
Usage: ffs [OPTIONS] COMMAND [ARGS]...
Command line tool for working with a Flexible File Structure.
Options:
--version Show the version and exit.
-v, --verbose Increase logging verbosity. [x>=0]
--help Show this message and exit.
Commands:
book Export the FFS metadata into files for mdbook.
export Read the FFS and its metadata into JSON.
problems List problems with the structure of the FFS.
Export
Usage: ffs export [OPTIONS] [ROOT]
Read the FFS and its metadata into JSON.
Options:
-s, --sort Whether to sort keys in outupt.
-s, --indent INTEGER Indentation of output: none by default, 0 for
newlines, a positive number N for N spaces, a
negative number -N for N tabs.
-l, --flatlines Un-nest the entries and print one object per line.
The 'children' attribute is replaced by an array of
string names, and the 'name' attribute now includes
the entry's ancestors (/-separated). '--indent'
option is ignored.
-r, --recursion INTEGER Depth to recurse into entries; negative (default)
for infinite. Directories which are not valid
entries are not explored.
--help Show this message and exit.
Book
Usage: ffs book [OPTIONS] [ROOT] TARGET
Export the FFS metadata into files for mdbook.
Options:
-t, --title TEXT Title for generated book, default
'{FQDN}:{ROOT_REAL_PATH}'.
-r, --recursion INTEGER Depth to recurse into entries; negative (default)
for infinite. Directories which are not valid
entries are not explored.
--help Show this message and exit.
Problems
Usage: ffs problems [OPTIONS] [ROOT]
List problems with the structure of the FFS.
Options:
-c, --check Exit with an error code at the first problem
-s, --skip-problems Do not attempt to traverse below problematic
directories
--help Show this message and exit.
Development
A number of make
recipes are included for convenience of regular development tasks.
In particular, see make {install-dev,update-spec,fmt,lint,test,readme,book}
.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
flexfs-2.0.2.tar.gz
(2.8 MB
view details)
Built Distribution
flexfs-2.0.2-py3-none-any.whl
(19.3 kB
view details)
File details
Details for the file flexfs-2.0.2.tar.gz
.
File metadata
- Download URL: flexfs-2.0.2.tar.gz
- Upload date:
- Size: 2.8 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.1 importlib_metadata/4.4.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.9.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | aea9d98c3954939d3b028b296def29274452d2cc8117edfdb2aa1e042e3c5d77 |
|
MD5 | b554e7c8153b73521e87aa315d7c59ef |
|
BLAKE2b-256 | af8389bedae42911005b7dc4ec21c10bbf465b0df87e664ce34584bd268bc9aa |
File details
Details for the file flexfs-2.0.2-py3-none-any.whl
.
File metadata
- Download URL: flexfs-2.0.2-py3-none-any.whl
- Upload date:
- Size: 19.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.1 importlib_metadata/4.4.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.9.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5ca0cc18beeb50c88be7900d2afbc0f317dc04e6d766af69e46f74191ac51c70 |
|
MD5 | ea873d8c60634b9a92ae201d134dc5b5 |
|
BLAKE2b-256 | eeed34b07495dc87308f82ee0e649cf8fb3cc1c1e4cbba232c785772027ca0e2 |