https://github.com/uranusjr/gerb

Override dependencies in Python wheels
https://github.com/uranusjr/gerb

Last synced: about 1 month ago
JSON representation

Override dependencies in Python wheels

• Host: GitHub
• URL: https://github.com/uranusjr/gerb
• Owner: uranusjr
• Created: 2020-10-14T10:26:02.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2020-10-14T11:20:44.000Z (about 4 years ago)
• Last Synced: 2024-10-14T19:41:46.712Z (3 months ago)
• Language: Python
• Homepage:
• Size: 1000 Bytes
• Stars: 3
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# GERB: Override dependencies in Python wheels

GERB downloads Python wheels, overrides dependency information in them, and

store the overriden artifacts in a specified directory (aka "wheelhouse").

Those wheels can then be installed with:

    pip install --find-links= ...

## Specification

Specify packages to override in a TOML file named ``gerb.toml``:

```toml

[gerb]

# Relative to the directory containing gerb.toml.

wheelhouse = "./wheelhouse"

# Specify alternative PEP 503 repository URLs to use.

# This is the default value.

repositories = ["https://pypi.org/simple"]

# Wheels generated by GERB use this as the "local version" to

# distinguish themselves from the publicly-available ones.

# Change this version when you update the override information.

# Read more about local versions in PEP 440.

override-version = "1"

[[gerb.packages]]

requirement = "pkg-a ==1.0.0"

[gerb.package.override-dependencies]

dep-a = "~=3.0"  # Override dep-a to use this.

dep-b = "@ https://example.com/dep-b.zip ; os_name != 'nt'"

# Key and value are joined as a PEP 508 requirement string,

# so you can use markers and URL specs freely.

[[gerb.packages]]

requirement = "pkg-b ~=2.1.0,!=2.1.3"

remove-dependencies = ["dep-a"]  # Remove this dependency.

# By default, all wheels will be fetched. These can be used to

# filter. Valid keys are "python", "abi", and "platform".

# Read more about tags in PEP 427.

include-tags = [{python = "cp36", abi = "cp36m"}]

exclude-tags = [{platform = "win32"}]

[[gerb.packages]]

requirement = "pkg-c ==3.0.1"

# If "override-dependencies" is an array (instead of a table),

# its content overrides the dependency list entirely.

override-dependencies = [

    "dep-x ==1.0.2",

    "dep-y ==2.0.0",

]

```

## Invocation

This creates the wheelhouse in the default directory:

```bash

gerb

```

Configurations `wheelhouse` and `repositories` can be overriden:

```bash

gerb --wheelhouse=/path/to/my/global/wheelhouse

     --repository=https://example.com/simple

     --repository=https://my-domain.dev/python/simple

```