Skip to content

Commit c77323c

Browse files
tdsmithTim D. Smith
authored and
Tim D. Smith
committed
Wordsmith PyPI.org migration guide
Some nits and suggestions.
1 parent bd42807 commit c77323c

File tree

1 file changed

+11
-12
lines changed

1 file changed

+11
-12
lines changed

source/guides/migrating-to-pypi-org.rst

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -16,14 +16,14 @@ Uploading
1616
---------
1717

1818
The recommended way to migrate to PyPI.org for uploading is to ensure that you
19-
are using a new enough version of the upload tools. That would be twine v1.8.0+
20-
(recommneded tool), Python 3.4.6+, Python 3.5.3+, Python 3.6+, 2.7.13+, or
21-
setuptools 27+.
19+
are using a new enough version of your upload tool. Tools that support PyPI.org
20+
by default are twine v1.8.0+ (recommended tool), setuptools 27+, or the distutils
21+
included with Python 3.4.6+, Python 3.5.3+, Python 3.6+, and 2.7.13+.
2222

2323
In addition to ensuring you're on a new enough version of the tool for the
24-
tool's default to have switched. You must also make sure that you have not
25-
configured the tool to override it' default value. Typically this is configured
26-
in a file located at ``~/.pypirc``. If you see a file like:
24+
tool's default to have switched, you must also make sure that you have not
25+
configured the tool to override its default upload URL. Typically this is
26+
configured in a file located at ``~/.pypirc``. If you see a file like:
2727

2828

2929
.. code::
@@ -38,15 +38,14 @@ in a file located at ``~/.pypirc``. If you see a file like:
3838
password:yourpassword
3939
4040
41-
Then simply delete the line starting with ``repository`` and you will utilize
42-
the default version of your upload tool.
41+
Then simply delete the line starting with ``repository`` and you will use
42+
your upload tool's default URL.
4343

4444
If for some reason you're unable to upgrade the version of your tool to a
4545
version that defaults to using PyPI.org, then you may edit ``~/.pypirc`` and
4646
include the ``repository:`` line, but use the value
4747
``https://upload.pypi.org/legacy/`` instead.
4848

49-
In addition to regular PyPI, you must also update your ``~/.pypirc`` to handle
50-
TestPyPI if you're using it. For that you must edit your ``~/.pypirc`` to
51-
replace ``https://testpypi.python.org/pypi`` with
52-
``https://test.pypi.org/legacy/``.
49+
If you use TestPyPI, you must update your ``~/.pypirc`` to handle
50+
TestPyPI's new location, by replacing ``https://testpypi.python.org/pypi``
51+
with ``https://test.pypi.org/legacy/``.

0 commit comments

Comments
 (0)