Skip to content

Commit

Permalink
Add packaging environment
Browse files Browse the repository at this point in the history
Adds a packaging environment and documents its use. This should clarify how
to build and install and unreleased version.

Related: pypa#1609
  • Loading branch information
ssbarnea committed Feb 14, 2020
1 parent e41fee7 commit 30f8e22
Show file tree
Hide file tree
Showing 2 changed files with 29 additions and 0 deletions.
9 changes: 9 additions & 0 deletions docs/installation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -45,6 +45,15 @@ supporting Python 2.7 use

.. _compatibility-requirements:

from source
-----------

If you want to test unreleased version you can run `tox -e packaging` which will produce source and wheel inside
`dist/` folder.

If you have `pip>=20` you can just do a `pip install git+https://github.com/pypa/virtualenv.git`, older versions will
fail with confusing errors.

Python and OS Compatibility
---------------------------

Expand Down
20 changes: 20 additions & 0 deletions tox.ini
Original file line number Diff line number Diff line change
Expand Up @@ -161,3 +161,23 @@ deps =
packaging >= 20.0.0
commands =
python tasks/make_zipapp.py

[testenv:packaging]
description =
Do packagin/distribution, leaving artifacts indist dist/ folder.
usedevelop = false
skip_install = true
deps =
pep517 >= 0.8.1
twine >= 3.1.1
setenv =
commands =
rm -rfv {toxinidir}/dist/
python -m pep517.build \
--source \
--binary \
--out-dir {toxinidir}/dist/ \
{toxinidir}
python -m twine check .tox/dist/*
whitelist_externals =
rm

0 comments on commit 30f8e22

Please sign in to comment.