experimental/cuda-ubi9/: hatch-nodejs-version-0.3.2 metadata and description

Hatch plugin for versioning from a package.json file

author_email	Angus Hollands <goosey15@gmail.com>
classifiers	Framework :: Hatch Programming Language :: Python :: 3.7 Programming Language :: Python :: 3.8 Programming Language :: Python :: 3.9 Programming Language :: Python :: 3.10 Programming Language :: Python :: 3.11
description_content_type	text/markdown
license	MIT
project_urls	Homepage, https://github.com/agoose77/hatch-nodejs-version Issue Tracker, https://github.com/agoose77/hatch-nodejs-version/issues Source Code, https://github.com/agoose77/hatch-nodejs-version
requires_dist	hatchling>=0.21.0
requires_python	>=3.7

File	Tox results	History
hatch_nodejs_version-0.3.2-py3-none-any.whl Size 8 KB Type Python Wheel Python 3		Uploaded to experimental/cuda-ubi9 by experimental 2024-05-30 12:32:34

hatch-nodejs-version

This package provides two Hatch plugins:

version source plugin that reads/writes the package version from the version field of the Node.js package.json file.
metadata hook plugin that reads PEP 621 metadata from the Node.js package.json file.

Table of Contents

Installation
Global dependency
Version source
Metadata hook
License

Global dependency

Ensure hatch-nodejs-version is defined within the build-system.requires field in your pyproject.toml file.

[build-system]
requires = ["hatchling", "hatch-nodejs-version"]
build-backend = "hatchling.build"

Version source

The version source plugin name is nodejs.

pyproject.toml
```
[tool.hatch.version]
source = "nodejs"
```
hatch.toml
```
[version]
source = "nodejs"
```

Semver

The semver specification defines the following version sections:

major
minor
patch
pre-release
build

Meanwhile, PEP 440 defines:

epoch
major
minor
patch
pre-release
post-release
dev-release

In order to ensure contentful round-trip support, and ensure semantic consistency between Node.js and Python, this plugin only accepts the common version parts:

major
minor
patch
pre-release

e.g. 1.2.3-rc0.

Note that where normalisation occurs, the round-trip result will differ. This can be avoided by careful choice of the delimeters e.g. -..

Version source options

Option	Type	Default	Description
`path`	`str`	`package.json`	Relative path to the `package.json` file.

Metadata hook

The metadata hook plugin name is nodejs.

pyproject.toml
```
[tool.hatch.metadata.hooks.nodejs]
```
hatch.toml
```
[metadata.hooks.nodejs]
```

Metadata hook options

Option	Type	Default	Description
`path`	`str`	`"package.json"`	Relative path to the `package.json` file.
`fields`	`list` of `str`	`None`	Optional list of `pyproject.toml` fields to take from their counterparts in `package.json`. If missing, take all of the available fields.
`contributors-as-maintainers`	`bool`	`True`	Whether contributors in `package.json` should be considered maintainers (otherwise, treat them as authors).
`bugs-label`	`str`	`"Bug Tracker"`	The key in the URLs table of `pyproject.toml` that is populated by the `bugs` field in `package.json`
`homepage-label`	`str`	`"Homepage"`	The key in the URLs table of `pyproject.toml` that is populated by the `homepage` field in `package.json`
`repository-label`	`str`	`"Repository"`	The key in the URLs table of `pyproject.toml` that is populated by the `repository` field in `package.json`

License

hatch-nodejs-version is distributed under the terms of the MIT license.

devpi