fotolab 0.21.1__py3-none-any.whl

fotolab-0.21.1.dist-info/METADATA

@@ -0,0 +1,399 @@
+Metadata-Version: 2.1
+Name: fotolab
+Version: 0.21.1
+Summary: A console program that manipulate images.
+Keywords: photography,photo
+Author-email: Kian-Meng Ang <kianmeng@cpan.org>
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python
+Requires-Dist: pillow
+Project-URL: Changelog, https://github.com/kianmeng/fotolab/blob/master/CHANGELOG.md
+Project-URL: Issues, https://github.com/kianmeng/fotolab/issues
+Project-URL: Source, https://github.com/kianmeng/fotolab
+
+# fotolab
+
+A console program to manipulate photos.
+
+## Installation
+
+Stable version From PyPI using `pipx`:
+
+```console
+pipx install fotolab
+```
+
+Stable version From PyPI using `pip`:
+
+```console
+python -m pip install fotolab
+```
+
+Upgrade to latest stable version:
+
+```console
+python3 -m pip install fotolab --upgrade
+```
+
+Latest development version from GitHub:
+
+```console
+python -m pip install -e git+https://github.com/kianmeng/fotolab.git
+```
+
+## Usage
+
+```console
+fotolab -h
+```
+
+<!--help !-->
+
+```console
+usage: fotolab [-h] [-o] [-op] [-od OUTPUT_DIR] [-q] [-v] [-d] [-V]
+               {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
+
+positional arguments:
+  {animate,auto,border,contrast,info,resize,rotate,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
+    rotate          rotate an image
+    montage         montage a list of image
+    sharpen         sharpen an image
+    watermark       watermark an image
+    env             print environment information for bug reporting
+
+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
+                    set default output folder (default: 'output')
+  -q, --quiet       suppress all logging
+  -v, --verbose     show verbosity of debugging log, use -vv, -vvv for more details
+  -d, --debug       show debugging log and stacktrace
+  -V, --version     show program's version number and exit
+```
+
+<!--help !-->
+
+### fotolab animate
+
+```console
+fotolab animate -h
+```
+
+<!--help-animate !-->
+
+```console
+usage: fotolab animate [-h] [-f FORMAT] [-d DURATION] [-l LOOP]
+                       IMAGE_FILENAMES [IMAGE_FILENAMES ...]
+
+positional arguments:
+  IMAGE_FILENAMES       set the image filenames
+
+options:
+  -h, --help            show this help message and exit
+  -f, --format FORMAT   set the image format (default: 'gif')
+  -d, --duration DURATION
+                        set the duration in milliseconds (default: '2500')
+  -l, --loop LOOP       set the loop cycle (default: '0')
+```
+
+<!--help-animate !-->
+
+### fotolab auto
+
+```console
+fotolab auto -h
+```
+
+<!--help-auto !-->
+
+```console
+usage: fotolab auto [-h] IMAGE_FILENAMES [IMAGE_FILENAMES ...]
+
+positional arguments:
+  IMAGE_FILENAMES  set the image filename
+
+options:
+  -h, --help       show this help message and exit
+```
+
+<!--help-auto !-->
+
+### fotolab border
+
+```console
+fotolab border -h
+```
+
+<!--help-border !-->
+
+```console
+usage: fotolab border [-h] [-c COLOR] [-w WIDTH] [-wt WIDTH] [-wr WIDTH]
+                      [-wb WIDTH] [-wl WIDTH]
+                      IMAGE_FILENAMES [IMAGE_FILENAMES ...]
+
+positional arguments:
+  IMAGE_FILENAMES       set the image filenames
+
+options:
+  -h, --help            show this help message and exit
+  -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-right WIDTH
+                        set the width of right border (default: '0')
+  -wb, --width-bottom WIDTH
+                        set the width of bottom border (default: '0')
+  -wl, --width-left WIDTH
+                        set the width of left border (default: '0')
+```
+
+<!--help-border !-->
+
+### fotolab contrast
+
+```console
+fotolab contrast -h
+```
+
+<!--help-contrast !-->
+
+```console
+usage: fotolab contrast [-h] [-c CUTOFF] IMAGE_FILENAMES [IMAGE_FILENAMES ...]
+
+positional arguments:
+  IMAGE_FILENAMES      set the image filename
+
+options:
+  -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 !-->
+
+### fotolab info
+
+```console
+fotolab info -h
+```
+
+<!--help-info !-->
+
+```console
+usage: fotolab info [-h] [-s] IMAGE_FILENAME
+
+positional arguments:
+  IMAGE_FILENAME  set the image filename
+
+options:
+  -h, --help      show this help message and exit
+  -s, --sort      show image info by sorted field name
+```
+
+<!--help-info !-->
+
+### fotolab rotate
+
+```console
+fotolab rotate -h
+```
+
+<!--help-rotate !-->
+
+```console
+usage: fotolab rotate [-h] IMAGE_FILENAMES [IMAGE_FILENAMES ...]
+
+positional arguments:
+  IMAGE_FILENAMES  set the image filenames
+
+options:
+  -h, --help       show this help message and exit
+```
+
+<!--help-rotate !-->
+
+### fotolab montage
+
+```console
+fotolab montage -h
+```
+
+<!--help-montage !-->
+
+```console
+usage: fotolab montage [-h] IMAGE_FILENAMES [IMAGE_FILENAMES ...]
+
+positional arguments:
+  IMAGE_FILENAMES  set the image filenames
+
+options:
+  -h, --help       show this help message and exit
+```
+
+<!--help-montage !-->
+
+### fotolab resize
+
+```console
+fotolab resize -h
+```
+
+<!--help-resize !-->
+
+```console
+usage: fotolab resize [-h] [-c] [-l CANVAS_COLOR] [-W WIDTH | -H HEIGHT]
+                      IMAGE_FILENAMES [IMAGE_FILENAMES ...]
+
+positional arguments:
+  IMAGE_FILENAMES       set the image filename
+
+options:
+  -h, --help            show this help message and exit
+  -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 !-->
+
+### fotolab sharpen
+
+```console
+fotolab sharpen -h
+```
+
+<!--help-sharpen !-->
+
+```console
+usage: fotolab sharpen [-h] [-r RADIUS] [-p PERCENT] [-t THRESHOLD]
+                       IMAGE_FILENAMES [IMAGE_FILENAMES ...]
+
+positional arguments:
+  IMAGE_FILENAMES       set the image filenames
+
+options:
+  -h, --help            show this help message and exit
+  -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
+                        set the minimum brightness changed to be sharpened
+                        (default: '3')
+```
+
+<!--help-sharpen !-->
+
+### fotolab watermark
+
+```console
+fotolab watermark -h
+```
+
+<!--help-watermark !-->
+
+```console
+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:
+  IMAGE_FILENAMES       set the image filenames
+
+options:
+  -h, --help            show this help message and exit
+  -t, --text WATERMARK_TEXT
+                        set the watermark text (default: 'kianmeng.org')
+  -p, --position {top-left,top-right,bottom-left,bottom-right}
+                        set position of the watermark text (default: 'bottom-
+                        left')
+  -pd, --padding PADDING
+                        set the padding of the watermark text relative to the
+                        image (default: '15')
+  -fs, --font-size FONT_SIZE
+                        set the font size of watermark text (default: '12')
+  -fc, --font-color FONT_COLOR
+                        set the font color of watermark text (default:
+                        'white')
+  -ow, --outline-width OUTLINE_WIDTH
+                        set the outline width of the watermark text (default:
+                        '2')
+  -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 env
+
+```console
+fotolab env -h
+```
+
+<!--help-env !-->
+
+```console
+usage: fotolab env [-h]
+
+options:
+  -h, --help  show this help message and exit
+```
+
+<!--help-env !-->
+
+## Copyright and License
+
+Copyright (C) 2024 Kian-Meng Ang
+
+This program is free software: you can redistribute it and/or modify it under
+the terms of the GNU Affero General Public License as published by the Free
+Software Foundation, either version 3 of the License, or (at your option) any
+later version.
+
+This program is distributed in the hope that it will be useful, but WITHOUT ANY
+WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
+PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License along
+with this program. If not, see <https://www.gnu.org/licenses/>.
+
+The fish logo used in the documentation generated by Sphinx is a public domain
+drawing of male freshwater phase [Sockeye (red) salmon (Oncorhynchus nerka)]
+(https://en.wikipedia.org/w/index.php?oldid=1186575702) from
+<https://commons.wikimedia.org/entity/M2787002>.
+

fotolab-0.21.1.dist-info/RECORD

@@ -0,0 +1,19 @@
+fotolab/__init__.py,sha256=fZZb0I229_RXcxunCTP3flULzE0p48prsOWsvTqLkyM,2061
+fotolab/__main__.py,sha256=aboOURPs_snOXTEWYR0q8oq1UTY9e-NxCd1j33V0wHI,833
+fotolab/animate.py,sha256=ejimhTozo9DN7BbqqcV4x8zLnanZRKq1pxBBFeOdr6Q,2967
+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=lY9n6HDnlDyRVDTRqYwzxm5xgPSyh0P8N3ybnnNtNtw,2892
+fotolab/montage.py,sha256=lUVY-zDSH7mwH-s34_XefdNp7CoDJHkwpbTUGiyJGgs,2037
+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=-YzxABVT5KJM1GgYLP3Z8X9YPfQzncOA9YnRJgNN6nA,7457
+fotolab-0.21.1.dist-info/entry_points.txt,sha256=mvw7AY_yZkIyjAxPtHNed9X99NZeLnMxEeAfEJUbrCM,44
+fotolab-0.21.1.dist-info/LICENSE.md,sha256=tGtFDwxWTjuR9syrJoSv1Hiffd2u8Tu8cYClfrXS_YU,31956
+fotolab-0.21.1.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
+fotolab-0.21.1.dist-info/METADATA,sha256=hH4mutSmdcXzZmt204mH0EdmgErcY18WK8KR9wtjw5o,10600
+fotolab-0.21.1.dist-info/RECORD,,

fotolab-0.21.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: flit 3.9.0
+Root-Is-Purelib: true
+Tag: py3-none-any

fotolab-0.21.1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+fotolab=fotolab.cli:main
+