Differences between revisions 2 and 29 (spanning 27 versions)
Revision 2 as of 2018-03-14 02:44:24
Size: 5765
Comment: formatting, and no livechat hours scheduled yet
Revision 29 as of 2018-03-26 16:13:31
Size: 115
Comment: formatting
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= PyPI beta announcement =

The new Python Package Index (Warehouse) is currently in pre-production at http://pypi.org/ . On [[https://wiki.python.org/psf/WarehouseRoadmap|the Warehouse roadmap]], it looks like the full switch will happen sometime in April 2018, so here's a heads-up about why we're switching, what's changed, and what to expect.

<<TableOfContents()>>

== Context ==

The legacy PyPI site at https://pypi.python.org started in the early 2000s. In recent years, users faced outages, malicious packages, and spam attacks, and the legacy codebase made it hard to maintain and even harder to develop new features.

The new PyPI has a far more modern look, and is up-to-date under the hood as well; a proper web framework (Pyramid), 100% backend test coverage, and a Docker-based development environment, make it easier for current and new developers to maintain it and add features.

Thanks to [[https://pyfound.blogspot.com/2017/11/the-psf-awarded-moss-grant-pypi.html|Mozilla's Open Source Support funding]], developers have added many new features, overhauled infrastructure, and made steady progress towards redirecting traffic to the new site and shutting down the old one. The full switch will include redirecting browser and pip install traffic from the old site; then, sometime in late April or early May, the legacy site will be entirely shut down.

== Migrating ==

Your sites, services, and tools will probably be able to seamlessly switch to the new site, and thanks to redirects, may not have to change anything immediately. We have [[https://packaging.python.org/guides/migrating-to-pypi-org/|a migration guide for package users and maintainers]] and [[https://warehouse.readthedocs.io/api-reference/integration-guide/#migrating-to-the-new-pypi|a migration guide for API users]].

=== New PyPI Features ===

 * mobile-responsive UI
 * chronological release history for each project ([[https://pypi.org/project/pip/#history|example]])
 * easy-to-read project activity journal for project maintainers
 * better search and filtering
 * support for multiple project URLs (e.g., [[https://packaging.python.org/tutorials/distributing-packages/#project-urls|for a homepage and a repo]])
 * user-visible Gravatars and email addresses for maintainers
 * no need to "register" a project before initial upload
 * far better backend infrastructure, reducing the frequency of outages

=== Deprecations ===

As of the middle of last year, [[https://mail.python.org/pipermail/distutils-sig/2017-July/030849.html|package releases must go through the new PyPI]], and as of late February, [[https://status.python.org/incidents/mgjw1g5yjy5j|new user account registration is only available on the new site]].

Things that are going away, or already have (sometimes for policy or spam-fighting reasons), include:

 * pythonhosted.com documentation hosting ([[https://github.com/pypa/warehouse/issues/582|pypa/warehouse#582]])
 * [[https://warehouse.readthedocs.io/api-reference/xml-rpc/#changes-to-legacy-api|download counts visible in the API]] (instead, use [[https://packaging.python.org/guides/analyzing-pypi-package-downloads/|the Google BigQuery service]])
 * GPG/PGP signatures for packages (still visible in the [[https://warehouse.readthedocs.io/api-reference/legacy/#simple-project-api|Simple Project API]] per [[https://www.python.org/dev/peps/pep-0503/|PEP 503]], but no longer visible in the web UI
 * key management: PyPI no longer has a UI for users to manage their GPG or SSH public keys
 * package maintainers being able to upload a new release via the web UI (instead, the recommended command-line tool is [[http://twine.readthedocs.io/|Twine]])
 * package maintainers being able to log in and update release descriptions via the web UI (to update release metadata, they need to upload a new release; see [[https://mail.python.org/pipermail/distutils-sig/2017-December/031826.html|distutils-sig discussion]])
 * [[https://mail.python.org/pipermail/distutils-sig/2018-January/031855.html|OpenID and Google auth login]]
 * users being able to upload a package without verifying their email address with PyPI first
 * [[https://mail.python.org/pipermail/distutils-sig/2017-October/031712.html|HTTP access to APIs; now it's HTTPS-only]]

== Future ==

And in the works:

 * [[https://www.python.org/dev/peps/pep-0541/|PEP 541]] will enable more timely package takeovers, as people get package names transferred to them after conflict resolution
 * Now that PEP 566 has been approved, [[https://github.com/pypa/warehouse/issues/869#issuecomment-340928703|developers are working to get Markdown supported for README files on PyPI]]

For future updates, please sign up for [[https://mail.python.org/mm3/mailman3/lists/pypi-announce.python.org/|the low-traffic PyPI announcements email list]].

== Security ==

If you find any potential security vulnerabilities, please [[https://pypi.org/security/|follow our published security policy]]. Please don't report security issues in Warehouse via !GitHub, IRC, or mailing lists. Instead, please directly email one or more of our maintainers.

== Contact us ==
Security issues: [[https://pypi.org/security/|email Donald Stufft or Ernest W. Durbin III]]

!GitHub for all other bug reports & feature requests:https://github.com/pypa/warehouse/issues/new

IRC: [[https://webchat.freenode.net/?channels=#pypa-dev|#pypa-dev on Freenode]] (someone's usually there 10am-5pm Central Time on weekdays)

Email: [[https://groups.google.com/forum/#!forum/pypa-dev|pypa-dev mailing list]]

(By participating, you agree to abide by the [[https://www.pypa.io/en/latest/code-of-conduct/|PyPA Code of Conduct]].)

Thank you for using PyPI!
Please see [[https://pyfound.blogspot.com/2018/03/warehouse-all-new-pypi-is-now-in-beta.html|the PSF blog post]].

Please see the PSF blog post.

PackagingWG/PyPIBetaAnnouncement (last edited 2018-03-26 16:13:31 by SumanaHarihareswara)

Unable to view page? See the FrontPage for instructions.