# ThinIce - friendly client for Amazon Glacier
## Install
~~~shell
pipx install thinice
~~~
or (recommended: in virtualenv):
~~~shell
pip3 install thinice
~~~
## Configuration
Create config dir `mkdir ~/.config/thinice` and make config file `~/.config/thinice/thinice.env`, example:
~~~
AWS_ACCESS_KEY_ID = AK...
AWS_SECRET_ACCESS_KEY = FN...
AWS_REGION = eu-south-1
AWS_GLACIER_VAULT = mytest
~~~
Or you can supply this via options: `--key-id`, `--secret-key`, `--region` and `--vault`.
## Basic commands
### Inventory
First, you need to initialize local inventory:
~~~shell
# request inventory
thinice inventory
# watch when job complete (will take few hours)
thinice job
# now accept inventory with same command
thinice inventory
# now you can list files
thinice ls
~~~
### Upload
Thinice support multipart uploads and can upload very large files
~~~shell
# No description explicitly given, description will be myarchive.zip
thinice upload /path/to/myarchive.zip
# Upload with description
thinice upload /path/to/myarchive.zip "My archive from 01/02/2003"
~~~
### Download
~~~shell
# To download, we should *warm* file, transit it from cold to warm storage
thinice request myarchive.zip
# or by first part of ArchiveId
thinice request S39to
# watch it in list to become warm (will take few hours)
thinice ls
# and finally download it
# file with this description MyServer.tar.gz will be saved as MyServer.tar.gz (only if description is a filename)
thinice download myarchive.zip
# download file with ArchiveId starting with this characters
thinice download S39to myarchive.zip
~~~
### Delete
~~~shell
# delete archive with this ArchiveId
thinice delete S39to
# delete all archives with this ArchiveDescription
thinice delete myarchive.zip
~~~
### Other commands
~~~shell
# help
thinice -h
thinice download -h
# list vaults
thinice vaults
# list jobs
thinice jobs
~~~
Raw data
{
"_id": null,
"home_page": null,
"name": "thinice",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "API, CLI, Glacier, aws, cold, cold storage, download, friendly, inventory, s4fs, storage, tool, upload, utility",
"author": null,
"author_email": "Yaroslav Polyakov <yaroslaff@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/18/9e/ac81968f2cb6f10c16d2ab1302f9ab80313ac537c0844fe12a8e86875cc8/thinice-1.0.4.tar.gz",
"platform": null,
"description": "# ThinIce - friendly client for Amazon Glacier \n\n## Install\n~~~shell\npipx install thinice\n~~~\nor (recommended: in virtualenv):\n~~~shell\npip3 install thinice\n~~~\n\n## Configuration\nCreate config dir `mkdir ~/.config/thinice` and make config file `~/.config/thinice/thinice.env`, example:\n~~~\nAWS_ACCESS_KEY_ID = AK...\nAWS_SECRET_ACCESS_KEY = FN...\nAWS_REGION = eu-south-1\nAWS_GLACIER_VAULT = mytest\n~~~\n\nOr you can supply this via options: `--key-id`, `--secret-key`, `--region` and `--vault`.\n\n## Basic commands\n### Inventory\nFirst, you need to initialize local inventory:\n~~~shell\n# request inventory\nthinice inventory\n\n# watch when job complete (will take few hours)\nthinice job\n\n# now accept inventory with same command\nthinice inventory\n\n# now you can list files\nthinice ls\n~~~\n\n### Upload\nThinice support multipart uploads and can upload very large files\n~~~shell\n# No description explicitly given, description will be myarchive.zip\nthinice upload /path/to/myarchive.zip\n\n# Upload with description\nthinice upload /path/to/myarchive.zip \"My archive from 01/02/2003\"\n~~~\n\n### Download\n~~~shell\n# To download, we should *warm* file, transit it from cold to warm storage\nthinice request myarchive.zip\n\n# or by first part of ArchiveId\nthinice request S39to\n\n# watch it in list to become warm (will take few hours)\nthinice ls\n\n# and finally download it\n# file with this description MyServer.tar.gz will be saved as MyServer.tar.gz (only if description is a filename)\nthinice download myarchive.zip\n\n# download file with ArchiveId starting with this characters\nthinice download S39to myarchive.zip\n~~~\n\n### Delete\n~~~shell\n# delete archive with this ArchiveId\nthinice delete S39to\n\n# delete all archives with this ArchiveDescription\nthinice delete myarchive.zip\n~~~\n\n### Other commands\n~~~shell\n# help\nthinice -h\nthinice download -h\n\n# list vaults\nthinice vaults\n\n# list jobs\nthinice jobs\n~~~\n",
"bugtrack_url": null,
"license": null,
"summary": "Human-friendly Amazon glacier API",
"version": "1.0.4",
"project_urls": {
"Homepage": "https://github.com/yaroslaff/ThinIce",
"Issues": "https://github.com/yaroslaff/showcert/ThinIce"
},
"split_keywords": [
"api",
" cli",
" glacier",
" aws",
" cold",
" cold storage",
" download",
" friendly",
" inventory",
" s4fs",
" storage",
" tool",
" upload",
" utility"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "43768f0225063f52774cc5a397bf120c939bcda0a334986bcd692c6a961afd4f",
"md5": "59a4c19fa2805b7a46f672a00cec73d9",
"sha256": "eb239145bfd8d557118f8303025f610100ffa90a6e3c0260b61b3941b82a85e3"
},
"downloads": -1,
"filename": "thinice-1.0.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "59a4c19fa2805b7a46f672a00cec73d9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 20747,
"upload_time": "2024-10-25T20:37:37",
"upload_time_iso_8601": "2024-10-25T20:37:37.427853Z",
"url": "https://files.pythonhosted.org/packages/43/76/8f0225063f52774cc5a397bf120c939bcda0a334986bcd692c6a961afd4f/thinice-1.0.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "189eac81968f2cb6f10c16d2ab1302f9ab80313ac537c0844fe12a8e86875cc8",
"md5": "04c63554d3ccb8712b5fc738bb8a5553",
"sha256": "54fab8af216e2fee6e5705c9bbe5a8985d78296992d52dbf6a7df601e3de2f26"
},
"downloads": -1,
"filename": "thinice-1.0.4.tar.gz",
"has_sig": false,
"md5_digest": "04c63554d3ccb8712b5fc738bb8a5553",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 14654,
"upload_time": "2024-10-25T20:37:35",
"upload_time_iso_8601": "2024-10-25T20:37:35.052051Z",
"url": "https://files.pythonhosted.org/packages/18/9e/ac81968f2cb6f10c16d2ab1302f9ab80313ac537c0844fe12a8e86875cc8/thinice-1.0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-25 20:37:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yaroslaff",
"github_project": "ThinIce",
"github_not_found": true,
"lcname": "thinice"
}