Skip to main content

A CLI for extracting python metadata from packages

Project description

mddj

Your DJ of MetaData.

PyPI - Version PyPI - Python Version


Table of Contents

Overview

A CLI for interacting with your python package metadata.

Supports multiple packaging backends via a uniform interface.

Installation

pipx install mddj

Usage

Env Vars

Build Isolation

MDDJ_ISOLATED_BUILDS=0 can be set to disable the (default) behavior using isolated build environments when getting package metadata.

This requires that you have installed all of the build-system requirements in to the current environment, but will be much faster.

Commands

See --help on each command for more detail on supported options.

mddj read requires-python

Show the requires_python field.

mddj read version

Show the version.

mddj write version

Write a new version to a target file, defaulting to a version = ... assignment in pyproject.toml.

Supports configuration via pyproject.toml.

Config

Configuration for mddj can only be read from a tool.mddj table in pyproject.toml. No other configuration sources are supported.

write_version

This setting controls how version information is written for mddj write version.

It takes a colon delimited string with two or three values. Either {mode}:{path}:{key} or {mode}:{key}.

The only supported {mode} is "assign" (for now). {path} defaults to pyproject.toml if omitted. {key} is the name of the attribute used to assign a value.

This defaults to assign: version.

For example, the following config can be used to target a __version__ attribute in an __init__.py file in a src-layout project:

[tool.mddj]
write_version = "assign: src/foopkg/__init__.py: __version__"

License

mddj is distributed under the terms of the MIT license.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mddj-0.0.4.tar.gz (8.1 kB view hashes)

Uploaded Source

Built Distribution

mddj-0.0.4-py3-none-any.whl (9.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page