Some set of poetry plugins
Project description
Poem Plugins
A set of plugins for Poetry.
How to use
Make sure you have Poetry version 1.2.0 or above. Read below for instructions to install it if you haven't.
Install Poem Plugins
Install this plugin to your Poetry:
$ poetry self add poem-plugins
Version Plugin
The poetry plugin for project versioning allows users to specify
the version of their project via the provider other than the default pyproject.toml file.
This can be useful for users who prefer to set the project version based on a git tag, for example.
Plugin can be configured via a section in the pyproject.toml file.
To use the plugin, you will need to add a section to your pyproject.toml
file that specifies the provider.
Here's an example of how you might configure the plugin in your pyproject.toml file:
[tool.poem-plugins.version]
provider = "git"
Likewise, you can specify a number of optional arguments to control the plugin behavior. Here are some of the arguments that you can use:
| Name | description | Default |
|---|---|---|
update_pyproject |
plugin will not only use version from provider for building, but save it in pyproject.toml |
false |
write_version_file |
plugin will create a file version.py inside a module, with version information |
false |
You can specify provider-specific settings in your configuration.
To specify provider-specific settings, you can use the tool.poem-plugins.version.{provider} section.
Here are some of the arguments that you can use for git provider:
| Name | description | Default |
|---|---|---|
version_prefix |
filter tags only starts with this prefix | v |
format |
plugin will use commit hash (long) or not (short) to build a project version | short |
Example:
[tool.poem-plugins.version.git]
version_prefix = "v"
format = "short"
To build your project, run the poetry build command.
The plugin will build the version via provider and use it to set the version for the project.
$ git tag -a v0.1 -m 'tag description'
$ poetry build
poem-plugins: Setting version to: 0.1.0
Building awesome_package (0.1.0)
- Building sdist
- Built awesome_package-0.1.0.tar.gz
- Building wheel
- Built awesome_package-0.1.0-py3-none-any.whl```
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file poem_plugins-0.15.11.tar.gz.
File metadata
- Download URL: poem_plugins-0.15.11.tar.gz
- Upload date:
- Size: 8.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.3.1 CPython/3.11.0 Linux/5.15.85-1-MANJARO
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 8dd58b292f53b9f6708f6172d6c5b6a06baa1786d318a82f69967ac0c5edc1b9 |
|
| MD5 | dbf3f3478bd304c574d9cdc1412be2be |
|
| BLAKE2b-256 | cba1f1decee04eb55af26ba1038ac57f1b59f970bbf6b5f2752b4034b95f144f |
File details
Details for the file poem_plugins-0.15.11-py3-none-any.whl.
File metadata
- Download URL: poem_plugins-0.15.11-py3-none-any.whl
- Upload date:
- Size: 9.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.3.1 CPython/3.11.0 Linux/5.15.85-1-MANJARO
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | c8cc77f6a0d1008f51abd0affa2b9466cf49bfc64467cd255073964bb64543f2 |
|
| MD5 | 2fc4b7c11f7c2c55b4dbf059997c0a89 |
|
| BLAKE2b-256 | feaae95ba9db8d4eeb9fe361574c467614538eab97c6abd26a024dd4d19bc851 |
