Warehouse
=========

Warehouse is the software that powers `PyPI`_.
See `our development roadmap`_, `documentation`_, and
`architectural overview`_.

Getting Started
---------------

You can run Warehouse locally in a development environment using
``docker``. See `Getting started`_
documentation for instructions on how to set it up.

The canonical deployment of Warehouse is in production at `pypi.org`_.

Discussion
----------

You can find help or get involved on:

- `Github issue tracker`_ for reporting issues
- IRC: on `Libera`_, channel ``#pypa`` for general packaging discussion
  and user support, and ``#pypa-dev`` for
  discussions about development of packaging tools
- The `PyPA Discord`_ for live discussions
- The Packaging category on `Discourse`_ for discussing
  new ideas and community initiatives

Testing
----------

Read the `running tests and linters section`_ of our documentation to
learn how to test your code.

Code of Conduct
---------------

Everyone interacting in the Warehouse project's codebases, issue trackers, chat
rooms, and mailing lists is expected to follow the `PSF Code of Conduct`_.

.. _`PyPI`: https://pypi.org/
.. _`our development roadmap`: https://warehouse.pypa.io/roadmap/
.. _`architectural overview`: https://warehouse.pypa.io/application/
.. _`documentation`: https://warehouse.pypa.io
.. _`Getting started`: https://warehouse.pypa.io/development/getting-started/
.. _`Github issue tracker`: https://github.com/pypi/warehouse/issues
.. _`pypi.org`: https://pypi.org/
.. _`Running tests and linters section`: https://warehouse.pypa.io/development/getting-started/#running-tests-and-linters
.. _`PSF Code of Conduct`: https://github.com/pypa/.github/blob/main/CODE_OF_CONDUCT.md
.. _`Libera`: https://web.libera.chat/#pypa,#pypa-dev
.. _`PyPA Discord`: https://discord.gg/pypa
.. _`Discourse`: https://discuss.python.org/c/packaging/14