Archive-To-Images
Archive-To-Images is a Python CLI to transform archives into images and reverse.
Intro
Since some cloud providers offer free unlimited picture-only storage, the Archive-To-Images library allows to convert any collection of files into pictures to be uploaded without any additional cost.
Installation
The package can be easily installed via pip package manager:
$ pip install archive-to-images
Usage as CLI
Transform to images
$ archive-to-images transform --help
Usage: archive-to-images transform [OPTIONS]
Transforms an archive into multiple images.
╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ * --path -p TEXT Path containing data to be archived. [default: None] [required] │
│ * --name -n TEXT Name of the archive. [default: None] [required] │
│ --size -s [0.5|1|2|5|10] Maximum size of an image in MB. [default: 1] │
│ --encrypt -e Protect archive with password. │
│ --verbose -v Enable verbose output. │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Create an image collection from data contained in multiple paths.
$ archive-to-images transform --path /home/alice/Desktop --path /home/alice/Documents --name ARCHIVE_ALICE
Set the maximum image size in MB (default: 1):
$ archive-to-images transform --path /home/alice/Desktop --path /home/alice/Documents --name ARCHIVE_ALICE -s 5
Encrypt data with a password:
$ archive-to-images transform --path /home/alice/Desktop --path /home/alice/Documents --name ARCHIVE_ALICE -s 5 -e
Restore from images
$ archive-to-images restore --help
Usage: archive-to-images restore [OPTIONS]
Restores an archive from multiple images.
╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ * --path -p TEXT Path containing images to be processed. [default: None] [required] │
│ --verbose -v Enable verbose output. │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Restore the archives stored in image collections:
$ archive-to-images restore --path /home/alice/Downloads/Album1 --path /home/alice/Downloads/Album2
The library will automatically find all the archives stored in the images and will output a zip archive for each one.
Usage as docker
Run the docker image and bind the current folder to the workspace path inside the container:
$ docker run -it --rm -v $(pwd):/workspace peco602/archive_to_images:latest bash
then it is possible to use the CLI directly from the container bash.
Buy me a coffee
Do you like my work or did you find it useful?
License
Copyright (c) 2022-present Giovanni Pecoraro
Licensed under MIT License
1 maintainer
Metadata
1 maintainer
Release files for archive-to-images 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| archive_to_images-1.0.0.tar.gz | 9.9 kB | Without provenance | Details for archive_to_images-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| archive_to_images-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for archive_to_images-1.0.0-py3-none-any.whl |
Total release size: 19.6 kB
Release files / archive_to_images-1.0.0.tar.gz
| Download URL | archive_to_images-1.0.0.tar.gz |
|---|---|
| Size | 9.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2bbe8cde82a84844d122640213a3eca37eeb99cd719d1a686b0ce76b51558fd7
|
|
BLAKE2b-256 checksum How to use checksums |
d5f69b4d4b67842fe6d554fc72535069404ca512fa538f752abdc0243f66987a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.11.2
|
Release files / archive_to_images-1.0.0-py3-none-any.whl
| Download URL | archive_to_images-1.0.0-py3-none-any.whl |
|---|---|
| Size | 9.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5c46802c98c8425adbfff7e1d0481e61ebb5a649fad62c16f73433e8abfa0660
|
|
BLAKE2b-256 checksum How to use checksums |
9376aaeb3aa63b076ccd19e0bf6b15a6f0cbeadb748a100f7bd5aa5c61bfae5d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.1 CPython/3.11.2
|
Security for archive-to-images 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
