https://github.com/agoose77/hatch-nodejs-version

Hatch plugin to read pyproject.toml metadata from package.json
https://github.com/agoose77/hatch-nodejs-version

hatch metadata nodejs npm plugin python version

Last synced: 6 days ago
JSON representation

Hatch plugin to read pyproject.toml metadata from package.json

• Host: GitHub
• URL: https://github.com/agoose77/hatch-nodejs-version
• Owner: agoose77
• License: mit
• Created: 2022-06-10T20:58:52.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2024-08-27T14:34:16.000Z (3 months ago)
• Last Synced: 2024-09-27T18:16:41.655Z (about 2 months ago)
• Topics: hatch, metadata, nodejs, npm, plugin, python, version
• Language: Python
• Homepage:
• Size: 72.3 KB
• Stars: 7
• Watchers: 3
• Forks: 6
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# hatch-nodejs-version

[![PyPI - Version](https://img.shields.io/pypi/v/hatch-nodejs-version.svg)](https://pypi.org/project/hatch-nodejs-version)

[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/hatch-nodejs-version.svg)](https://pypi.org/project/hatch-nodejs-version)

[![Hatch project](https://img.shields.io/badge/%F0%9F%A5%9A-Hatch-4051b5.svg)](https://github.com/pypa/hatch)

-----

This package provides two Hatch plugins:

- [version source plugin](https://hatch.pypa.io/latest/plugins/version-source/) that reads/writes the package version

  from the `version` field of the Node.js `package.json` file.

- [metadata hook plugin](https://hatch.pypa.io/latest/plugins/metadata-hook/) that reads PEP 621 metadata from the

  Node.js `package.json` file.

**Table of Contents**

- [Global dependency](#global-dependency)

- [Version source](#version-source)

- [Metadata hook](#metadata-hook)

- [License](#license)

## Global dependency

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

```toml

[build-system]

requires = ["hatchling", "hatch-nodejs-version"]

build-backend = "hatchling.build"

```

## Version source

The [version source plugin](https://hatch.pypa.io/latest/plugins/version-source/) name is `nodejs`.

- ***pyproject.toml***

    ```toml

    [tool.hatch.version]

    source = "nodejs"

    ```

- ***hatch.toml***

    ```toml

    [version]

    source = "nodejs"

    ```

### Semver

The semver specification defines the following version sections:

- `major`

- `minor`

- `patch`

- `pre-release`

- `build`

Meanwhile, [PEP 440](https://peps.python.org/pep-0440/#version-scheme) 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](https://hatch.pypa.io/dev/plugins/metadata-hook/reference/) name is `nodejs`.

- ***pyproject.toml***

    ```toml

    [tool.hatch.metadata.hooks.nodejs]

    ```

- ***hatch.toml***

    ```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](https://spdx.org/licenses/MIT.html) license.