<!--
=====================================
generator=datazen
version=3.1.4
hash=9f7925d85eb960826e86546d7e5531ed
=====================================
-->
# userfs ([1.1.4](https://pypi.org/project/userfs/))
[![python](https://img.shields.io/pypi/pyversions/userfs.svg)](https://pypi.org/project/userfs/)
![Build Status](https://github.com/vkottler/userfs/workflows/Python%20Package/badge.svg)
[![codecov](https://codecov.io/gh/vkottler/userfs/branch/master/graphs/badge.svg?branch=master)](https://codecov.io/github/vkottler/userfs)
![PyPI - Status](https://img.shields.io/pypi/status/userfs)
![Dependents (via libraries.io)](https://img.shields.io/librariesio/dependents/pypi/userfs)
*A system-bootstrapping automation and introspection tool.*
## Documentation
### Generated
* By [sphinx-apidoc](https://vkottler.github.io/python/sphinx/userfs)
(What's [`sphinx-apidoc`](https://www.sphinx-doc.org/en/master/man/sphinx-apidoc.html)?)
* By [pydoc](https://vkottler.github.io/python/pydoc/userfs.html)
(What's [`pydoc`](https://docs.python.org/3/library/pydoc.html)?)
## Python Version Support
This package is tested with the following Python minor versions:
* [`python3.10`](https://docs.python.org/3.10/)
* [`python3.11`](https://docs.python.org/3.11/)
* [`python3.12`](https://docs.python.org/3.12/)
## Platform Support
This package is tested on the following platforms:
* `ubuntu-latest`
* `macos-latest`
* `windows-latest`
# Introduction
# Command-line Options
```
$ ./venv3.12/bin/ufs -h
usage: ufs [-h] [--version] [-v] [-q] [--curses] [--no-uvloop] [-C DIR]
{build,custom,fetch,noop} ...
A system-bootstrapping automation and introspection tool.
options:
-h, --help show this help message and exit
--version show program's version number and exit
-v, --verbose set to increase logging verbosity
-q, --quiet set to reduce output
--curses whether or not to use curses.wrapper when starting
--no-uvloop whether or not to disable uvloop as event loop driver
-C DIR, --dir DIR execute from a specific directory
commands:
{build,custom,fetch,noop}
set of available commands
build attempt to build a software project from its sources
custom perform a custom interaction, sourced from external
hooks
fetch attempt to obtain some software from the internet
noop command stub (does nothing)
```
## Sub-command Options
### `build`
```
$ ./venv3.12/bin/ufs build -h
usage: ufs build [-h] [-c CONFIG] [-a] [-n] [-p PATTERN] [-d] [projects ...]
positional arguments:
projects specific projects to build, arguments in the form
'key=value' will be provided as interaction options
options:
-h, --help show this help message and exit
-c CONFIG, --config CONFIG
an optional path to the configuration directory
-a, --all interact with all configured projects
-n, --no-interact don't run package-implemented interactions
-p PATTERN, --pattern PATTERN
a pattern to use to select project specifications
filtered by name
-d, --deploy whether or not to also attempt to deploy or install
the built project assets
```
### `custom`
```
$ ./venv3.12/bin/ufs custom -h
usage: ufs custom [-h] [-c CONFIG] [-a] [-n] [-p PATTERN] [projects ...]
positional arguments:
projects specific projects to build, arguments in the form
'key=value' will be provided as interaction options
options:
-h, --help show this help message and exit
-c CONFIG, --config CONFIG
an optional path to the configuration directory
-a, --all interact with all configured projects
-n, --no-interact don't run package-implemented interactions
-p PATTERN, --pattern PATTERN
a pattern to use to select project specifications
filtered by name
```
### `fetch`
```
$ ./venv3.12/bin/ufs fetch -h
usage: ufs fetch [-h] [-c CONFIG] [-a] [-n] [-p PATTERN] [-u] [projects ...]
positional arguments:
projects specific projects to build, arguments in the form
'key=value' will be provided as interaction options
options:
-h, --help show this help message and exit
-c CONFIG, --config CONFIG
an optional path to the configuration directory
-a, --all interact with all configured projects
-n, --no-interact don't run package-implemented interactions
-p PATTERN, --pattern PATTERN
a pattern to use to select project specifications
filtered by name
-u, --update whether or not to also attempt to update project
sources
```
# Internal Dependency Graph
A coarse view of the internal structure and scale of
`userfs`'s source.
Generated using [pydeps](https://github.com/thebjorn/pydeps) (via
`mk python-deps`).
![userfs's Dependency Graph](im/pydeps.svg)
Raw data
{
"_id": null,
"home_page": "https://github.com/vkottler/userfs",
"name": "userfs",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Vaughn Kottler <vaughnkottler@gmail.com>",
"keywords": null,
"author": "Vaughn Kottler",
"author_email": "Vaughn Kottler <vaughnkottler@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/5d/66/585d46344137f38056c342fc3d896bad9bf29b7668ac92e235b649e4e794/userfs-1.1.4.tar.gz",
"platform": null,
"description": "<!--\n =====================================\n generator=datazen\n version=3.1.4\n hash=9f7925d85eb960826e86546d7e5531ed\n =====================================\n-->\n\n# userfs ([1.1.4](https://pypi.org/project/userfs/))\n\n[![python](https://img.shields.io/pypi/pyversions/userfs.svg)](https://pypi.org/project/userfs/)\n![Build Status](https://github.com/vkottler/userfs/workflows/Python%20Package/badge.svg)\n[![codecov](https://codecov.io/gh/vkottler/userfs/branch/master/graphs/badge.svg?branch=master)](https://codecov.io/github/vkottler/userfs)\n![PyPI - Status](https://img.shields.io/pypi/status/userfs)\n![Dependents (via libraries.io)](https://img.shields.io/librariesio/dependents/pypi/userfs)\n\n*A system-bootstrapping automation and introspection tool.*\n\n## Documentation\n\n### Generated\n\n* By [sphinx-apidoc](https://vkottler.github.io/python/sphinx/userfs)\n(What's [`sphinx-apidoc`](https://www.sphinx-doc.org/en/master/man/sphinx-apidoc.html)?)\n* By [pydoc](https://vkottler.github.io/python/pydoc/userfs.html)\n(What's [`pydoc`](https://docs.python.org/3/library/pydoc.html)?)\n\n## Python Version Support\n\nThis package is tested with the following Python minor versions:\n\n* [`python3.10`](https://docs.python.org/3.10/)\n* [`python3.11`](https://docs.python.org/3.11/)\n* [`python3.12`](https://docs.python.org/3.12/)\n\n## Platform Support\n\nThis package is tested on the following platforms:\n\n* `ubuntu-latest`\n* `macos-latest`\n* `windows-latest`\n\n# Introduction\n\n# Command-line Options\n\n```\n$ ./venv3.12/bin/ufs -h\n\nusage: ufs [-h] [--version] [-v] [-q] [--curses] [--no-uvloop] [-C DIR]\n {build,custom,fetch,noop} ...\n\nA system-bootstrapping automation and introspection tool.\n\noptions:\n -h, --help show this help message and exit\n --version show program's version number and exit\n -v, --verbose set to increase logging verbosity\n -q, --quiet set to reduce output\n --curses whether or not to use curses.wrapper when starting\n --no-uvloop whether or not to disable uvloop as event loop driver\n -C DIR, --dir DIR execute from a specific directory\n\ncommands:\n {build,custom,fetch,noop}\n set of available commands\n build attempt to build a software project from its sources\n custom perform a custom interaction, sourced from external\n hooks\n fetch attempt to obtain some software from the internet\n noop command stub (does nothing)\n\n```\n\n## Sub-command Options\n\n### `build`\n\n```\n$ ./venv3.12/bin/ufs build -h\n\nusage: ufs build [-h] [-c CONFIG] [-a] [-n] [-p PATTERN] [-d] [projects ...]\n\npositional arguments:\n projects specific projects to build, arguments in the form\n 'key=value' will be provided as interaction options\n\noptions:\n -h, --help show this help message and exit\n -c CONFIG, --config CONFIG\n an optional path to the configuration directory\n -a, --all interact with all configured projects\n -n, --no-interact don't run package-implemented interactions\n -p PATTERN, --pattern PATTERN\n a pattern to use to select project specifications\n filtered by name\n -d, --deploy whether or not to also attempt to deploy or install\n the built project assets\n\n```\n\n### `custom`\n\n```\n$ ./venv3.12/bin/ufs custom -h\n\nusage: ufs custom [-h] [-c CONFIG] [-a] [-n] [-p PATTERN] [projects ...]\n\npositional arguments:\n projects specific projects to build, arguments in the form\n 'key=value' will be provided as interaction options\n\noptions:\n -h, --help show this help message and exit\n -c CONFIG, --config CONFIG\n an optional path to the configuration directory\n -a, --all interact with all configured projects\n -n, --no-interact don't run package-implemented interactions\n -p PATTERN, --pattern PATTERN\n a pattern to use to select project specifications\n filtered by name\n\n```\n\n### `fetch`\n\n```\n$ ./venv3.12/bin/ufs fetch -h\n\nusage: ufs fetch [-h] [-c CONFIG] [-a] [-n] [-p PATTERN] [-u] [projects ...]\n\npositional arguments:\n projects specific projects to build, arguments in the form\n 'key=value' will be provided as interaction options\n\noptions:\n -h, --help show this help message and exit\n -c CONFIG, --config CONFIG\n an optional path to the configuration directory\n -a, --all interact with all configured projects\n -n, --no-interact don't run package-implemented interactions\n -p PATTERN, --pattern PATTERN\n a pattern to use to select project specifications\n filtered by name\n -u, --update whether or not to also attempt to update project\n sources\n\n```\n\n# Internal Dependency Graph\n\nA coarse view of the internal structure and scale of\n`userfs`'s source.\nGenerated using [pydeps](https://github.com/thebjorn/pydeps) (via\n`mk python-deps`).\n\n![userfs's Dependency Graph](im/pydeps.svg)\n",
"bugtrack_url": null,
"license": null,
"summary": "A system-bootstrapping automation and introspection tool.",
"version": "1.1.4",
"project_urls": {
"Homepage": "https://github.com/vkottler/userfs"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "725bbbf4e3ebe55849ac8a1c71aa81353fc25465709f0d62518b8dcce42a0476",
"md5": "4320d19da8bd0cca3373dd9b17ded46e",
"sha256": "5a51fdefbb8cbea81b42754aff7c5e8f45423834fcf41f763ba0c3bce3651af1"
},
"downloads": -1,
"filename": "userfs-1.1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4320d19da8bd0cca3373dd9b17ded46e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 19983,
"upload_time": "2024-04-29T04:45:09",
"upload_time_iso_8601": "2024-04-29T04:45:09.875024Z",
"url": "https://files.pythonhosted.org/packages/72/5b/bbf4e3ebe55849ac8a1c71aa81353fc25465709f0d62518b8dcce42a0476/userfs-1.1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5d66585d46344137f38056c342fc3d896bad9bf29b7668ac92e235b649e4e794",
"md5": "4eaf6729b90808802bfd7058b3c97714",
"sha256": "e215a2839e549fe60b8a8b4a51192820df421e190087aa1c34123e9f537f7731"
},
"downloads": -1,
"filename": "userfs-1.1.4.tar.gz",
"has_sig": false,
"md5_digest": "4eaf6729b90808802bfd7058b3c97714",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 15342,
"upload_time": "2024-04-29T04:45:11",
"upload_time_iso_8601": "2024-04-29T04:45:11.879474Z",
"url": "https://files.pythonhosted.org/packages/5d/66/585d46344137f38056c342fc3d896bad9bf29b7668ac92e235b649e4e794/userfs-1.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-29 04:45:11",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "vkottler",
"github_project": "userfs",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "userfs"
}