web-mage
web-mage is a simple Python package that's used to automate the process of optimizing image files for the web. It can be imported and customized in a Python module, or run simply as a command-line utility.
This project is functional, but still in early development.
Installation
Install using pip:
pip install web-mage
Usage
python3 -m web_mage SOURCE_DIR DEST_DIR
This will optimize all files in SOURCE_DIR to 60% quality with no image resizing,
and output them to DEST_DIR with a filename suffix.
Usage in Code
This is the preferred method of usage. You can import web-mage into Python if you want to run jobs in a script or program, or customize the way images are optimized.
from web_mage.web_mage import Job
from web_mage.formats import IMG_FORMAT_CONTENT_LARGE
formats = [IMG_FORMAT_CONTENT_LARGE]
optim_job = Job(source="/path/to/source/directory",
dest="/path/to/output/directory",
formats=formats)
optim_job.run()
You can use multiple formats if you want images to be optimized for multiple different devices or layouts. You can also define your own image formats based on a few different parameters.
from web_mage.formats import (ImageFormat,
IMG_FORMAT_CONTENT_LARGE,
IMG_FORMAT_CONTENT_MEDIUM,
IMG_FORMAT_CONTENT_SMALL)
my_format = ImageFormat(max_width=1024, # Image will be resized based on dimensions.
max_height=768,
min_quality=85, # This will optimize to 85% quality.
tag="my_format") # Tags are appended to the filename of the
# resulting file so multiple output formats
# can be distinguished.
my_other_format = ImageFormat(max_dimension=1280, # This will ensure that neither height
# nor width will exceed 1280 pixels.
tag="my_other_format")
formats = [IMG_FORMAT_CONTENT_LARGE,
IMG_FORMAT_CONTENT_MEDIUM,
IMG_FORMAT_CONTENT_SMALL,
my_format,
my_other_format]
Metadata
Release files for web-mage 0.2.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 |
|---|---|---|---|---|
| web_mage-0.2.0.tar.gz | 6.1 kB | Without provenance | Details for web_mage-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| web_mage-0.2.0-py2.py3-none-any.whl | Python 2, Python 3 | none | any | Details for web_mage-0.2.0-py2.py3-none-any.whl |
Total release size: 11.8 kB
Release files / web_mage-0.2.0.tar.gz
| Download URL | web_mage-0.2.0.tar.gz |
|---|---|
| Size | 6.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8088676a9d4f6c65e5e110f89cabe9b06c7e9fbfda142a84101d63ad43f74af3
|
|
BLAKE2b-256 checksum How to use checksums |
26d3d97a89415a8949009bd4406c7a281740c6c203a74bc270866f637be98e31
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.5.2
|
Release files / web_mage-0.2.0-py2.py3-none-any.whl
| Download URL | web_mage-0.2.0-py2.py3-none-any.whl |
|---|---|
| Size | 5.7 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
3a95d2e80d8354cf64160fd5b63c6823ea0d343b3cdadab952bf1d0c78e0b1d0
|
|
BLAKE2b-256 checksum How to use checksums |
29e1b1a04df8e979a8dde80b62e5e74a432266712829c182ec6817e2f0c76a6c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.5.2
|
Security for web-mage 0.2.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.