fotolab 0.9.1__tar.gz → 0.14.0__tar.gz

{fotolab-0.9.1 → fotolab-0.14.0}/.pre-commit-config.yaml

@@ -2,7 +2,7 @@
 # See https://pre-commit.com/hooks.html for more hooks
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.5.0
+    rev: v4.6.0
     hooks:
       - id: check-case-conflict
       - id: check-merge-conflict
@@ -45,7 +45,7 @@ repos:
           - --py=312
 
   - repo: https://github.com/psf/black
-    rev: 24.3.0
+    rev: 24.4.2
     hooks:
       - id: black
         language_version: python3.12
@@ -104,10 +104,10 @@ repos:
           - fotolab
           - tests
           - --unsafe-load-any-extension=y
-          - --disable=R0801
+          - --disable=R0801,W0212
 
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.9.0
+    rev: v1.10.0
     hooks:
       - id: mypy
         exclude: docs/

{fotolab-0.9.1 → fotolab-0.14.0}/CHANGELOG.md

@@ -7,6 +7,68 @@ and this project adheres to [0-based versioning](https://0ver.org/).
 
 ## [Unreleased]
 
+## v0.14.0 (2024-04-28)
+
+### Added
+
+- Add `animate` subcommand to create animated `gif` image
+
+### Changed
+
+- Bump deps and `pre-commit` hooks
+
+## v0.13.0 (2024-04-21)
+
+### Changed
+
+- Bump deps
+- Support processing multiple images at once
+- Update missing help message in readme
+
+## v0.12.0 (2024-04-14)
+
+### Added
+
+- Add `-pd` or `--padding` option to set the padding of watermark text block
+
+### Changed
+
+- Bump deps, `pre-commit` hooks, and Python versions for `pyenv`
+
+### Fixed
+
+- Fix `auto` subcommand missing `padding` field
+- Fix missing closing parenthesis in help message
+- Update missing subcommand help message in README
+
+## v0.11.0 (2024-04-07)
+
+### Added
+
+- Add `montage` subcommand to join multiple images
+
+### Changed
+
+- Bump deps
+- Update missing subcommand help message in README
+
+## v0.10.0 (2024-03-31)
+
+### Added
+
+- Add `info` subcommand to show EXIF data from image
+
+### Changed
+
+- Bump deps
+- Update help message in README
+- Ignore `pylint` W0212 rule
+
+### Fix
+
+- Fix incorrect action in log when running `auto` subcommand
+- Update incorrect comment for `save_image` helper function
+
 ## v0.9.1 (2024-03-24)
 
 ### Changed

{fotolab-0.9.1 → fotolab-0.14.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fotolab
-Version: 0.9.1
+Version: 0.14.0
 Summary: A console program that manipulate images.
 Keywords: photography,photo
 Author-email: Kian-Meng Ang <kianmeng@cpan.org>
@@ -59,7 +59,8 @@ fotolab -h
 ```console
 
 usage: fotolab [-h] [-o] [-op] [-od OUTPUT_DIR] [-q] [-d] [-V]
-               {auto,border,contrast,resize,sharpen,watermark,env} ...
+               {animate,auto,border,contrast,info,resize,montage,sharpen,watermark,env}
+               ...
 
 A console program to manipulate photos.
 
@@ -68,12 +69,15 @@ A console program to manipulate photos.
   issues: https://github.com/kianmeng/fotolab/issues
 
 positional arguments:
-  {auto,border,contrast,resize,sharpen,watermark,env}
+  {animate,auto,border,contrast,info,resize,montage,sharpen,watermark,env}
                     sub-command help
+    animate         animate an image
     auto            auto adjust (resize, contrast, and watermark) a photo
     border          add border to image
     contrast        contrast an image
+    info            info an image
     resize          resize an image
+    montage         montage a list of image
     sharpen         sharpen an image
     watermark       watermark an image
     env             print environment information for bug reporting
@@ -81,7 +85,7 @@ positional arguments:
 optional arguments:
   -h, --help        show this help message and exit
   -o, --overwrite   overwrite existing image
-  -op, --open       open the image using default program (default: 'False'
+  -op, --open       open the image using default program (default: 'False')
   -od OUTPUT_DIR, --output-dir OUTPUT_DIR
                     set default output folder (default: 'output')
   -q, --quiet       suppress all logging
@@ -89,6 +93,45 @@ optional arguments:
   -V, --version     show program's version number and exit
 ```
 
+### fotolab animate
+
+```console
+fotolab animate -h
+```
+
+```console
+
+usage: fotolab animate [-h] [-f FORMAT] [-d DURATION] [-l LOOP]
+                       IMAGE_FILENAMES [IMAGE_FILENAMES ...]
+
+positional arguments:
+  IMAGE_FILENAMES       set the image filenames
+
+optional arguments:
+  -h, --help            show this help message and exit
+  -f FORMAT, --format FORMAT
+                        set the image format (default: 'gif')
+  -d DURATION, --duration DURATION
+                        set the duration in milliseconds (default: '2500')
+  -l LOOP, --loop LOOP  set the loop cycle (default: '0')
+```
+
+### fotolab auto
+
+```console
+fotolab auto -h
+```
+
+```console
+usage: fotolab auto [-h] IMAGE_FILENAMES [IMAGE_FILENAMES ...]
+
+positional arguments:
+  IMAGE_FILENAMES  set the image filename
+
+optional arguments:
+  -h, --help       show this help message and exit
+```
+
 ### fotolab border
 
 ```console
@@ -98,12 +141,12 @@ fotolab border -h
 ```console
 usage: fotolab border [-h] [-c COLOR] [-w WIDTH] [-wt WIDTH] [-wr WIDTH]
                       [-wb WIDTH] [-wl WIDTH]
-                      IMAGE_FILENAME
+                      IMAGE_FILENAMES [IMAGE_FILENAMES ...]
 
 positional arguments:
-  IMAGE_FILENAME        set the image filename
+  IMAGE_FILENAMES       set the image filenames
 
-options:
+optional arguments:
   -h, --help            show this help message and exit
   -c COLOR, --color COLOR
                         set the color of border (default: 'black')
@@ -126,7 +169,26 @@ fotolab contrast -h
 ```
 
 ```console
-usage: fotolab contrast [-h] IMAGE_FILENAME
+usage: fotolab contrast [-h] [-c CUTOFF] IMAGE_FILENAMES [IMAGE_FILENAMES ...]
+
+positional arguments:
+  IMAGE_FILENAMES       set the image filename
+
+optional arguments:
+  -h, --help            show this help message and exit
+  -c CUTOFF, --cutoff CUTOFF
+                        set the percentage of lightest or darkest pixels to
+                        discard from histogram (default: '1')
+```
+
+### fotolab info
+
+```console
+fotolab info -h
+```
+
+```console
+usage: fotolab info [-h] IMAGE_FILENAME
 
 positional arguments:
   IMAGE_FILENAME  set the image filename
@@ -135,6 +197,44 @@ optional arguments:
   -h, --help      show this help message and exit
 ```
 
+### fotolab montage
+
+```console
+fotolab montage -h
+```
+
+```console
+
+usage: fotolab montage [-h] IMAGE_FILENAMES [IMAGE_FILENAMES ...]
+
+positional arguments:
+  IMAGE_FILENAMES  set the image filenames
+
+optional arguments:
+  -h, --help       show this help message and exit
+```
+
+### fotolab resize
+
+```console
+fotolab resize -h
+```
+
+```console
+usage: fotolab resize [-h] [-wh WIDTH] [-ht HEIGHT]
+                      IMAGE_FILENAMES [IMAGE_FILENAMES ...]
+
+positional arguments:
+  IMAGE_FILENAMES       set the image filename
+
+optional arguments:
+  -h, --help            show this help message and exit
+  -wh WIDTH, --width WIDTH
+                        set the width of the image (default: '600')
+  -ht HEIGHT, --height HEIGHT
+                        set the height of the image (default: '277')
+```
+
 ### fotolab sharpen
 
 ```console
@@ -142,13 +242,22 @@ fotolab sharpen -h
 ```
 
 ```console
-usage: fotolab sharpen [-h] IMAGE_FILENAME
+usage: fotolab sharpen [-h] [-r RADIUS] [-p PERCENT] [-t THRESHOLD]
+                       IMAGE_FILENAMES [IMAGE_FILENAMES ...]
 
 positional arguments:
-  IMAGE_FILENAME  set the image filename
+  IMAGE_FILENAMES       set the image filenames
 
-options:
-  -h, --help      show this help message and exit
+optional arguments:
+  -h, --help            show this help message and exit
+  -r RADIUS, --radius RADIUS
+                        set the radius or size of edges (default: '1')
+  -p PERCENT, --percent PERCENT
+                        set the amount of overall strength of sharpening
+                        effect (default: '100')
+  -t THRESHOLD, --threshold THRESHOLD
+                        set the minimum brightness changed to be sharpened
+                        (default: '3')
 ```
 
 ### fotolab watermark
@@ -160,20 +269,23 @@ fotolab watermark -h
 ```console
 usage: fotolab watermark [-h] [-t WATERMARK_TEXT]
                          [-p {top-left,top-right,bottom-left,bottom-right}]
-                         [-fs FONT_SIZE] [-fc FONT_COLOR] [-ow OUTLINE_WIDTH]
-                         [-oc OUTLINE_COLOR]
-                         IMAGE_FILENAME
+                         [-pd PADDING] [-fs FONT_SIZE] [-fc FONT_COLOR]
+                         [-ow OUTLINE_WIDTH] [-oc OUTLINE_COLOR]
+                         IMAGE_FILENAMES [IMAGE_FILENAMES ...]
 
 positional arguments:
-  IMAGE_FILENAME        set the image filename
+  IMAGE_FILENAMES       set the image filenames
 
-options:
+optional arguments:
   -h, --help            show this help message and exit
   -t WATERMARK_TEXT, --text WATERMARK_TEXT
                         set the watermark text (default: 'kianmeng.org')
   -p {top-left,top-right,bottom-left,bottom-right}, --position {top-left,top-right,bottom-left,bottom-right}
                         set position of the watermark text (default: 'bottom-
                         left')
+  -pd PADDING, --padding PADDING
+                        set the padding of the watermark text relative to the
+                        image (default: '15')
   -fs FONT_SIZE, --font-size FONT_SIZE
                         set the font size of watermark text (default: '12')
   -fc FONT_COLOR, --font-color FONT_COLOR