Archive-To-Images is a Python CLI to transform archives into images and reverse.
Project description
Archive-To-Images
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for archive_to_images-1.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5c46802c98c8425adbfff7e1d0481e61ebb5a649fad62c16f73433e8abfa0660 |
|
MD5 | c20814b9da064abf47b7c8a32fcd3bac |
|
BLAKE2b-256 | 9376aaeb3aa63b076ccd19e0bf6b15a6f0cbeadb748a100f7bd5aa5c61bfae5d |