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.

Download files

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

Source Distribution

pypi_alias-2.0.0.tar.gz (14.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pypi_alias-2.0.0-py3-none-any.whl (5.5 kB view details)

Uploaded Python 3

File details

Details for the file pypi_alias-2.0.0.tar.gz.

File metadata

  • Download URL: pypi_alias-2.0.0.tar.gz
  • Upload date:
  • Size: 14.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for pypi_alias-2.0.0.tar.gz
Algorithm Hash digest
SHA256 fa81677643d59a097e558c47bafdf0d7b732c4f1071f7f5efc94bbc17b0064ed
MD5 08ade6a14538c9e3b0271f829e277a02
BLAKE2b-256 2b552e64a44ea6cb97288a75d3b7b931473ed4c1449de96600f73d521a5b2c1d

See more details on using hashes here.

File details

Details for the file pypi_alias-2.0.0-py3-none-any.whl.

File metadata

  • Download URL: pypi_alias-2.0.0-py3-none-any.whl
  • Upload date:
  • Size: 5.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for pypi_alias-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4b1a7303c0a0d116b357e85bc861cd841bbc1f8b8a524a777b28566b388a874c
MD5 dbb4f9e91fbe5fc3c6e661f70dc4126c
BLAKE2b-256 3b845d28358fe1a6e4c32ebca6fed923cc7a71c1a7e56b3dfbaa97b4bf970685

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

2.0.0 This release

2 files

1.0.0

2 files

0.2.0

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page