From 02ad3a537342fb8b8d6403ae791e7e9371c56071 Mon Sep 17 00:00:00 2001 From: developer Date: Sat, 1 Mar 2025 15:10:24 +0300 Subject: [PATCH 1/6] docs: detailed information about the --platform and --python-version parameters of the download command is provided --- docs/html/cli/pip_download.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/html/cli/pip_download.rst b/docs/html/cli/pip_download.rst index d247c51ccfb..129df492b97 100644 --- a/docs/html/cli/pip_download.rst +++ b/docs/html/cli/pip_download.rst @@ -47,7 +47,15 @@ constrained download requirement. If some of your dependencies are not available as binaries, you can build them manually for your target platform and let pip download know where to find them using ``--find-links``. +.. note:: +To determine the appropriate values for ``--python-version`` and ``--platform``, you can query the target system using the following commands: +- For the Python version, use :func:`sysconfig.get_python_version() `. +- For the platform, use :func:`sysconfig.get_platform() `. + +Refer to the official Python documentation for more details: +- `sysconfig.get_python_version() `_ +- `sysconfig.get_platform() `_ Options ======= From c4433cb82317c4cdec03a3c5961f38656bceb719 Mon Sep 17 00:00:00 2001 From: developer Date: Sat, 1 Mar 2025 15:19:16 +0300 Subject: [PATCH 2/6] added news --- news/6369.doc.rst | 1 + 1 file changed, 1 insertion(+) create mode 100644 news/6369.doc.rst diff --git a/news/6369.doc.rst b/news/6369.doc.rst new file mode 100644 index 00000000000..e85d3763620 --- /dev/null +++ b/news/6369.doc.rst @@ -0,0 +1 @@ +Provided information about the --platform and --python-version options of the ``pip download`` command \ No newline at end of file From eb949e2d15d705862ac927432ebe292efbeb87a1 Mon Sep 17 00:00:00 2001 From: developer Date: Sun, 2 Mar 2025 10:05:07 +0300 Subject: [PATCH 3/6] fix: linter remarks --- docs/html/cli/pip_download.rst | 13 +++++++------ news/6369.doc.rst | 2 +- 2 files changed, 8 insertions(+), 7 deletions(-) diff --git a/docs/html/cli/pip_download.rst b/docs/html/cli/pip_download.rst index 129df492b97..666d2afab93 100644 --- a/docs/html/cli/pip_download.rst +++ b/docs/html/cli/pip_download.rst @@ -48,14 +48,15 @@ available as binaries, you can build them manually for your target platform and let pip download know where to find them using ``--find-links``. .. note:: -To determine the appropriate values for ``--python-version`` and ``--platform``, you can query the target system using the following commands: -- For the Python version, use :func:`sysconfig.get_python_version() `. -- For the platform, use :func:`sysconfig.get_platform() `. + To determine the appropriate values for ``--python-version`` and ``--platform``, you can query the target system using the following commands: -Refer to the official Python documentation for more details: -- `sysconfig.get_python_version() `_ -- `sysconfig.get_platform() `_ + - For the Python version, use :func:`sysconfig.get_python_version() `. + - For the platform, use :func:`sysconfig.get_platform() `. + + Refer to the official Python documentation for more details: + - `sysconfig.get_python_version() `_ + - `sysconfig.get_platform() `_ Options ======= diff --git a/news/6369.doc.rst b/news/6369.doc.rst index e85d3763620..00742e20ff5 100644 --- a/news/6369.doc.rst +++ b/news/6369.doc.rst @@ -1 +1 @@ -Provided information about the --platform and --python-version options of the ``pip download`` command \ No newline at end of file +Provided information about the --platform and --python-version options of the ``pip download`` command From 64b34b4d546413b7ae0aadb88e270cca5acb630c Mon Sep 17 00:00:00 2001 From: developer Date: Mon, 17 Mar 2025 05:36:55 +0300 Subject: [PATCH 4/6] fix: changed command sysconfig.get_platform() by packaging.tags.sys_tags() --- docs/html/cli/pip_download.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/html/cli/pip_download.rst b/docs/html/cli/pip_download.rst index 666d2afab93..03117136997 100644 --- a/docs/html/cli/pip_download.rst +++ b/docs/html/cli/pip_download.rst @@ -52,11 +52,11 @@ and let pip download know where to find them using ``--find-links``. To determine the appropriate values for ``--python-version`` and ``--platform``, you can query the target system using the following commands: - For the Python version, use :func:`sysconfig.get_python_version() `. - - For the platform, use :func:`sysconfig.get_platform() `. + - For the platform, use :func:`packaging.tags.sys_tags() `. Refer to the official Python documentation for more details: - `sysconfig.get_python_version() `_ - - `sysconfig.get_platform() `_ + - `packaging.tags.sys_tags() `_ Options ======= From 69ff3a373c5005a2a52e2b40019a09f1424ee186 Mon Sep 17 00:00:00 2001 From: developer Date: Fri, 11 Apr 2025 22:16:30 +0300 Subject: [PATCH 5/6] fix: replaced sys_tags() by platform_tags() --- docs/html/cli/pip_download.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/html/cli/pip_download.rst b/docs/html/cli/pip_download.rst index 03117136997..524d5e67929 100644 --- a/docs/html/cli/pip_download.rst +++ b/docs/html/cli/pip_download.rst @@ -52,11 +52,11 @@ and let pip download know where to find them using ``--find-links``. To determine the appropriate values for ``--python-version`` and ``--platform``, you can query the target system using the following commands: - For the Python version, use :func:`sysconfig.get_python_version() `. - - For the platform, use :func:`packaging.tags.sys_tags() `. + - For the platform, use :func:`packaging.tags.platform_tags() `. Refer to the official Python documentation for more details: - `sysconfig.get_python_version() `_ - - `packaging.tags.sys_tags() `_ + - `packaging.tags.platform_tags() `_ Options ======= From 68adf7380d6491cff7382a22feaaf2d6e017a5da Mon Sep 17 00:00:00 2001 From: developer Date: Sun, 13 Apr 2025 21:33:07 +0300 Subject: [PATCH 6/6] fix: added packaging documentation to configuration and removed links repetitions --- docs/html/cli/pip_download.rst | 4 ---- docs/html/conf.py | 1 + news/6369.doc.rst | 1 - 3 files changed, 1 insertion(+), 5 deletions(-) delete mode 100644 news/6369.doc.rst diff --git a/docs/html/cli/pip_download.rst b/docs/html/cli/pip_download.rst index 524d5e67929..52fa2c651da 100644 --- a/docs/html/cli/pip_download.rst +++ b/docs/html/cli/pip_download.rst @@ -54,10 +54,6 @@ and let pip download know where to find them using ``--find-links``. - For the Python version, use :func:`sysconfig.get_python_version() `. - For the platform, use :func:`packaging.tags.platform_tags() `. - Refer to the official Python documentation for more details: - - `sysconfig.get_python_version() `_ - - `packaging.tags.platform_tags() `_ - Options ======= diff --git a/docs/html/conf.py b/docs/html/conf.py index be95eca2941..309354d875e 100644 --- a/docs/html/conf.py +++ b/docs/html/conf.py @@ -69,6 +69,7 @@ intersphinx_mapping = { "python": ("https://docs.python.org/3", None), "pypug": ("https://packaging.python.org", None), + "packaging": ("https://packaging.pypa.io/en/stable/", None), } # -- Options for towncrier_draft extension -------------------------------------------- diff --git a/news/6369.doc.rst b/news/6369.doc.rst deleted file mode 100644 index 00742e20ff5..00000000000 --- a/news/6369.doc.rst +++ /dev/null @@ -1 +0,0 @@ -Provided information about the --platform and --python-version options of the ``pip download`` command