reside-porter 0.0.1

Description:

resideporter 0.0.1

porter



Table of Contents

Usage
Test
Installation
License

Usage
"""Usage:
porter --version
porter backup --to=HOST [--exclude=TARGETS] [--include=INCLUDE]
porter restore --from=HOST [--exclude=TARGETS] [--include=INCLUDE]
Options:
--exclude=TARGETS Comma separated string of target names to exclude (default is to include all)
--include=TARGETS Comma separated string of target names to include (default is to include all)
"""
<path> is the path to a directory containing a porter.json file. This file should contain at least one target
and at least one host. See ./config/porter.json for an example. By default all targets in the config file are used,
but this can be overridden by explicitly including or excluding targets by name.
Test and lint

hatch run test
hatch run lint:fmt

To get coverage reported locally in the console, use hatch run cov.
On CI, use hatch run cov-ci to generate an xml report.
Installation
pip install porter

Install from local sources

hatch build
pip install dist/porter-{version}.tar.gz

Publish
Publish to PyPi
Ensure you have built a new version of the package:

hatch clean
hatch build

Then publish to the test server:
hatch publish -r test

You will be prompted to enter your test.pypi.org username and password.
To test the installation, first run Python in a container:
docker run --rm -it --entrypoint bash python

Then:
pip install --index-url https://test.pypi.org/simple reside-porter --extra-index-url https://pypi.org/simple

Now you should be able to run porter from the command line and see the usage instructions.
If it is working, you can publish to the real PyPi:
hatch publish

License
porter is distributed under the terms of the MIT license.