# Tar GnuPG
Manage a secure archive containing sensative docs.
You might be thinking, "Hey there's already a
[gpgtar](https://www.gnupg.org/documentation/manuals/gnupg/gpgtar.html)
which seems to do exactly this, why don't I use that?", and you could be right,
depending on your needs. The biggest difference is this package allows you to
add files to an existing archive. (It technically creates a new one and
overwrites your old one, but does it without you needing to worry about that).
That's my biggest use case anyway. Also, I was bad at searching and didn't
realize that program existed before writing this one (I had even initally given
them the same name by coincidence).
## Usage
```
usage: targpg [-h] [-V] [-v] [-q] [-c] [-p PASSFILE] [-o] [-d DIR] [-a [ADD ...]] [-u [UPDATE ...]] [-r [REMOVE ...]] [-e [EXTR ...]] [-l]
archive
manage secure archive containing sensative docs
positional arguments:
archive tar file secured by gpg symetric password
optional arguments:
-h, --help show this help message and exit
-V, --version show program's version number and exit
-v, --verbose more verbose output
-q, --quite supress output
-c, --create create the file without confirmation if it does not exist
-p PASSFILE, --passfile PASSFILE
file with archive password stored in it
-o, --output directory to extract files to
-d DIR, --directory DIR
when adding files, do it relative to this directory
-a [ADD ...], --add [ADD ...]
add files to the archive
-u [UPDATE ...], --update [UPDATE ...]
overwrite existing files if any being passed in match
-r [REMOVE ...], --remove [REMOVE ...]
add files to the archive
-e [EXTR ...], --extract [EXTR ...]
extract the files from the archive, if no files given a prompt will ask
-l, --list list the contents of the archive
```
### create
Auto create the archive if it does not already exist.
### passfile
Load the password of the archive from a file instead of stdin.
### add
Add new files to the archive. `--directory` sets the working directory so files are
added relative to that directory.
### update
Update existing files in the archive. If they don't exist then an error will
be raised. `--directory` sets the working directory so files are
added relative to that directory.
### remove
Remove existing files in the archive. If they don't exist then an error will
be raised. `--directory` sets the working directory so files are
added relative to that directory.
### extract
Extract files from the archive. If the flag is used with no arguments, you will
be asked which files you want to extract. The `--output` flag will set the
directory to extract the files to.
### list
List the contents of the archive.
## Links
* [PyPi Project](https://pypi.org/project/targpg)
* [Github](https://github.com/spslater/targpg)
## Contributing
Help is greatly appreciated. First check if there are any issues open that
relate to what you want to help with. Also feel free to make a pull request
with changes / fixes you make.
## License
[MIT License](https://opensource.org/licenses/MIT)
Raw data
{
"_id": null,
"home_page": "https://github.com/spslater/targpg",
"name": "targpg",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "filesystem files secure tar gpg",
"author": "Sean Slater",
"author_email": "seanslater@whatno.io",
"download_url": "https://files.pythonhosted.org/packages/5f/a8/164e1532de40474ae69fa42a34d8cba010365d117b6a2b09f5b409c320ac/targpg-1.0.3.tar.gz",
"platform": null,
"description": "# Tar GnuPG\nManage a secure archive containing sensative docs.\n\n\n\n\n\nYou might be thinking, \"Hey there's already a\n[gpgtar](https://www.gnupg.org/documentation/manuals/gnupg/gpgtar.html)\nwhich seems to do exactly this, why don't I use that?\", and you could be right,\ndepending on your needs. The biggest difference is this package allows you to\nadd files to an existing archive. (It technically creates a new one and\noverwrites your old one, but does it without you needing to worry about that).\nThat's my biggest use case anyway. Also, I was bad at searching and didn't\nrealize that program existed before writing this one (I had even initally given\nthem the same name by coincidence).\n\n## Usage\n```\nusage: targpg [-h] [-V] [-v] [-q] [-c] [-p PASSFILE] [-o] [-d DIR] [-a [ADD ...]] [-u [UPDATE ...]] [-r [REMOVE ...]] [-e [EXTR ...]] [-l]\n archive\n\nmanage secure archive containing sensative docs\n\npositional arguments:\n archive tar file secured by gpg symetric password\n\noptional arguments:\n -h, --help show this help message and exit\n -V, --version show program's version number and exit\n -v, --verbose more verbose output\n -q, --quite supress output\n -c, --create create the file without confirmation if it does not exist\n -p PASSFILE, --passfile PASSFILE\n file with archive password stored in it\n -o, --output directory to extract files to\n -d DIR, --directory DIR\n when adding files, do it relative to this directory\n -a [ADD ...], --add [ADD ...]\n add files to the archive\n -u [UPDATE ...], --update [UPDATE ...]\n overwrite existing files if any being passed in match\n -r [REMOVE ...], --remove [REMOVE ...]\n add files to the archive\n -e [EXTR ...], --extract [EXTR ...]\n extract the files from the archive, if no files given a prompt will ask\n -l, --list list the contents of the archive\n```\n\n### create\nAuto create the archive if it does not already exist.\n\n### passfile\nLoad the password of the archive from a file instead of stdin.\n\n### add\nAdd new files to the archive. `--directory` sets the working directory so files are\nadded relative to that directory.\n\n### update\nUpdate existing files in the archive. If they don't exist then an error will\nbe raised. `--directory` sets the working directory so files are\nadded relative to that directory.\n\n### remove\nRemove existing files in the archive. If they don't exist then an error will\nbe raised. `--directory` sets the working directory so files are\nadded relative to that directory.\n\n### extract\nExtract files from the archive. If the flag is used with no arguments, you will\nbe asked which files you want to extract. The `--output` flag will set the\ndirectory to extract the files to.\n\n### list\nList the contents of the archive.\n\n\n## Links\n* [PyPi Project](https://pypi.org/project/targpg)\n* [Github](https://github.com/spslater/targpg)\n\n## Contributing\nHelp is greatly appreciated. First check if there are any issues open that\nrelate to what you want to help with. Also feel free to make a pull request\nwith changes / fixes you make.\n\n## License\n[MIT License](https://opensource.org/licenses/MIT)\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "manage secure archive containing sensative docs",
"version": "1.0.3",
"split_keywords": [
"filesystem",
"files",
"secure",
"tar",
"gpg"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ec187229a580b4a4abfd714c863226a422cff2afd85c6078218b241326ce0ab0",
"md5": "525c2d29e6fc12a3745e11e2204269dd",
"sha256": "2a069f867f2f332f2696dbbffd507caa9659b4c857350438abdf1afb40d6a4e0"
},
"downloads": -1,
"filename": "targpg-1.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "525c2d29e6fc12a3745e11e2204269dd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 10461,
"upload_time": "2023-03-17T08:24:27",
"upload_time_iso_8601": "2023-03-17T08:24:27.671624Z",
"url": "https://files.pythonhosted.org/packages/ec/18/7229a580b4a4abfd714c863226a422cff2afd85c6078218b241326ce0ab0/targpg-1.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5fa8164e1532de40474ae69fa42a34d8cba010365d117b6a2b09f5b409c320ac",
"md5": "1954d7bce74c7ac4b2e5e9190faf31a7",
"sha256": "375f8c2a74b3872775291dfb9582bbb5d6f3200fe4f10ac4da8e1ba041f7a675"
},
"downloads": -1,
"filename": "targpg-1.0.3.tar.gz",
"has_sig": false,
"md5_digest": "1954d7bce74c7ac4b2e5e9190faf31a7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 10208,
"upload_time": "2023-03-17T08:24:28",
"upload_time_iso_8601": "2023-03-17T08:24:28.691895Z",
"url": "https://files.pythonhosted.org/packages/5f/a8/164e1532de40474ae69fa42a34d8cba010365d117b6a2b09f5b409c320ac/targpg-1.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-03-17 08:24:28",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "spslater",
"github_project": "targpg",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "targpg"
}
JSON
