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

Metadata hook

The metadata hook plugin name is nodejs.

• pyproject.toml

  [tool.hatch.metadata.hooks.nodejs]
  

• hatch.toml

  [metadata.hooks.nodejs]
  

Metadata hook options

License

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