poetry-plugin-hook 0.0.0__tar.gz → 1.4.0__tar.gz

{poetry_plugin_hook-0.0.0 → poetry_plugin_hook-1.4.0}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2024 Christoph Dörrer
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2024 Christoph Dörrer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

poetry_plugin_hook-1.4.0/PKG-INFO

@@ -0,0 +1,287 @@
+Metadata-Version: 2.3
+Name: poetry-plugin-hook
+Version: 1.4.0
+Summary: poetry plugin to register wrapped commands to use as pre-commit-hooks
+License: MIT
+Keywords: poetry,pre-commit,plugin,hook
+Author: Christoph Dörrer
+Author-email: d-chris@web.de
+Requires-Python: >=3.9,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: cleo (>=2.1.0,<3.0.0)
+Requires-Dist: poetry (>=1.7.0)
+Project-URL: documentation, https://d-chris.github.io/poetry-plugin-hook
+Project-URL: repository, https://github.com/d-chris/poetry-plugin-hook
+Description-Content-Type: text/markdown
+
+# poetry-plugin-hook
+
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/poetry-plugin-hook)](https://pypi.org/project/poetry-plugin-hook/)
+[![PyPI - Version](https://img.shields.io/pypi/v/poetry-plugin-hook)](https://pypi.org/project/poetry-plugin-hook/)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/poetry-plugin-hook)](https://pypi.org/project/poetry-plugin-hook/)
+[![PyPI - License](https://img.shields.io/pypi/l/poetry-plugin-hook)](https://raw.githubusercontent.com/d-chris/poetry-plugin-hook/main/LICENSE)
+[![GitHub - Pytest](https://img.shields.io/github/actions/workflow/status/d-chris/poetry-plugin-hook/pytest.yml?logo=github&label=pytest)](https://github.com/d-chris/poetry-plugin-hook/actions/workflows/pytest.yml)
+[![GitHub - Page](https://img.shields.io/website?url=https%3A%2F%2Fd-chris.github.io%2Fpoetry-plugin-hook&up_message=pdoc&logo=github&label=documentation)](https://d-chris.github.io/poetry-plugin-hook)
+[![GitHub - Release](https://img.shields.io/github/v/tag/d-chris/poetry-plugin-hook?logo=github&label=github)](https://github.com/d-chris/poetry-plugin-hook)
+[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://raw.githubusercontent.com/d-chris/poetry-plugin-hook/main/.pre-commit-config.yaml)
+[![codecov](https://codecov.io/gh/d-chris/poetry-plugin-hook/graph/badge.svg?token=RNNV7TN8WZ)](https://codecov.io/gh/d-chris/poetry-plugin-hook)
+
+---
+
+[`poetry`](https://python-poetry.org/) plugin to register wrapped commands to use as [`pre-commit-hooks`](https://pre-commit.com/). all hook commands return zero on success and non-zero on failure.
+
+## install
+
+```cmd
+$ pip install poetry-plugin-hook
+```
+
+or with `poetry`
+
+> Especially on [Windows](https://python-poetry.org/docs/cli/#self), self commands that update or remove packages may be problematic.
+
+```cmd
+$ poetry self add poetry-plugin-hook
+```
+
+## hook bump
+
+Extends `poetry version` command, to also bump `__version__` strings in python files.
+
+```cmd
+$ poetry hook bump --help
+
+  Description:
+    Update the version in pyproject.toml and synchronize it into files.
+
+  Usage:
+    hook bump [options] [--] [<version>]
+
+  Arguments:
+    version                    The version number or the rule to update the version.
+
+  Options:
+    -f, --file=FILE            Specify the files to update the __version__ string. [default: ["__init__.py"]] (multiple values allowed)
+        --dry-run              Do not update pyproject.toml file
+        --next-phase           Increment the phase of the current version
+    -h, --help                 Display help for the given command. When no command is given display help for the list command.
+    -q, --quiet                Do not output any message.
+    -V, --version              Display this application version.
+        --ansi                 Force ANSI output.
+        --no-ansi              Disable ANSI output.
+    -n, --no-interaction       Do not ask any interactive question.
+        --no-plugins           Disables plugins.
+        --no-cache             Disables Poetry source caches.
+    -P, --project=PROJECT      Specify another path as the project root. All command-line arguments will be resolved relative to the current working directory.
+    -C, --directory=DIRECTORY  The working directory for the Poetry command (defaults to the current working directory). All command-line arguments will be resolved relative to the given directory.
+    -v|vv|vvv, --verbose       Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug.
+
+  Help:
+    Update the version from package and also bumps __version__ strings in any given file.
+
+        poetry hook bump --next-phase patch --file __init__.py
+
+    The new version should ideally be a valid semver string or a valid bump rule:
+    patch, minor, major, prepatch, preminor, premajor, prerelease.
+
+    If no next-phase or version is provied the version from the pyproject.toml file will be
+    synced into the files.
+```
+
+## hook latest
+
+Wrapper for `poetry show -o -T` command.
+
+Exit code represents the number of outdated packages.
+
+```cmd
+$ poetry hook latest --help
+
+  Description:
+    Check if all top-level dependencies are up-to-date.
+
+  Usage:
+    hook latest [options] [--] [<package>]
+
+  Arguments:
+    package                    The package to inspect
+
+  Options:
+        --without=WITHOUT      The dependency groups to ignore. (multiple values allowed)
+        --with=WITH            The optional dependency groups to include. (multiple values allowed)
+        --only=ONLY            The only dependency groups to include. (multiple values allowed)
+    -l, --latest               Show the latest version. (option is always True)
+    -o, --outdated             Show the latest version but only for packages that are outdated. (option is always True)
+    -T, --top-level            Show only top-level dependencies. (option is always True)
+    -h, --help                 Display help for the given command. When no command is given display help for the list command.
+    -q, --quiet                Do not output any message.
+    -V, --version              Display this application version.
+        --ansi                 Force ANSI output.
+        --no-ansi              Disable ANSI output.
+    -n, --no-interaction       Do not ask any interactive question.
+        --no-plugins           Disables plugins.
+        --no-cache             Disables Poetry source caches.
+    -P, --project=PROJECT      Specify another path as the project root. All command-line arguments will be resolved relative to the current working directory.
+    -C, --directory=DIRECTORY  The working directory for the Poetry command (defaults to the current working directory). All command-line arguments will be resolved relative to the given directory.
+    -v|vv|vvv, --verbose       Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug.
+
+  Help:
+    To check if all top-level dependencies of your package are up-to-date
+        poetry hook latest --only=main
+
+    If a specific package is outdated
+        poetry hook latest <package>
+```
+
+## hook sync
+
+Wrapper for `poetry install --sync` command.
+
+With `--exit` option, the command returns the corresponding value as exit code. With it's default `--exit=any` the sum of *installs*, *updates* and *removals* is returned.
+
+```cmd
+$ poetry hook sync --help
+
+  Description:
+    Synchronize the environment with the locked packages and the specified groups.
+
+  Usage:
+    hook sync [options]
+
+  Options:
+        --exit=EXIT            Specify the value to return as exitcode. choices=['any', 'installs', 'updates', 'removals'] [default: "any"]
+        --without=WITHOUT      The dependency groups to ignore. (multiple values allowed)
+        --with=WITH            The optional dependency groups to include. (multiple values allowed)
+        --only=ONLY            The only dependency groups to include. (multiple values allowed)
+        --sync                 Synchronize the environment with the locked packages and the specified groups. (Deprecated) (option is always True)
+        --no-root              Do not install the root package (the current project).
+        --no-directory         Do not install any directory path dependencies; useful to install dependencies without source code, e.g. for caching of Docker layers)
+        --dry-run              Output the operations but do not execute anything (implicitly enables --verbose).
+    -E, --extras=EXTRAS        Extra sets of dependencies to install. (multiple values allowed)
+        --all-extras           Install all extra dependencies.
+        --all-groups           Install dependencies from all groups.
+        --only-root            Exclude all dependencies.
+    -h, --help                 Display help for the given command. When no command is given display help for the list command.
+    -q, --quiet                Do not output any message.
+    -V, --version              Display this application version.
+        --ansi                 Force ANSI output.
+        --no-ansi              Disable ANSI output.
+    -n, --no-interaction       Do not ask any interactive question.
+        --no-plugins           Disables plugins.
+        --no-cache             Disables Poetry source caches.
+    -P, --project=PROJECT      Specify another path as the project root. All command-line arguments will be resolved relative to the current working directory.
+    -C, --directory=DIRECTORY  The working directory for the Poetry command (defaults to the current working directory). All command-line arguments will be resolved relative to the given directory.
+    -v|vv|vvv, --verbose       Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug.
+
+  Help:
+    To check if your environment is synchronized without making any changes
+        poetry hook sync --dry-run
+```
+
+## pre-commit-config
+
+Add the following to your `.pre-commit-config.yaml` file.
+
+```yaml
+default_install_hook_types:
+  - pre-commit
+  - pre-push
+default_stages:
+  - pre-commit
+repos:
+  - repo: https://github.com/d-chris/poetry-plugin-hook
+    rev: v1.2.1
+    hooks:
+      - id: poetry-hook-bump
+      - id: poetry-hook-latest
+        args: ["--only=main"]
+      - id: poetry-hook-sync
+        args: ["--dry-run"]
+```
+
+### usage
+
+1. Make sure pre-commit is installed, see [official documentation](https://pre-commit.com/#installation).
+  ```cmd
+  $ pre-commit --version
+
+    pre-commit 3.7.1
+  ```
+2. `cd` into your project and register hooks and install them. this may take a while.
+  ```cmd
+  $ pre-commit install --install-hooks
+
+    pre-commit installed at .git\hooks\pre-commit
+    pre-commit installed at .git\hooks\pre-push
+  ```
+3. Test the pre-push hook.
+  ```cmd
+  $ pre-commit run poetry-hook-latest --all-files --hook-stage pre-push
+
+    poetry-hook-latest.......................................................Failed
+    - hook id: poetry-hook-latest
+    - exit code: 1
+
+    pytest-cov 5.0.0 6.0.0 Pytest plugin for measuring coverage.
+  ```
+4. Test the pre-commit hooks.
+  ```cmd
+  $ pre-commit run poetry-hook-sync --all-files
+
+    poetry-hook-sync.........................................................Failed
+    - hook id: poetry-hook-sync
+    - exit code: 1
+
+    Installing dependencies from lock file
+
+    Package operations: 0 installs, 1 update, 0 removals
+
+      - Downgrading pytest-cov (6.0.0 -> 5.0.0)
+
+    Installing the current project: poetry-plugin-hook (0.0.0)
+  ```
+
+## pre-commit-hooks
+
+```yaml
+- id: poetry-hook-bump
+  name: poetry-hook-bump
+  description: Bump the version of the package and also in files.
+  entry: poetry hook bump
+  language: system
+  pass_filenames: false
+  always_run: true
+  stages: [pre-push]
+- id: poetry-hook-latest
+  name: poetry-hook-latest
+  description: Check if all top-level dependencies are up-to-date.
+  entry: poetry hook latest
+  language: system
+  pass_filenames: false
+  always_run: true
+  stages: [pre-push]
+- id: poetry-hook-sync
+  name: poetry-hook-sync
+  description: Synchronize the environment with the locked packages and the specified groups.
+  entry: poetry hook sync
+  language: system
+  pass_filenames: false
+  files: ^(.*/)?(poetry\.lock|pyproject\.toml)$
+```
+
+## Dependencies
+
+[![PyPI - cleo](https://img.shields.io/pypi/v/cleo?logo=pypi&logoColor=white&label=cleo)](https://pypi.org/project/cleo/)
+[![PyPI - poetry](https://img.shields.io/pypi/v/poetry?logo=poetry&logoColor=white&label=poetry)](https://pypi.org/project/poetry/)
+
+---
+

poetry_plugin_hook-1.4.0/README.md

@@ -0,0 +1,261 @@
+# poetry-plugin-hook
+
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/poetry-plugin-hook)](https://pypi.org/project/poetry-plugin-hook/)
+[![PyPI - Version](https://img.shields.io/pypi/v/poetry-plugin-hook)](https://pypi.org/project/poetry-plugin-hook/)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/poetry-plugin-hook)](https://pypi.org/project/poetry-plugin-hook/)
+[![PyPI - License](https://img.shields.io/pypi/l/poetry-plugin-hook)](https://raw.githubusercontent.com/d-chris/poetry-plugin-hook/main/LICENSE)
+[![GitHub - Pytest](https://img.shields.io/github/actions/workflow/status/d-chris/poetry-plugin-hook/pytest.yml?logo=github&label=pytest)](https://github.com/d-chris/poetry-plugin-hook/actions/workflows/pytest.yml)
+[![GitHub - Page](https://img.shields.io/website?url=https%3A%2F%2Fd-chris.github.io%2Fpoetry-plugin-hook&up_message=pdoc&logo=github&label=documentation)](https://d-chris.github.io/poetry-plugin-hook)
+[![GitHub - Release](https://img.shields.io/github/v/tag/d-chris/poetry-plugin-hook?logo=github&label=github)](https://github.com/d-chris/poetry-plugin-hook)
+[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://raw.githubusercontent.com/d-chris/poetry-plugin-hook/main/.pre-commit-config.yaml)
+[![codecov](https://codecov.io/gh/d-chris/poetry-plugin-hook/graph/badge.svg?token=RNNV7TN8WZ)](https://codecov.io/gh/d-chris/poetry-plugin-hook)
+
+---
+
+[`poetry`](https://python-poetry.org/) plugin to register wrapped commands to use as [`pre-commit-hooks`](https://pre-commit.com/). all hook commands return zero on success and non-zero on failure.
+
+## install
+
+```cmd
+$ pip install poetry-plugin-hook
+```
+
+or with `poetry`
+
+> Especially on [Windows](https://python-poetry.org/docs/cli/#self), self commands that update or remove packages may be problematic.
+
+```cmd
+$ poetry self add poetry-plugin-hook
+```
+
+## hook bump
+
+Extends `poetry version` command, to also bump `__version__` strings in python files.
+
+```cmd
+$ poetry hook bump --help
+
+  Description:
+    Update the version in pyproject.toml and synchronize it into files.
+
+  Usage:
+    hook bump [options] [--] [<version>]
+
+  Arguments:
+    version                    The version number or the rule to update the version.
+
+  Options:
+    -f, --file=FILE            Specify the files to update the __version__ string. [default: ["__init__.py"]] (multiple values allowed)
+        --dry-run              Do not update pyproject.toml file
+        --next-phase           Increment the phase of the current version
+    -h, --help                 Display help for the given command. When no command is given display help for the list command.
+    -q, --quiet                Do not output any message.
+    -V, --version              Display this application version.
+        --ansi                 Force ANSI output.
+        --no-ansi              Disable ANSI output.
+    -n, --no-interaction       Do not ask any interactive question.
+        --no-plugins           Disables plugins.
+        --no-cache             Disables Poetry source caches.
+    -P, --project=PROJECT      Specify another path as the project root. All command-line arguments will be resolved relative to the current working directory.
+    -C, --directory=DIRECTORY  The working directory for the Poetry command (defaults to the current working directory). All command-line arguments will be resolved relative to the given directory.
+    -v|vv|vvv, --verbose       Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug.
+
+  Help:
+    Update the version from package and also bumps __version__ strings in any given file.
+
+        poetry hook bump --next-phase patch --file __init__.py
+
+    The new version should ideally be a valid semver string or a valid bump rule:
+    patch, minor, major, prepatch, preminor, premajor, prerelease.
+
+    If no next-phase or version is provied the version from the pyproject.toml file will be
+    synced into the files.
+```
+
+## hook latest
+
+Wrapper for `poetry show -o -T` command.
+
+Exit code represents the number of outdated packages.
+
+```cmd
+$ poetry hook latest --help
+
+  Description:
+    Check if all top-level dependencies are up-to-date.
+
+  Usage:
+    hook latest [options] [--] [<package>]
+
+  Arguments:
+    package                    The package to inspect
+
+  Options:
+        --without=WITHOUT      The dependency groups to ignore. (multiple values allowed)
+        --with=WITH            The optional dependency groups to include. (multiple values allowed)
+        --only=ONLY            The only dependency groups to include. (multiple values allowed)
+    -l, --latest               Show the latest version. (option is always True)
+    -o, --outdated             Show the latest version but only for packages that are outdated. (option is always True)
+    -T, --top-level            Show only top-level dependencies. (option is always True)
+    -h, --help                 Display help for the given command. When no command is given display help for the list command.
+    -q, --quiet                Do not output any message.
+    -V, --version              Display this application version.
+        --ansi                 Force ANSI output.
+        --no-ansi              Disable ANSI output.
+    -n, --no-interaction       Do not ask any interactive question.
+        --no-plugins           Disables plugins.
+        --no-cache             Disables Poetry source caches.
+    -P, --project=PROJECT      Specify another path as the project root. All command-line arguments will be resolved relative to the current working directory.
+    -C, --directory=DIRECTORY  The working directory for the Poetry command (defaults to the current working directory). All command-line arguments will be resolved relative to the given directory.
+    -v|vv|vvv, --verbose       Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug.
+
+  Help:
+    To check if all top-level dependencies of your package are up-to-date
+        poetry hook latest --only=main
+
+    If a specific package is outdated
+        poetry hook latest <package>
+```
+
+## hook sync
+
+Wrapper for `poetry install --sync` command.
+
+With `--exit` option, the command returns the corresponding value as exit code. With it's default `--exit=any` the sum of *installs*, *updates* and *removals* is returned.
+
+```cmd
+$ poetry hook sync --help
+
+  Description:
+    Synchronize the environment with the locked packages and the specified groups.
+
+  Usage:
+    hook sync [options]
+
+  Options:
+        --exit=EXIT            Specify the value to return as exitcode. choices=['any', 'installs', 'updates', 'removals'] [default: "any"]
+        --without=WITHOUT      The dependency groups to ignore. (multiple values allowed)
+        --with=WITH            The optional dependency groups to include. (multiple values allowed)
+        --only=ONLY            The only dependency groups to include. (multiple values allowed)
+        --sync                 Synchronize the environment with the locked packages and the specified groups. (Deprecated) (option is always True)
+        --no-root              Do not install the root package (the current project).
+        --no-directory         Do not install any directory path dependencies; useful to install dependencies without source code, e.g. for caching of Docker layers)
+        --dry-run              Output the operations but do not execute anything (implicitly enables --verbose).
+    -E, --extras=EXTRAS        Extra sets of dependencies to install. (multiple values allowed)
+        --all-extras           Install all extra dependencies.
+        --all-groups           Install dependencies from all groups.
+        --only-root            Exclude all dependencies.
+    -h, --help                 Display help for the given command. When no command is given display help for the list command.
+    -q, --quiet                Do not output any message.
+    -V, --version              Display this application version.
+        --ansi                 Force ANSI output.
+        --no-ansi              Disable ANSI output.
+    -n, --no-interaction       Do not ask any interactive question.
+        --no-plugins           Disables plugins.
+        --no-cache             Disables Poetry source caches.
+    -P, --project=PROJECT      Specify another path as the project root. All command-line arguments will be resolved relative to the current working directory.
+    -C, --directory=DIRECTORY  The working directory for the Poetry command (defaults to the current working directory). All command-line arguments will be resolved relative to the given directory.
+    -v|vv|vvv, --verbose       Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug.
+
+  Help:
+    To check if your environment is synchronized without making any changes
+        poetry hook sync --dry-run
+```
+
+## pre-commit-config
+
+Add the following to your `.pre-commit-config.yaml` file.
+
+```yaml
+default_install_hook_types:
+  - pre-commit
+  - pre-push
+default_stages:
+  - pre-commit
+repos:
+  - repo: https://github.com/d-chris/poetry-plugin-hook
+    rev: v1.2.1
+    hooks:
+      - id: poetry-hook-bump
+      - id: poetry-hook-latest
+        args: ["--only=main"]
+      - id: poetry-hook-sync
+        args: ["--dry-run"]
+```
+
+### usage
+
+1. Make sure pre-commit is installed, see [official documentation](https://pre-commit.com/#installation).
+  ```cmd
+  $ pre-commit --version
+
+    pre-commit 3.7.1
+  ```
+2. `cd` into your project and register hooks and install them. this may take a while.
+  ```cmd
+  $ pre-commit install --install-hooks
+
+    pre-commit installed at .git\hooks\pre-commit
+    pre-commit installed at .git\hooks\pre-push
+  ```
+3. Test the pre-push hook.
+  ```cmd
+  $ pre-commit run poetry-hook-latest --all-files --hook-stage pre-push
+
+    poetry-hook-latest.......................................................Failed
+    - hook id: poetry-hook-latest
+    - exit code: 1
+
+    pytest-cov 5.0.0 6.0.0 Pytest plugin for measuring coverage.
+  ```
+4. Test the pre-commit hooks.
+  ```cmd
+  $ pre-commit run poetry-hook-sync --all-files
+
+    poetry-hook-sync.........................................................Failed
+    - hook id: poetry-hook-sync
+    - exit code: 1
+
+    Installing dependencies from lock file
+
+    Package operations: 0 installs, 1 update, 0 removals
+
+      - Downgrading pytest-cov (6.0.0 -> 5.0.0)
+
+    Installing the current project: poetry-plugin-hook (0.0.0)
+  ```
+
+## pre-commit-hooks
+
+```yaml
+- id: poetry-hook-bump
+  name: poetry-hook-bump
+  description: Bump the version of the package and also in files.
+  entry: poetry hook bump
+  language: system
+  pass_filenames: false
+  always_run: true
+  stages: [pre-push]
+- id: poetry-hook-latest
+  name: poetry-hook-latest
+  description: Check if all top-level dependencies are up-to-date.
+  entry: poetry hook latest
+  language: system
+  pass_filenames: false
+  always_run: true
+  stages: [pre-push]
+- id: poetry-hook-sync
+  name: poetry-hook-sync
+  description: Synchronize the environment with the locked packages and the specified groups.
+  entry: poetry hook sync
+  language: system
+  pass_filenames: false
+  files: ^(.*/)?(poetry\.lock|pyproject\.toml)$
+```
+
+## Dependencies
+
+[![PyPI - cleo](https://img.shields.io/pypi/v/cleo?logo=pypi&logoColor=white&label=cleo)](https://pypi.org/project/cleo/)
+[![PyPI - poetry](https://img.shields.io/pypi/v/poetry?logo=poetry&logoColor=white&label=poetry)](https://pypi.org/project/poetry/)
+
+---

{poetry_plugin_hook-0.0.0 → poetry_plugin_hook-1.4.0}/poetry_plugin_hook/__init__.py

@@ -1,17 +1,33 @@
-from poetry.plugins.application_plugin import ApplicationPlugin
-
-from .latest import LatestCommand
-from .sync import SyncCommand
-
-
-class HookPlugin(ApplicationPlugin):
-    def activate(self, application):
-
-        application.command_loader.register_factory(
-            LatestCommand.name,
-            lambda: LatestCommand(),
-        )
-        application.command_loader.register_factory(
-            SyncCommand.name,
-            lambda: SyncCommand(),
-        )
+"""
+.. include:: ../README.md
+"""
+
+from poetry.plugins.application_plugin import ApplicationPlugin
+
+from poetry_plugin_hook.bump import BumpCommand
+from poetry_plugin_hook.latest import LatestCommand
+from poetry_plugin_hook.sync import SyncCommand
+
+
+class HookPlugin(ApplicationPlugin):
+    def activate(self, application):
+
+        application.command_loader.register_factory(
+            BumpCommand.name,
+            lambda: BumpCommand(),
+        )
+        application.command_loader.register_factory(
+            LatestCommand.name,
+            lambda: LatestCommand(),
+        )
+        application.command_loader.register_factory(
+            SyncCommand.name,
+            lambda: SyncCommand(),
+        )
+
+
+__all__ = [
+    "BumpCommand",
+    "LatestCommand",
+    "SyncCommand",
+]