Skip to main content

A small utility to make alias distributions on PyPI.

It will create an “empty” package with a different name (the “alias”) that depends on the package in your current working directory.

  • Free software: BSD 2-Clause License

Installation

pip install pypi-alias

You can also install the in-development version with:

pip install https://github.com/ionelmc/pypi-alias/archive/master.zip

Usage

You can use pypi-alias with a distribution file (a .whl file or a sdist) or with a path, as long as it has a pyproject.toml with build configuration in it.

Example, if say, you have a foobar package, and you want to make an alias with name python-foobar, assuming your in the checkout path:

pypi-alias python-foobar

You can specify a version:

pypi-alias python-foobar --alias-version=1.0

You can use a dist file:

pypi-alias python-foobar --alias-version=1.0 dist/foobar-1.2.3.tar.gz

And you can also add some build options for the resulting alias package (example: only build sdist in a different path):

pypi-alias python-foobar --alias-version=1.0 dist/foobar-1.2.3.tar.gz -- --dist --outdir=aliased-dist

The resulting files are in dist\, assuming you haven’t used --outdir, you can upload them with twine:

twine upload dist\python-foobar*

Development

To run all the tests run:

tox

Note, to combine the coverage data from all the tox environments run:

Windows

set PYTEST_ADDOPTS=--cov-append
tox

Other

PYTEST_ADDOPTS=--cov-append tox

Changelog

2.0.0 (2025-07-13)

  • Now build/pkginfo are used to get package metadata. This means pyproject.toml projects are supported.

  • Dropped support for Python 3.8 or older.

1.0.0 (2021-04-08)

  • Added support for Python 3. Contributed by Emil Stenström in #5.

  • Dropped support for Python 2.

  • Switched to argparse and added the --version and --dirty arguments.

  • Added some light CI/testing.

0.2.0 (2015-06-18)

  • Fix regression in __main__.

0.1.0 (2015-06-18)

  • First release on PyPI.

Release files for pypi-alias 2.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pypi-alias 2.0.0
File Size Uploaded
pypi_alias-2.0.0.tar.gz 14.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pypi-alias 2.0.0
File Interpreter ABI Platform
pypi_alias-2.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 19.6 kB

Release files / pypi_alias-2.0.0.tar.gz

Download URL pypi_alias-2.0.0.tar.gz
Size 14.0 kB
Tags Source
SHA-256 checksum
How to use checksums
fa81677643d59a097e558c47bafdf0d7b732c4f1071f7f5efc94bbc17b0064ed
BLAKE2b-256 checksum
How to use checksums
2b552e64a44ea6cb97288a75d3b7b931473ed4c1449de96600f73d521a5b2c1d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.5

Release files / pypi_alias-2.0.0-py3-none-any.whl

Download URL pypi_alias-2.0.0-py3-none-any.whl
Size 5.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4b1a7303c0a0d116b357e85bc861cd841bbc1f8b8a524a777b28566b388a874c
BLAKE2b-256 checksum
How to use checksums
3b845d28358fe1a6e4c32ebca6fed923cc7a71c1a7e56b3dfbaa97b4bf970685
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.5

Release history Release notifications | RSS feed

This release

2.0.0 This release

2 release files

1.0.0

2 release files

0.2.0

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page