fotolab 0.16.14__tar.gz → 0.16.17__tar.gz

{fotolab-0.16.14 → fotolab-0.16.17}/.pre-commit-config.yaml

@@ -107,7 +107,7 @@ repos:
           - --disable=R0801,W0212
 
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.11.1
+    rev: v1.11.2
     hooks:
       - id: mypy
         exclude: docs/

{fotolab-0.16.14 → fotolab-0.16.17}/.python-version

@@ -2,4 +2,4 @@
 3.9.19
 3.10.14
 3.11.9
-3.12.4
+3.12.5

{fotolab-0.16.14 → fotolab-0.16.17}/CHANGELOG.md

@@ -7,6 +7,26 @@ and this project adheres to [0-based versioning](https://0ver.org/).
 
 ## [Unreleased]
 
+## v0.16.17 (2024-09-08)
+
+- Add `posargs` to most sessions in `nox`
+- Bump deps
+- Update comment on running specific task in `lint` session in `nox`
+- Update missing deps and `nox` sessions in contributing doc
+
+## v0.16.16 (2024-09-01)
+
+- Bump deps and `pre-commit` hooks
+- Fix `readme` session in `nox` cannot run due to missing deps
+- Install all deps in all `nox` session
+
+## v0.16.15 (2024-08-25)
+
+- Bump deps and `pyenv` versions
+- Refactor updating files in `release` session
+- Resolve `mypy` warnings
+- Update all subcommands in readme
+
 ## v0.16.14 (2024-08-18)
 
 - Add `release` session in `nox` to bump release

{fotolab-0.16.14 → fotolab-0.16.17}/CONTRIBUTING.md

@@ -31,7 +31,7 @@ pyenv install $(cat .python-version)
 Install necessary packages:
 
 ```console
-python -m pip install --upgrade pip pipenv
+python -m pip install --upgrade pip pipenv nox
 pipenv install --dev
 ```
 
@@ -50,7 +50,7 @@ nox -l
 ```console
 ...
 * deps -> Update pre-commit hooks and deps.
-* lint -> Run pre-commit linter.
+* lint -> Run pre-commit tasks.
 * test-3.8 -> Run test.
 * test-3.9 -> Run test.
 * test-3.10 -> Run test.
@@ -59,6 +59,7 @@ nox -l
 * cov -> Run test coverage.
 * doc -> Build doc with sphinx.
 * readme -> Update console help menu to readme.
+* release -> Bump release.
 
 sessions marked with * are selected, sessions marked with - are skipped.
 ```

{fotolab-0.16.14 → fotolab-0.16.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: fotolab
-Version: 0.16.14
+Version: 0.16.17
 Summary: A console program that manipulate images.
 Keywords: photography,photo
 Author-email: Kian-Meng Ang <kianmeng@cpan.org>
@@ -113,7 +113,7 @@ usage: fotolab animate [-h] [-f FORMAT] [-d DURATION] [-l LOOP]
 positional arguments:
   IMAGE_FILENAMES       set the image filenames
 
-optional arguments:
+options:
   -h, --help            show this help message and exit
   -f FORMAT, --format FORMAT
                         set the image format (default: 'gif')
@@ -138,7 +138,7 @@ usage: fotolab auto [-h] IMAGE_FILENAMES [IMAGE_FILENAMES ...]
 positional arguments:
   IMAGE_FILENAMES  set the image filename
 
-optional arguments:
+options:
   -h, --help       show this help message and exit
 ```
 
@@ -160,7 +160,7 @@ usage: fotolab border [-h] [-c COLOR] [-w WIDTH] [-wt WIDTH] [-wr WIDTH]
 positional arguments:
   IMAGE_FILENAMES       set the image filenames
 
-optional arguments:
+options:
   -h, --help            show this help message and exit
   -c COLOR, --color COLOR
                         set the color of border (default: 'black')
@@ -192,7 +192,7 @@ usage: fotolab contrast [-h] [-c CUTOFF] IMAGE_FILENAMES [IMAGE_FILENAMES ...]
 positional arguments:
   IMAGE_FILENAMES       set the image filename
 
-optional arguments:
+options:
   -h, --help            show this help message and exit
   -c CUTOFF, --cutoff CUTOFF
                         set the percentage of lightest or darkest pixels to
@@ -215,7 +215,7 @@ usage: fotolab info [-h] IMAGE_FILENAME
 positional arguments:
   IMAGE_FILENAME  set the image filename
 
-optional arguments:
+options:
   -h, --help      show this help message and exit
 ```
 
@@ -235,7 +235,7 @@ usage: fotolab rotate [-h] IMAGE_FILENAMES [IMAGE_FILENAMES ...]
 positional arguments:
   IMAGE_FILENAMES  set the image filenames
 
-optional arguments:
+options:
   -h, --help       show this help message and exit
 ```
 
@@ -255,7 +255,7 @@ usage: fotolab montage [-h] IMAGE_FILENAMES [IMAGE_FILENAMES ...]
 positional arguments:
   IMAGE_FILENAMES  set the image filenames
 
-optional arguments:
+options:
   -h, --help       show this help message and exit
 ```
 
@@ -276,7 +276,7 @@ usage: fotolab resize [-h] [-wh WIDTH | -ht HEIGHT]
 positional arguments:
   IMAGE_FILENAMES       set the image filename
 
-optional arguments:
+options:
   -h, --help            show this help message and exit
   -wh WIDTH, --width WIDTH
                         set the width of the image (default: '600')
@@ -301,7 +301,7 @@ usage: fotolab sharpen [-h] [-r RADIUS] [-p PERCENT] [-t THRESHOLD]
 positional arguments:
   IMAGE_FILENAMES       set the image filenames
 
-optional arguments:
+options:
   -h, --help            show this help message and exit
   -r RADIUS, --radius RADIUS
                         set the radius or size of edges (default: '1')
@@ -333,7 +333,7 @@ usage: fotolab watermark [-h] [-t WATERMARK_TEXT]
 positional arguments:
   IMAGE_FILENAMES       set the image filenames
 
-optional arguments:
+options:
   -h, --help            show this help message and exit
   -t WATERMARK_TEXT, --text WATERMARK_TEXT
                         set the watermark text (default: 'kianmeng.org')

{fotolab-0.16.14 → fotolab-0.16.17}/Pipfile.lock

@@ -139,11 +139,11 @@
         },
         "certifi": {
             "hashes": [
-                "sha256:5a1e7645bc0ec61a09e26c36f6106dd4cf40c6db3a1fb6352b0244e7fb057c7b",
-                "sha256:c198e21b1289c2ab85ee4e67bb4b4ef3ead0892059901a8d5b622f24a1101e90"
+                "sha256:922820b53db7a7257ffbda3f597266d435245903d80737e34f8a45ff3e3230d8",
+                "sha256:bec941d2aa8195e248a60b31ff9f0558284cf01a52591ceda73ea9afffd69fd9"
             ],
             "markers": "python_version >= '3.6'",
-            "version": "==2024.7.4"
+            "version": "==2024.8.30"
         },
         "cfgv": {
             "hashes": [
@@ -444,11 +444,11 @@
         },
         "idna": {
             "hashes": [
-                "sha256:028ff3aadf0609c1fd278d8ea3089299412a7a8b9bd005dd08b9f8285bcb5cfc",
-                "sha256:82fee1fc78add43492d3a1898bfa6d8a904cc97d8427f683ed8e798d07761aa0"
+                "sha256:050b4e5baadcd44d760cedbd2b8e639f2ff89bbc7a5730fcc662954303377aac",
+                "sha256:d838c2c0ed6fced7693d5e8ab8e734d5f8fda53a039c0164afb0b82e771e3603"
             ],
-            "markers": "python_version >= '3.5'",
-            "version": "==3.7"
+            "markers": "python_version >= '3.6'",
+            "version": "==3.8"
         },
         "imagesize": {
             "hashes": [
@@ -460,12 +460,12 @@
         },
         "importlib-metadata": {
             "hashes": [
-                "sha256:11901fa0c2f97919b288679932bb64febaeacf289d18ac84dd68cb2e74213369",
-                "sha256:72e8d4399996132204f9a16dcc751af254a48f8d1b20b9ff0f98d4a8f901e73d"
+                "sha256:66f342cc6ac9818fc6ff340576acd24d65ba0b3efabb2b4ac08b598965a4a2f1",
+                "sha256:9a547d3bc3608b025f93d403fdd1aae741c24fbb8314df4b155675742ce303c5"
             ],
             "index": "pypi",
             "markers": "python_version >= '3.8'",
-            "version": "==8.2.0"
+            "version": "==8.4.0"
         },
         "iniconfig": {
             "hashes": [
@@ -887,12 +887,12 @@
         },
         "sphinx-autodoc-typehints": {
             "hashes": [
-                "sha256:b7058e8c5831e5598afca1a78fda0695d3291388d954464a6e480c36198680c0",
-                "sha256:fde3d888949bd0a91207cf1e54afda58121dbb4bf1f183d0cc78a0826654c974"
+                "sha256:8f8281654ddf5709875429b7120d367f4edee39a131e13d5806e4f779a81bf0f",
+                "sha256:c9774d47e7d304cf975e073df49ebf19763dca94ac0295e7013b522b26cb18de"
             ],
             "index": "pypi",
-            "markers": "python_version >= '3.9'",
-            "version": "==2.2.3"
+            "markers": "python_version >= '3.10'",
+            "version": "==2.4.0"
         },
         "sphinx-copybutton": {
             "hashes": [
@@ -978,11 +978,11 @@
         },
         "zipp": {
             "hashes": [
-                "sha256:0145e43d89664cfe1a2e533adc75adafed82fe2da404b4bbb6b026c0157bdb31",
-                "sha256:58da6168be89f0be59beb194da1250516fdaa062ccebd30127ac65d30045e10d"
+                "sha256:9960cd8967c8f85a56f920d5d507274e74f9ff813a0ab8889a5b5be2daf44064",
+                "sha256:c22b14cc4763c5a5b04134207736c107db42e9d3ef2d9779d465f5f1bcba572b"
             ],
             "markers": "python_version >= '3.8'",
-            "version": "==3.20.0"
+            "version": "==3.20.1"
         }
     }
 }

{fotolab-0.16.14 → fotolab-0.16.17}/README.md

@@ -91,7 +91,7 @@ usage: fotolab animate [-h] [-f FORMAT] [-d DURATION] [-l LOOP]
 positional arguments:
   IMAGE_FILENAMES       set the image filenames
 
-optional arguments:
+options:
   -h, --help            show this help message and exit
   -f FORMAT, --format FORMAT
                         set the image format (default: 'gif')
@@ -116,7 +116,7 @@ usage: fotolab auto [-h] IMAGE_FILENAMES [IMAGE_FILENAMES ...]
 positional arguments:
   IMAGE_FILENAMES  set the image filename
 
-optional arguments:
+options:
   -h, --help       show this help message and exit
 ```
 
@@ -138,7 +138,7 @@ usage: fotolab border [-h] [-c COLOR] [-w WIDTH] [-wt WIDTH] [-wr WIDTH]
 positional arguments:
   IMAGE_FILENAMES       set the image filenames
 
-optional arguments:
+options:
   -h, --help            show this help message and exit
   -c COLOR, --color COLOR
                         set the color of border (default: 'black')
@@ -170,7 +170,7 @@ usage: fotolab contrast [-h] [-c CUTOFF] IMAGE_FILENAMES [IMAGE_FILENAMES ...]
 positional arguments:
   IMAGE_FILENAMES       set the image filename
 
-optional arguments:
+options:
   -h, --help            show this help message and exit
   -c CUTOFF, --cutoff CUTOFF
                         set the percentage of lightest or darkest pixels to
@@ -193,7 +193,7 @@ usage: fotolab info [-h] IMAGE_FILENAME
 positional arguments:
   IMAGE_FILENAME  set the image filename
 
-optional arguments:
+options:
   -h, --help      show this help message and exit
 ```
 
@@ -213,7 +213,7 @@ usage: fotolab rotate [-h] IMAGE_FILENAMES [IMAGE_FILENAMES ...]
 positional arguments:
   IMAGE_FILENAMES  set the image filenames
 
-optional arguments:
+options:
   -h, --help       show this help message and exit
 ```
 
@@ -233,7 +233,7 @@ usage: fotolab montage [-h] IMAGE_FILENAMES [IMAGE_FILENAMES ...]
 positional arguments:
   IMAGE_FILENAMES  set the image filenames
 
-optional arguments:
+options:
   -h, --help       show this help message and exit
 ```
 
@@ -254,7 +254,7 @@ usage: fotolab resize [-h] [-wh WIDTH | -ht HEIGHT]
 positional arguments:
   IMAGE_FILENAMES       set the image filename
 
-optional arguments:
+options:
   -h, --help            show this help message and exit
   -wh WIDTH, --width WIDTH
                         set the width of the image (default: '600')
@@ -279,7 +279,7 @@ usage: fotolab sharpen [-h] [-r RADIUS] [-p PERCENT] [-t THRESHOLD]
 positional arguments:
   IMAGE_FILENAMES       set the image filenames
 
-optional arguments:
+options:
   -h, --help            show this help message and exit
   -r RADIUS, --radius RADIUS
                         set the radius or size of edges (default: '1')
@@ -311,7 +311,7 @@ usage: fotolab watermark [-h] [-t WATERMARK_TEXT]
 positional arguments:
   IMAGE_FILENAMES       set the image filenames
 
-optional arguments:
+options:
   -h, --help            show this help message and exit
   -t WATERMARK_TEXT, --text WATERMARK_TEXT
                         set the watermark text (default: 'kianmeng.org')

{fotolab-0.16.14 → fotolab-0.16.17}/fotolab/__init__.py

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

{fotolab-0.16.14 → fotolab-0.16.17}/noxfile.py

@@ -13,6 +13,8 @@
 # You should have received a copy of the GNU General Public License
 # along with this program.  If not, see <https://www.gnu.org/licenses/>.
 
+# mypy: disable-error-code="attr-defined"
+
 """Nox configuration."""
 
 import ast
@@ -33,7 +35,12 @@ def deps(session: nox.Session) -> None:
 @nox.session()
 @nox.session(python="3.12")
 def lint(session: nox.Session) -> None:
-    """Run pre-commit linter."""
+    """Run pre-commit tasks.
+
+    For running selected task within pre-commit:
+
+        nox -s lint -- pylint
+    """
     session.install("pre-commit")
     session.run("pre-commit", "run", "--all-files", *session.posargs)
 
@@ -60,6 +67,7 @@ def cov(session: nox.Session) -> None:
         "--cov",
         "--cov-report=term",
         "--cov-report=html",
+        *session.posargs,
     )
 
 
@@ -67,7 +75,9 @@ def cov(session: nox.Session) -> None:
 def doc(session: nox.Session) -> None:
     """Build doc with sphinx."""
     _pipenv_install(session)
-    session.run("sphinx-build", "docs/source/", "docs/build/html")
+    session.run(
+        "sphinx-build", "docs/source/", "docs/build/html", *session.posargs
+    )
 
 
 @nox.session(python="3.12")
@@ -82,6 +92,27 @@ def readme(session: nox.Session) -> None:
         marker = content.split("<!--help !-->")[1]
         readme_md = content.replace(marker, help_codeblock)
 
+        for subcommand in [
+            "animate",
+            "auto",
+            "border",
+            "contrast",
+            "info",
+            "resize",
+            "rotate",
+            "montage",
+            "sharpen",
+            "watermark",
+            "env",
+        ]:
+            help_message = session.run(
+                "fotolab", subcommand, "-h", silent=True
+            )
+            help_codeblock = f"\n\n```console\n{help_message}```\n\n"
+
+            marker = readme_md.split(f"<!--help-{subcommand} !-->")[1]
+            readme_md = readme_md.replace(marker, help_codeblock)
+
         f.seek(0)
         f.write(readme_md)
         f.truncate()
@@ -109,26 +140,30 @@ def release(_session: nox.Session) -> None:
             f"{before_version.minor}."
             f"{before_version.micro + 1}"
         )
+        _search_and_replace(
+            "fotolab/__init__.py", str(before_version), after_version
+        )
 
-    with open("fotolab/__init__.py", "r+", encoding="utf8") as f:
-        content = f.read()
-        content = content.replace(str(before_version), after_version)
-        f.seek(0)
-        f.write(content)
-        f.truncate()
-
-    with open("CHANGELOG.md", "r+", encoding="utf8") as f:
         date = datetime.date.today().strftime("%Y-%m-%d")
         before_header = "## [Unreleased]\n\n"
         after_header = f"## [Unreleased]\n\n## v{after_version} ({date})\n\n"
+        _search_and_replace("CHANGELOG.md", before_header, after_header)
 
+
+def _pipenv_install(session: nox.Session) -> None:
+    session.install("pipenv")
+    session.run(
+        "pipenv",
+        "install",
+        "--dev",
+        env={"PIPENV_VERBOSITY": "-1"}
+    )
+
+
+def _search_and_replace(file, search, replace) -> None:
+    with open(file, "r+", encoding="utf8") as f:
         content = f.read()
-        content = content.replace(before_header, after_header)
+        content = content.replace(search, replace)
         f.seek(0)
         f.write(content)
         f.truncate()
-
-
-def _pipenv_install(session: nox.Session) -> None:
-    session.install("pipenv")
-    session.run("pipenv", "install", "--dev", env={"PIPENV_VERBOSITY": "-1"})