fotolab 0.18.4__py2.py3-none-any.whl → 0.20.0__py2.py3-none-any.whl

fotolab/__init__.py

@@ -21,7 +21,7 @@ import subprocess
 import sys
 from pathlib import Path
 
-__version__ = "0.18.4"
+__version__ = "0.20.0"
 
 log = logging.getLogger(__name__)
 

fotolab/auto.py

@@ -68,6 +68,7 @@ def run(args: argparse.Namespace) -> None:
         "outline_color": "black",
         "padding": 15,
         "camera": False,
+        "canvas": False,
         "lowercase": False,
     }
     combined_args = argparse.Namespace(**vars(args), **extra_args)

fotolab/resize.py

@@ -18,8 +18,9 @@
 import argparse
 import logging
 import math
+import sys
 
-from PIL import Image
+from PIL import Image, ImageColor
 
 from fotolab import save_image
 
@@ -44,28 +45,69 @@ def build_subparser(subparsers) -> None:
         metavar="IMAGE_FILENAMES",
     )
 
-    group = resize_parser.add_mutually_exclusive_group(required=False)
-
-    group.add_argument(
-        "-wh",
-        "--width",
-        dest="width",
-        help="set the width of the image (default: '%(default)s')",
-        type=int,
-        default=DEFAULT_WIDTH,
-        metavar="WIDTH",
+    resize_parser.add_argument(
+        "-c",
+        "--canvas",
+        default=False,
+        action="store_true",
+        dest="canvas",
+        help="paste image onto a larger canvas",
     )
 
-    group.add_argument(
-        "-ht",
-        "--height",
-        dest="height",
-        help="set the height of the image (default: '%(default)s')",
-        type=int,
-        default=DEFAULT_HEIGHT,
-        metavar="HEIGHT",
+    resize_parser.add_argument(
+        "-l",
+        "--canvas-color",
+        default="black",
+        dest="canvas_color",
+        help=(
+            "the color of the extended larger canvas"
+            "(default: '%(default)s')"
+        ),
     )
 
+    if "-c" in sys.argv or "--canvas" in sys.argv:
+        resize_parser.add_argument(
+            "-W",
+            "--width",
+            dest="width",
+            help="set the width of the image (default: '%(default)s')",
+            type=int,
+            required=True,
+            metavar="WIDTH",
+        )
+
+        resize_parser.add_argument(
+            "-H",
+            "--height",
+            dest="height",
+            help="set the height of the image (default: '%(default)s')",
+            type=int,
+            required=True,
+            metavar="HEIGHT",
+        )
+    else:
+        group = resize_parser.add_mutually_exclusive_group(required=False)
+
+        group.add_argument(
+            "-W",
+            "--width",
+            dest="width",
+            help="set the width of the image (default: '%(default)s')",
+            type=int,
+            default=DEFAULT_WIDTH,
+            metavar="WIDTH",
+        )
+
+        group.add_argument(
+            "-H",
+            "--height",
+            dest="height",
+            help="set the height of the image (default: '%(default)s')",
+            type=int,
+            default=DEFAULT_HEIGHT,
+            metavar="HEIGHT",
+        )
+
 
 def run(args: argparse.Namespace) -> None:
     """Run resize subcommand.
@@ -80,14 +122,32 @@ def run(args: argparse.Namespace) -> None:
 
     for image_filename in args.image_filenames:
         original_image = Image.open(image_filename)
+        if args.canvas:
+            resized_image = _resize_image_onto_canvas(original_image, args)
+        else:
+            resized_image = _resize_image(original_image, args)
+        save_image(args, resized_image, image_filename, "resize")
 
-        new_width, new_height = _calc_new_image_dimension(original_image, args)
-        resized_image = original_image.copy()
-        resized_image = resized_image.resize(
-            (new_width, new_height), Image.Resampling.LANCZOS
-        )
 
-        save_image(args, resized_image, image_filename, "resize")
+def _resize_image_onto_canvas(original_image, args):
+    resized_image = Image.new(
+        "RGB",
+        (args.width, args.height),
+        (*ImageColor.getrgb(args.canvas_color), 128),
+    )
+    x_offset = (args.width - original_image.width) // 2
+    y_offset = (args.height - original_image.height) // 2
+    resized_image.paste(original_image, (x_offset, y_offset))
+    return resized_image
+
+
+def _resize_image(original_image, args):
+    new_width, new_height = _calc_new_image_dimension(original_image, args)
+    resized_image = original_image.copy()
+    resized_image = resized_image.resize(
+        (new_width, new_height), Image.Resampling.LANCZOS
+    )
+    return resized_image
 
 
 def _calc_new_image_dimension(image, args) -> tuple:

{fotolab-0.18.4.dist-info → fotolab-0.20.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fotolab
-Version: 0.18.4
+Version: 0.20.0
 Summary: A console program that manipulate images.
 Keywords: photography,photo
 Author-email: Kian-Meng Ang <kianmeng@cpan.org>
@@ -60,14 +60,13 @@ fotolab -h
 
 ```console
 usage: fotolab [-h] [-o] [-op] [-od OUTPUT_DIR] [-q] [-v] [-d] [-V]
-               {animate,auto,border,contrast,info,resize,rotate,montage,sharpen,watermark,env}
-               ...
+               {animate,auto,border,contrast,info,resize,rotate,montage,sharpen,watermark,env} ...
 
 A console program to manipulate photos.
 
-  website: https://github.com/kianmeng/fotolab
-  changelog: https://github.com/kianmeng/fotolab/blob/master/CHANGELOG.md
-  issues: https://github.com/kianmeng/fotolab/issues
+website: https://github.com/kianmeng/fotolab
+changelog: https://github.com/kianmeng/fotolab/blob/master/CHANGELOG.md
+issues: https://github.com/kianmeng/fotolab/issues
 
 positional arguments:
   {animate,auto,border,contrast,info,resize,rotate,montage,sharpen,watermark,env}
@@ -88,7 +87,7 @@ options:
   -h, --help        show this help message and exit
   -o, --overwrite   overwrite existing image
   -op, --open       open the image using default program (default: 'False')
-  -od OUTPUT_DIR, --output-dir OUTPUT_DIR
+  -od, --output-dir OUTPUT_DIR
                     set default output folder (default: 'output')
   -q, --quiet       suppress all logging
   -v, --verbose     show verbosity of debugging log, use -vv, -vvv for more details
@@ -115,11 +114,10 @@ positional arguments:
 
 options:
   -h, --help            show this help message and exit
-  -f FORMAT, --format FORMAT
-                        set the image format (default: 'gif')
-  -d DURATION, --duration DURATION
+  -f, --format FORMAT   set the image format (default: 'gif')
+  -d, --duration DURATION
                         set the duration in milliseconds (default: '2500')
-  -l LOOP, --loop LOOP  set the loop cycle (default: '0')
+  -l, --loop LOOP       set the loop cycle (default: '0')
 ```
 
 <!--help-animate !-->
@@ -162,17 +160,15 @@ positional arguments:
 
 options:
   -h, --help            show this help message and exit
-  -c COLOR, --color COLOR
-                        set the color of border (default: 'black')
-  -w WIDTH, --width WIDTH
-                        set the width of border (default: '10')
-  -wt WIDTH, --width-top WIDTH
+  -c, --color COLOR     set the color of border (default: 'black')
+  -w, --width WIDTH     set the width of border (default: '10')
+  -wt, --width-top WIDTH
                         set the width of top border (default: '0')
-  -wr WIDTH, --width-right WIDTH
+  -wr, --width-right WIDTH
                         set the width of right border (default: '0')
-  -wb WIDTH, --width-bottom WIDTH
+  -wb, --width-bottom WIDTH
                         set the width of bottom border (default: '0')
-  -wl WIDTH, --width-left WIDTH
+  -wl, --width-left WIDTH
                         set the width of left border (default: '0')
 ```
 
@@ -190,13 +186,12 @@ fotolab contrast -h
 usage: fotolab contrast [-h] [-c CUTOFF] IMAGE_FILENAMES [IMAGE_FILENAMES ...]
 
 positional arguments:
-  IMAGE_FILENAMES       set the image filename
+  IMAGE_FILENAMES      set the image filename
 
 options:
-  -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')
+  -h, --help           show this help message and exit
+  -c, --cutoff CUTOFF  set the percentage of lightest or darkest pixels to
+                       discard from histogram (default: '1')
 ```
 
 <!--help-contrast !-->
@@ -271,7 +266,7 @@ fotolab resize -h
 <!--help-resize !-->
 
 ```console
-usage: fotolab resize [-h] [-wh WIDTH | -ht HEIGHT]
+usage: fotolab resize [-h] [-c] [-l CANVAS_COLOR] [-W WIDTH | -H HEIGHT]
                       IMAGE_FILENAMES [IMAGE_FILENAMES ...]
 
 positional arguments:
@@ -279,10 +274,12 @@ positional arguments:
 
 options:
   -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')
+  -c, --canvas          paste image onto a larger canvas
+  -l, --canvas-color CANVAS_COLOR
+                        the color of the extended larger canvas(default:
+                        'black')
+  -W, --width WIDTH     set the width of the image (default: '600')
+  -H, --height HEIGHT   set the height of the image (default: '277')
 ```
 
 <!--help-resize !-->
@@ -304,12 +301,11 @@ positional arguments:
 
 options:
   -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
+  -r, --radius RADIUS   set the radius or size of edges (default: '1')
+  -p, --percent PERCENT
                         set the amount of overall strength of sharpening
                         effect (default: '100')
-  -t THRESHOLD, --threshold THRESHOLD
+  -t, --threshold THRESHOLD
                         set the minimum brightness changed to be sharpened
                         (default: '3')
 ```
@@ -329,6 +325,7 @@ usage: fotolab watermark [-h] [-t WATERMARK_TEXT]
                          [-p {top-left,top-right,bottom-left,bottom-right}]
                          [-pd PADDING] [-fs FONT_SIZE] [-fc FONT_COLOR]
                          [-ow OUTLINE_WIDTH] [-oc OUTLINE_COLOR] [--camera]
+                         [-l]
                          IMAGE_FILENAMES [IMAGE_FILENAMES ...]
 
 positional arguments:
@@ -336,26 +333,27 @@ positional arguments:
 
 options:
   -h, --help            show this help message and exit
-  -t WATERMARK_TEXT, --text WATERMARK_TEXT
+  -t, --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}
+  -p, --position {top-left,top-right,bottom-left,bottom-right}
                         set position of the watermark text (default: 'bottom-
                         left')
-  -pd PADDING, --padding PADDING
+  -pd, --padding PADDING
                         set the padding of the watermark text relative to the
                         image (default: '15')
-  -fs FONT_SIZE, --font-size FONT_SIZE
+  -fs, --font-size FONT_SIZE
                         set the font size of watermark text (default: '12')
-  -fc FONT_COLOR, --font-color FONT_COLOR
+  -fc, --font-color FONT_COLOR
                         set the font color of watermark text (default:
                         'white')
-  -ow OUTLINE_WIDTH, --outline-width OUTLINE_WIDTH
+  -ow, --outline-width OUTLINE_WIDTH
                         set the outline width of the watermark text (default:
                         '2')
-  -oc OUTLINE_COLOR, --outline-color OUTLINE_COLOR
+  -oc, --outline-color OUTLINE_COLOR
                         set the outline color of the watermark text (default:
                         'black')
   --camera              use camera metadata as watermark
+  -l, --lowercase       lowercase the watermark text
 ```
 
 <!--help-watermark !-->

{fotolab-0.18.4.dist-info → fotolab-0.20.0.dist-info}/RECORD

@@ -1,19 +1,19 @@
-fotolab/__init__.py,sha256=QfvhUv_TG0_NHbiDaoyO0xlAfhUMvTGH9pRgXQYVPMw,2061
+fotolab/__init__.py,sha256=kzqXT6wNge8UafUzTa85ZAalhfHIlxqmxi_5tm2kG38,2061
 fotolab/__main__.py,sha256=aboOURPs_snOXTEWYR0q8oq1UTY9e-NxCd1j33V0wHI,833
 fotolab/animate.py,sha256=ejimhTozo9DN7BbqqcV4x8zLnanZRKq1pxBBFeOdr6Q,2967
-fotolab/auto.py,sha256=SmEEbTXFiP1BiqaAFxPNTcGguVSUbAmLbSuWf_LgsBY,2270
+fotolab/auto.py,sha256=l_-Kf5V5Anvwz1QV1ET-42YsDWEeHf_okHkXWOycWAI,2295
 fotolab/border.py,sha256=5ch2d7LVPhB2OFuuXSW5ci6Cn967CPDQu0qSfaO7uMg,3591
 fotolab/cli.py,sha256=FBFSeMNqcOiJ6MuAcy0qUvc9cscdFUG946HlWZXBPtY,4984
 fotolab/contrast.py,sha256=l7Bs5p8W8ypN9Cg3fFHnU-A20UwMKtjTiPk6D0PRwpM,2095
 fotolab/env.py,sha256=fzUoRWgYEiYJIWYEiiSLEb7dH_xVUOnhMpQgc1yjrTY,1457
 fotolab/info.py,sha256=kbKMIqdkK-Wn2lWLvnFL_Efc45K9KCaR_euTv9LIGzw,2256
 fotolab/montage.py,sha256=lUVY-zDSH7mwH-s34_XefdNp7CoDJHkwpbTUGiyJGgs,2037
-fotolab/resize.py,sha256=cvPfh4wUfydM23Do7VnP6Bx2EqMHKfYFYrpiNhyWzCU,3259
+fotolab/resize.py,sha256=2bH1Kgoe_DqU8ozJ1E_oA6a9JPtuwIlo5a4sq_4Yles,5018
 fotolab/rotate.py,sha256=l_vQgf0IcI8AR1TSVsk4PrMZtJ3j_wpU77rKiGJ-KTA,1715
 fotolab/sharpen.py,sha256=wUPtJdtB6mCRmcHrA0CoEVO0O0ROBJWhejTvUeL67QU,2655
 fotolab/watermark.py,sha256=zxmTT1k78tdqqzbRu13YVOFQ0Z1cKd7JHU4M0nV01DU,7418
-fotolab-0.18.4.dist-info/entry_points.txt,sha256=mvw7AY_yZkIyjAxPtHNed9X99NZeLnMxEeAfEJUbrCM,44
-fotolab-0.18.4.dist-info/LICENSE.md,sha256=tGtFDwxWTjuR9syrJoSv1Hiffd2u8Tu8cYClfrXS_YU,31956
-fotolab-0.18.4.dist-info/WHEEL,sha256=Sgu64hAMa6g5FdzHxXv9Xdse9yxpGGMeagVtPMWpJQY,99
-fotolab-0.18.4.dist-info/METADATA,sha256=7zF_Jtmba82SK9yip3IJFa9uH9_es80Y4NMon2f0MMw,10676
-fotolab-0.18.4.dist-info/RECORD,,
+fotolab-0.20.0.dist-info/entry_points.txt,sha256=mvw7AY_yZkIyjAxPtHNed9X99NZeLnMxEeAfEJUbrCM,44
+fotolab-0.20.0.dist-info/LICENSE.md,sha256=tGtFDwxWTjuR9syrJoSv1Hiffd2u8Tu8cYClfrXS_YU,31956
+fotolab-0.20.0.dist-info/WHEEL,sha256=Sgu64hAMa6g5FdzHxXv9Xdse9yxpGGMeagVtPMWpJQY,99
+fotolab-0.20.0.dist-info/METADATA,sha256=IGoixqqnNPaX-faVwOGLClYzWTEZDZ-zoz1BZz3DZp8,10576
+fotolab-0.20.0.dist-info/RECORD,,