Skip to content

Commit 971da6c

Browse files
Update messages.pot as of version 369cd63
1 parent 625c460 commit 971da6c

File tree

1 file changed

+68
-68
lines changed

1 file changed

+68
-68
lines changed

locales/messages.pot

Lines changed: 68 additions & 68 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ msgid ""
88
msgstr ""
99
"Project-Id-Version: Python Packaging User Guide \n"
1010
"Report-Msgid-Bugs-To: \n"
11-
"POT-Creation-Date: 2026-04-20 19:18+0000\n"
11+
"POT-Creation-Date: 2026-04-20 19:36+0000\n"
1212
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
1313
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
1414
"Language-Team: LANGUAGE <LL@li.org>\n"
@@ -976,7 +976,7 @@ msgid "Lastly, it's important to understand that ``install_requires`` is a listi
976976
msgstr ""
977977

978978
#: ../source/discussions/install-requires-vs-requirements.rst:62
979-
#: ../source/tutorials/installing-packages.rst:464
979+
#: ../source/tutorials/installing-packages.rst:463
980980
msgid "Requirements files"
981981
msgstr ""
982982

@@ -3599,7 +3599,7 @@ msgid "You can see if your package has successfully uploaded by navigating to th
35993599
msgstr ""
36003600

36013601
#: ../source/guides/distributing-packages-using-setuptools.rst:589
3602-
#: ../source/tutorials/installing-packages.rst:670
3602+
#: ../source/tutorials/installing-packages.rst:669
36033603
msgid "Depending on your platform, this may require root or Administrator access. :ref:`pip` is currently considering changing this by `making user installs the default behavior <https://github.com/pypa/pip/issues/1668>`_."
36043604
msgstr ""
36053605

@@ -4511,7 +4511,7 @@ msgid "If you want to allow packages from both the :term:`Python Package Index (
45114511
msgstr ""
45124512

45134513
#: ../source/guides/installing-using-pip-and-virtual-environments.rst:434
4514-
#: ../source/tutorials/installing-packages.rst:393
4514+
#: ../source/tutorials/installing-packages.rst:392
45154515
msgid "Upgrading packages"
45164516
msgstr ""
45174517

@@ -17579,262 +17579,262 @@ msgid "Securely Download `get-pip.py <https://bootstrap.pypa.io/get-pip.py>`_ [1
1757917579
msgstr ""
1758017580

1758117581
#: ../source/tutorials/installing-packages.rst:139
17582-
msgid "Run ``python get-pip.py``. [2]_ This will install or upgrade pip. Additionally, it will install :ref:`setuptools` and :ref:`wheel` if they're not installed already."
17582+
msgid "Run ``python get-pip.py``. [2]_ This will install or upgrade pip. Additionally, it may install :ref:`setuptools` and :ref:`wheel` if they're not installed already."
1758317583
msgstr ""
1758417584

1758517585
#: ../source/tutorials/installing-packages.rst:145
1758617586
msgid "Be cautious if you're using a Python install that's managed by your operating system or another package manager. get-pip.py does not coordinate with those tools, and may leave your system in an inconsistent state. You can use ``python get-pip.py --prefix=/usr/local/`` to install in ``/usr/local`` which is designed for locally-installed software."
1758717587
msgstr ""
1758817588

1758917589
#: ../source/tutorials/installing-packages.rst:154
17590-
msgid "Ensure pip, setuptools, and wheel are up to date"
17590+
msgid "Ensure pip is up to date"
1759117591
msgstr ""
1759217592

1759317593
#: ../source/tutorials/installing-packages.rst:156
17594-
msgid "While ``pip`` alone is sufficient to install from pre-built binary archives, up to date copies of the ``setuptools`` and ``wheel`` projects are useful to ensure you can also install from source archives:"
17594+
msgid "Make sure you have the latest features and fixes, and support for the latest Python packaging specifications."
1759517595
msgstr ""
1759617596

17597-
#: ../source/tutorials/installing-packages.rst:173
17597+
#: ../source/tutorials/installing-packages.rst:172
1759817598
msgid "Optionally, create a virtual environment"
1759917599
msgstr ""
1760017600

17601-
#: ../source/tutorials/installing-packages.rst:175
17601+
#: ../source/tutorials/installing-packages.rst:174
1760217602
msgid "See :ref:`section below <Creating and using Virtual Environments>` for details, but here's the basic :doc:`venv <python:library/venv>` [3]_ command to use on a typical Linux system:"
1760317603
msgstr ""
1760417604

17605-
#: ../source/tutorials/installing-packages.rst:192
17605+
#: ../source/tutorials/installing-packages.rst:191
1760617606
msgid "This will create a new virtual environment in the ``tutorial_env`` subdirectory, and configure the current shell to use it as the default ``python`` environment."
1760717607
msgstr ""
1760817608

17609-
#: ../source/tutorials/installing-packages.rst:199
17609+
#: ../source/tutorials/installing-packages.rst:198
1761017610
msgid "Creating Virtual Environments"
1761117611
msgstr ""
1761217612

17613-
#: ../source/tutorials/installing-packages.rst:201
17613+
#: ../source/tutorials/installing-packages.rst:200
1761417614
msgid "Python \"Virtual Environments\" allow Python :term:`packages <Distribution Package>` to be installed in an isolated location for a particular application, rather than being installed globally. If you are looking to safely install global command line tools, see :doc:`/guides/installing-stand-alone-command-line-tools`."
1761517615
msgstr ""
1761617616

17617-
#: ../source/tutorials/installing-packages.rst:207
17617+
#: ../source/tutorials/installing-packages.rst:206
1761817618
msgid "Imagine you have an application that needs version 1 of LibFoo, but another application requires version 2. How can you use both these applications? If you install everything into /usr/lib/python3.6/site-packages (or whatever your platform’s standard location is), it’s easy to end up in a situation where you unintentionally upgrade an application that shouldn’t be upgraded."
1761917619
msgstr ""
1762017620

17621-
#: ../source/tutorials/installing-packages.rst:213
17621+
#: ../source/tutorials/installing-packages.rst:212
1762217622
msgid "Or more generally, what if you want to install an application and leave it be? If an application works, any change in its libraries or the versions of those libraries can break the application."
1762317623
msgstr ""
1762417624

17625-
#: ../source/tutorials/installing-packages.rst:217
17625+
#: ../source/tutorials/installing-packages.rst:216
1762617626
msgid "Also, what if you can’t install :term:`packages <Distribution Package>` into the global site-packages directory? For instance, on a shared host."
1762717627
msgstr ""
1762817628

17629-
#: ../source/tutorials/installing-packages.rst:220
17629+
#: ../source/tutorials/installing-packages.rst:219
1763017630
msgid "In all these cases, virtual environments can help you. They have their own installation directories and they don’t share libraries with other virtual environments."
1763117631
msgstr ""
1763217632

17633-
#: ../source/tutorials/installing-packages.rst:224
17633+
#: ../source/tutorials/installing-packages.rst:223
1763417634
msgid "Currently, there are two common tools for creating Python virtual environments:"
1763517635
msgstr ""
1763617636

17637-
#: ../source/tutorials/installing-packages.rst:226
17637+
#: ../source/tutorials/installing-packages.rst:225
1763817638
msgid ":doc:`venv <python:library/venv>` is available by default in Python 3.3 and later, and installs :ref:`pip` into created virtual environments in Python 3.4 and later (Python versions prior to 3.12 also installed :ref:`setuptools`)."
1763917639
msgstr ""
1764017640

17641-
#: ../source/tutorials/installing-packages.rst:229
17641+
#: ../source/tutorials/installing-packages.rst:228
1764217642
msgid ":ref:`virtualenv` needs to be installed separately, but supports Python 2.7+ and Python 3.3+, and :ref:`pip`, :ref:`setuptools` and :ref:`wheel` are installed into created virtual environments by default. Note that ``setuptools`` is no longer included by default starting with Python 3.12 (and ``virtualenv`` follows this behavior)."
1764317643
msgstr ""
1764417644

17645-
#: ../source/tutorials/installing-packages.rst:234
17645+
#: ../source/tutorials/installing-packages.rst:233
1764617646
msgid "The basic usage is like so:"
1764717647
msgstr ""
1764817648

17649-
#: ../source/tutorials/installing-packages.rst:236
17649+
#: ../source/tutorials/installing-packages.rst:235
1765017650
msgid "Using :doc:`venv <python:library/venv>`:"
1765117651
msgstr ""
1765217652

17653-
#: ../source/tutorials/installing-packages.rst:252
17653+
#: ../source/tutorials/installing-packages.rst:251
1765417654
msgid "Using :ref:`virtualenv`:"
1765517655
msgstr ""
1765617656

17657-
#: ../source/tutorials/installing-packages.rst:268
17657+
#: ../source/tutorials/installing-packages.rst:267
1765817658
msgid "For more information, see the :doc:`venv <python:library/venv>` docs or the :doc:`virtualenv <virtualenv:index>` docs."
1765917659
msgstr ""
1766017660

17661-
#: ../source/tutorials/installing-packages.rst:271
17661+
#: ../source/tutorials/installing-packages.rst:270
1766217662
msgid "The use of :command:`source` under Unix shells ensures that the virtual environment's variables are set within the current shell, and not in a subprocess (which then disappears, having no useful effect)."
1766317663
msgstr ""
1766417664

17665-
#: ../source/tutorials/installing-packages.rst:276
17665+
#: ../source/tutorials/installing-packages.rst:275
1766617666
msgid "In both of the above cases, Windows users should *not* use the :command:`source` command, but should rather run the :command:`activate` script directly from the command shell like so:"
1766717667
msgstr ""
1766817668

17669-
#: ../source/tutorials/installing-packages.rst:286
17669+
#: ../source/tutorials/installing-packages.rst:285
1767017670
msgid "Managing multiple virtual environments directly can become tedious, so the :ref:`dependency management tutorial <managing-dependencies>` introduces a higher level tool, :ref:`Pipenv`, that automatically manages a separate virtual environment for each project and application that you work on."
1767117671
msgstr ""
1767217672

17673-
#: ../source/tutorials/installing-packages.rst:293
17673+
#: ../source/tutorials/installing-packages.rst:292
1767417674
msgid "Use pip for Installing"
1767517675
msgstr ""
1767617676

17677-
#: ../source/tutorials/installing-packages.rst:295
17677+
#: ../source/tutorials/installing-packages.rst:294
1767817678
msgid ":ref:`pip` is the recommended installer. Below, we'll cover the most common usage scenarios. For more detail, see the :doc:`pip docs <pip:index>`, which includes a complete :doc:`Reference Guide <pip:cli/index>`."
1767917679
msgstr ""
1768017680

17681-
#: ../source/tutorials/installing-packages.rst:301
17681+
#: ../source/tutorials/installing-packages.rst:300
1768217682
msgid "Installing from PyPI"
1768317683
msgstr ""
1768417684

17685-
#: ../source/tutorials/installing-packages.rst:303
17685+
#: ../source/tutorials/installing-packages.rst:302
1768617686
msgid "The most common usage of :ref:`pip` is to install from the :term:`Python Package Index <Python Package Index (PyPI)>` using a :term:`requirement specifier <Requirement Specifier>`. Generally speaking, a requirement specifier is composed of a project name followed by an optional :term:`version specifier <Version Specifier>`. A full description of the supported specifiers can be found in the :ref:`Version specifier specification <version-specifiers>`. Below are some examples."
1768717687
msgstr ""
1768817688

17689-
#: ../source/tutorials/installing-packages.rst:311
17689+
#: ../source/tutorials/installing-packages.rst:310
1769017690
msgid "To install the latest version of \"SomeProject\":"
1769117691
msgstr ""
1769217692

17693-
#: ../source/tutorials/installing-packages.rst:325
17693+
#: ../source/tutorials/installing-packages.rst:324
1769417694
msgid "To install a specific version:"
1769517695
msgstr ""
1769617696

17697-
#: ../source/tutorials/installing-packages.rst:339
17697+
#: ../source/tutorials/installing-packages.rst:338
1769817698
msgid "To install greater than or equal to one version and less than another:"
1769917699
msgstr ""
1770017700

17701-
#: ../source/tutorials/installing-packages.rst:354
17701+
#: ../source/tutorials/installing-packages.rst:353
1770217702
msgid "To install a version that's :ref:`compatible <version-specifiers-compatible-release>` with a certain version: [4]_"
1770317703
msgstr ""
1770417704

17705-
#: ../source/tutorials/installing-packages.rst:369
17705+
#: ../source/tutorials/installing-packages.rst:368
1770617706
msgid "In this case, this means to install any version \"==1.4.*\" version that's also \">=1.4.2\"."
1770717707
msgstr ""
1770817708

17709-
#: ../source/tutorials/installing-packages.rst:374
17709+
#: ../source/tutorials/installing-packages.rst:373
1771017710
msgid "Source Distributions vs Wheels"
1771117711
msgstr ""
1771217712

17713-
#: ../source/tutorials/installing-packages.rst:376
17713+
#: ../source/tutorials/installing-packages.rst:375
1771417714
msgid ":ref:`pip` can install from either :term:`Source Distributions (sdist) <Source Distribution (or \"sdist\")>` or :term:`Wheels <Wheel>`, but if both are present on PyPI, pip will prefer a compatible :term:`wheel <Wheel>`. You can override pip`s default behavior by e.g. using its :ref:`--no-binary <pip:install_--no-binary>` option."
1771517715
msgstr ""
1771617716

17717-
#: ../source/tutorials/installing-packages.rst:382
17717+
#: ../source/tutorials/installing-packages.rst:381
1771817718
msgid ":term:`Wheels <Wheel>` are a pre-built :term:`distribution <Distribution Package>` format that provides faster installation compared to :term:`Source Distributions (sdist) <Source Distribution (or \"sdist\")>`, especially when a project contains compiled extensions."
1771917719
msgstr ""
1772017720

17721-
#: ../source/tutorials/installing-packages.rst:387
17721+
#: ../source/tutorials/installing-packages.rst:386
1772217722
msgid "If :ref:`pip` does not find a wheel to install, it will locally build a wheel and cache it for future installs, instead of rebuilding the source distribution in the future."
1772317723
msgstr ""
1772417724

17725-
#: ../source/tutorials/installing-packages.rst:395
17725+
#: ../source/tutorials/installing-packages.rst:394
1772617726
msgid "Upgrade an already installed ``SomeProject`` to the latest from PyPI."
1772717727
msgstr ""
1772817728

17729-
#: ../source/tutorials/installing-packages.rst:412
17729+
#: ../source/tutorials/installing-packages.rst:411
1773017730
msgid "Installing to the User Site"
1773117731
msgstr ""
1773217732

17733-
#: ../source/tutorials/installing-packages.rst:414
17733+
#: ../source/tutorials/installing-packages.rst:413
1773417734
msgid "To install :term:`packages <Distribution Package>` that are isolated to the current user, use the ``--user`` flag:"
1773517735
msgstr ""
1773617736

17737-
#: ../source/tutorials/installing-packages.rst:429
17737+
#: ../source/tutorials/installing-packages.rst:428
1773817738
msgid "For more information see the `User Installs <https://pip.pypa.io/en/latest/user_guide/#user-installs>`_ section from the pip docs."
1773917739
msgstr ""
1774017740

17741-
#: ../source/tutorials/installing-packages.rst:433
17741+
#: ../source/tutorials/installing-packages.rst:432
1774217742
msgid "Note that the ``--user`` flag has no effect when inside a virtual environment - all installation commands will affect the virtual environment."
1774317743
msgstr ""
1774417744

17745-
#: ../source/tutorials/installing-packages.rst:436
17745+
#: ../source/tutorials/installing-packages.rst:435
1774617746
msgid "If ``SomeProject`` defines any command-line scripts or console entry points, ``--user`` will cause them to be installed inside the `user base`_'s binary directory, which may or may not already be present in your shell's :envvar:`PATH`. (Starting in version 10, pip displays a warning when installing any scripts to a directory outside :envvar:`PATH`.) If the scripts are not available in your shell after installation, you'll need to add the directory to your :envvar:`PATH`:"
1774717747
msgstr ""
1774817748

17749-
#: ../source/tutorials/installing-packages.rst:444
17749+
#: ../source/tutorials/installing-packages.rst:443
1775017750
msgid "On Linux and macOS you can find the user base binary directory by running ``python -m site --user-base`` and adding ``bin`` to the end. For example, this will typically print ``~/.local`` (with ``~`` expanded to the absolute path to your home directory) so you'll need to add ``~/.local/bin`` to your ``PATH``. You can set your ``PATH`` permanently by `modifying ~/.profile`_."
1775117751
msgstr ""
1775217752

17753-
#: ../source/tutorials/installing-packages.rst:450
17753+
#: ../source/tutorials/installing-packages.rst:449
1775417754
msgid "On Windows you can find the user base binary directory by running ``py -m site --user-site`` and replacing ``site-packages`` with ``Scripts``. For example, this could return ``C:\\Users\\Username\\AppData\\Roaming\\Python36\\site-packages`` so you would need to set your ``PATH`` to include ``C:\\Users\\Username\\AppData\\Roaming\\Python36\\Scripts``. You can set your user ``PATH`` permanently in the `Control Panel`_. You may need to log out for the ``PATH`` changes to take effect."
1775517755
msgstr ""
1775617756

17757-
#: ../source/tutorials/installing-packages.rst:466
17757+
#: ../source/tutorials/installing-packages.rst:465
1775817758
msgid "Install a list of requirements specified in a :ref:`Requirements File <pip:Requirements Files>`."
1775917759
msgstr ""
1776017760

17761-
#: ../source/tutorials/installing-packages.rst:482
17761+
#: ../source/tutorials/installing-packages.rst:481
1776217762
msgid "Installing from VCS"
1776317763
msgstr ""
1776417764

17765-
#: ../source/tutorials/installing-packages.rst:484
17765+
#: ../source/tutorials/installing-packages.rst:483
1776617766
msgid "Install a project from VCS in \"editable\" mode. For a full breakdown of the syntax, see pip's section on :ref:`VCS Support <pip:VCS Support>`."
1776717767
msgstr ""
1776817768

17769-
#: ../source/tutorials/installing-packages.rst:506
17769+
#: ../source/tutorials/installing-packages.rst:505
1777017770
msgid "Installing from other Indexes"
1777117771
msgstr ""
1777217772

17773-
#: ../source/tutorials/installing-packages.rst:508
17773+
#: ../source/tutorials/installing-packages.rst:507
1777417774
msgid "Install from an alternate index"
1777517775
msgstr ""
1777617776

17777-
#: ../source/tutorials/installing-packages.rst:522
17777+
#: ../source/tutorials/installing-packages.rst:521
1777817778
msgid "Search an additional index during install, in addition to :term:`PyPI <Python Package Index (PyPI)>`"
1777917779
msgstr ""
1778017780

17781-
#: ../source/tutorials/installing-packages.rst:538
17781+
#: ../source/tutorials/installing-packages.rst:537
1778217782
msgid "Installing from a local src tree"
1778317783
msgstr ""
1778417784

17785-
#: ../source/tutorials/installing-packages.rst:541
17785+
#: ../source/tutorials/installing-packages.rst:540
1778617786
msgid "Installing from local src in :doc:`Development Mode <setuptools:userguide/development_mode>`, i.e. in such a way that the project appears to be installed, but yet is still editable from the src tree."
1778717787
msgstr ""
1778817788

17789-
#: ../source/tutorials/installing-packages.rst:558
17789+
#: ../source/tutorials/installing-packages.rst:557
1779017790
msgid "You can also install normally from src"
1779117791
msgstr ""
1779217792

17793-
#: ../source/tutorials/installing-packages.rst:573
17793+
#: ../source/tutorials/installing-packages.rst:572
1779417794
msgid "Installing from local archives"
1779517795
msgstr ""
1779617796

17797-
#: ../source/tutorials/installing-packages.rst:575
17797+
#: ../source/tutorials/installing-packages.rst:574
1779817798
msgid "Install a particular source archive file."
1779917799
msgstr ""
1780017800

17801-
#: ../source/tutorials/installing-packages.rst:589
17801+
#: ../source/tutorials/installing-packages.rst:588
1780217802
msgid "Install from a local directory containing archives (and don't check :term:`PyPI <Python Package Index (PyPI)>`)"
1780317803
msgstr ""
1780417804

17805-
#: ../source/tutorials/installing-packages.rst:609
17805+
#: ../source/tutorials/installing-packages.rst:608
1780617806
msgid "Installing from other sources"
1780717807
msgstr ""
1780817808

17809-
#: ../source/tutorials/installing-packages.rst:611
17809+
#: ../source/tutorials/installing-packages.rst:610
1781017810
msgid "To install from other data sources (for example Amazon S3 storage) you can create a helper application that presents the data in a format compliant with the :ref:`simple repository API <simple-repository-api>`:, and use the ``--extra-index-url`` flag to direct pip to use that index."
1781117811
msgstr ""
1781217812

17813-
#: ../source/tutorials/installing-packages.rst:623
17813+
#: ../source/tutorials/installing-packages.rst:622
1781417814
msgid "Installing Prereleases"
1781517815
msgstr ""
1781617816

17817-
#: ../source/tutorials/installing-packages.rst:625
17817+
#: ../source/tutorials/installing-packages.rst:624
1781817818
msgid "Find pre-release and development versions, in addition to stable versions. By default, pip only finds stable versions."
1781917819
msgstr ""
1782017820

17821-
#: ../source/tutorials/installing-packages.rst:641
17821+
#: ../source/tutorials/installing-packages.rst:640
1782217822
msgid "Installing \"Extras\""
1782317823
msgstr ""
1782417824

17825-
#: ../source/tutorials/installing-packages.rst:643
17825+
#: ../source/tutorials/installing-packages.rst:642
1782617826
msgid "Extras are optional \"variants\" of a package, which may include additional dependencies, and thereby enable additional functionality from the package. If you wish to install an extra for a package which you know publishes one, you can include it in the pip installation command:"
1782717827
msgstr ""
1782817828

17829-
#: ../source/tutorials/installing-packages.rst:666
17829+
#: ../source/tutorials/installing-packages.rst:665
1783017830
msgid "\"Secure\" in this context means using a modern browser or a tool like :command:`curl` that verifies SSL certificates when downloading from https URLs."
1783117831
msgstr ""
1783217832

17833-
#: ../source/tutorials/installing-packages.rst:675
17833+
#: ../source/tutorials/installing-packages.rst:674
1783417834
msgid "Beginning with Python 3.4, ``venv`` (a stdlib alternative to :ref:`virtualenv`) will create virtualenv environments with ``pip`` pre-installed, thereby making it an equal alternative to :ref:`virtualenv`."
1783517835
msgstr ""
1783617836

17837-
#: ../source/tutorials/installing-packages.rst:680
17837+
#: ../source/tutorials/installing-packages.rst:679
1783817838
msgid "The compatible release specifier was accepted in :pep:`440` and support was released in :ref:`setuptools` v8.0 and :ref:`pip` v6.0"
1783917839
msgstr ""
1784017840

0 commit comments

Comments
 (0)