From 5901ab5d4489328e1be14e62b2b0f3bda17860ae Mon Sep 17 00:00:00 2001 From: Victor Blomqvist Date: Sun, 26 May 2024 21:16:25 +0200 Subject: [PATCH 01/10] Create considerations_for_binary_wheels.rst --- .../discussions/considerations_for_binary_wheels.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 source/discussions/considerations_for_binary_wheels.rst diff --git a/source/discussions/considerations_for_binary_wheels.rst b/source/discussions/considerations_for_binary_wheels.rst new file mode 100644 index 000000000..f5e1e20f8 --- /dev/null +++ b/source/discussions/considerations_for_binary_wheels.rst @@ -0,0 +1,12 @@ +================================ +Considerations for binary wheels +================================ + +Python packages with native code have a set of unique challenges not present +in pure packages. The more complex the native code, the more complex the +packaging can become. Issues arrise around topics such as non-Python compiled +dependencies ("native dependencies"), the importance of the ABI (Application +Binary Interface) of native code, dependency on SIMD code and cross +compilation. In depth dicussion of these and many more topics and issues around + native packaging is available at + `pypackaging-native`. From 413893d0c1af1e33707232d9f0b48e29b421bac4 Mon Sep 17 00:00:00 2001 From: Victor Blomqvist Date: Sun, 26 May 2024 21:17:47 +0200 Subject: [PATCH 02/10] And binary wheel discussion to index --- source/discussions/index.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/source/discussions/index.rst b/source/discussions/index.rst index d262bcff2..02ceba602 100644 --- a/source/discussions/index.rst +++ b/source/discussions/index.rst @@ -16,3 +16,4 @@ specific topic. If you're just trying to get stuff done, see package-formats src-layout-vs-flat-layout setup-py-deprecated + considerations_for_binary_wheels From a548da992ffd394699873f9a9359dc22df61b9ab Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Sun, 26 May 2024 19:19:46 +0000 Subject: [PATCH 03/10] [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --- .../discussions/considerations_for_binary_wheels.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/source/discussions/considerations_for_binary_wheels.rst b/source/discussions/considerations_for_binary_wheels.rst index f5e1e20f8..861e7794e 100644 --- a/source/discussions/considerations_for_binary_wheels.rst +++ b/source/discussions/considerations_for_binary_wheels.rst @@ -2,11 +2,11 @@ Considerations for binary wheels ================================ -Python packages with native code have a set of unique challenges not present -in pure packages. The more complex the native code, the more complex the -packaging can become. Issues arrise around topics such as non-Python compiled -dependencies ("native dependencies"), the importance of the ABI (Application -Binary Interface) of native code, dependency on SIMD code and cross +Python packages with native code have a set of unique challenges not present +in pure packages. The more complex the native code, the more complex the +packaging can become. Issues arrise around topics such as non-Python compiled +dependencies ("native dependencies"), the importance of the ABI (Application +Binary Interface) of native code, dependency on SIMD code and cross compilation. In depth dicussion of these and many more topics and issues around - native packaging is available at + native packaging is available at `pypackaging-native`. From 380b8d19be61104df65dac7c547d180ab056ef58 Mon Sep 17 00:00:00 2001 From: Victor Blomqvist Date: Sun, 26 May 2024 21:27:21 +0200 Subject: [PATCH 04/10] Fix link in considerations_for_binary_wheels.rst --- source/discussions/considerations_for_binary_wheels.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/discussions/considerations_for_binary_wheels.rst b/source/discussions/considerations_for_binary_wheels.rst index 861e7794e..4158de1ea 100644 --- a/source/discussions/considerations_for_binary_wheels.rst +++ b/source/discussions/considerations_for_binary_wheels.rst @@ -9,4 +9,4 @@ dependencies ("native dependencies"), the importance of the ABI (Application Binary Interface) of native code, dependency on SIMD code and cross compilation. In depth dicussion of these and many more topics and issues around native packaging is available at - `pypackaging-native`. + `pypackaging-native`_. From 203c79d9527f66ae90cb385929f537616c845223 Mon Sep 17 00:00:00 2001 From: Victor Blomqvist Date: Mon, 27 May 2024 21:29:08 +0200 Subject: [PATCH 05/10] Update source/discussions/considerations_for_binary_wheels.rst Co-authored-by: chrysle <96722107+chrysle@users.noreply.github.com> --- source/discussions/considerations_for_binary_wheels.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/discussions/considerations_for_binary_wheels.rst b/source/discussions/considerations_for_binary_wheels.rst index 4158de1ea..49d89e394 100644 --- a/source/discussions/considerations_for_binary_wheels.rst +++ b/source/discussions/considerations_for_binary_wheels.rst @@ -7,6 +7,6 @@ in pure packages. The more complex the native code, the more complex the packaging can become. Issues arrise around topics such as non-Python compiled dependencies ("native dependencies"), the importance of the ABI (Application Binary Interface) of native code, dependency on SIMD code and cross -compilation. In depth dicussion of these and many more topics and issues around +compilation. In depth discussion of these and many more topics and issues around native packaging is available at `pypackaging-native`_. From 639ef8a21f07da1bfc4010da2247a3412bf25d04 Mon Sep 17 00:00:00 2001 From: Victor Blomqvist Date: Mon, 27 May 2024 21:29:20 +0200 Subject: [PATCH 06/10] Update source/discussions/considerations_for_binary_wheels.rst Co-authored-by: chrysle <96722107+chrysle@users.noreply.github.com> --- source/discussions/considerations_for_binary_wheels.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/source/discussions/considerations_for_binary_wheels.rst b/source/discussions/considerations_for_binary_wheels.rst index 49d89e394..cfca706c7 100644 --- a/source/discussions/considerations_for_binary_wheels.rst +++ b/source/discussions/considerations_for_binary_wheels.rst @@ -8,5 +8,4 @@ packaging can become. Issues arrise around topics such as non-Python compiled dependencies ("native dependencies"), the importance of the ABI (Application Binary Interface) of native code, dependency on SIMD code and cross compilation. In depth discussion of these and many more topics and issues around - native packaging is available at - `pypackaging-native`_. +native packaging is available at `pypackaging-native `_. From 5a89e74e83b92cfaa455dbedf87869ed4641ada9 Mon Sep 17 00:00:00 2001 From: Victor Blomqvist Date: Sat, 1 Jun 2024 21:35:50 +0200 Subject: [PATCH 07/10] Added link to pypackaging-native on packaging binary extensions page --- .../discussions/considerations_for_binary_wheels.rst | 11 ----------- source/discussions/index.rst | 1 - source/guides/packaging-binary-extensions.rst | 12 ++++++++++++ 3 files changed, 12 insertions(+), 12 deletions(-) delete mode 100644 source/discussions/considerations_for_binary_wheels.rst diff --git a/source/discussions/considerations_for_binary_wheels.rst b/source/discussions/considerations_for_binary_wheels.rst deleted file mode 100644 index cfca706c7..000000000 --- a/source/discussions/considerations_for_binary_wheels.rst +++ /dev/null @@ -1,11 +0,0 @@ -================================ -Considerations for binary wheels -================================ - -Python packages with native code have a set of unique challenges not present -in pure packages. The more complex the native code, the more complex the -packaging can become. Issues arrise around topics such as non-Python compiled -dependencies ("native dependencies"), the importance of the ABI (Application -Binary Interface) of native code, dependency on SIMD code and cross -compilation. In depth discussion of these and many more topics and issues around -native packaging is available at `pypackaging-native `_. diff --git a/source/discussions/index.rst b/source/discussions/index.rst index 02ceba602..d262bcff2 100644 --- a/source/discussions/index.rst +++ b/source/discussions/index.rst @@ -16,4 +16,3 @@ specific topic. If you're just trying to get stuff done, see package-formats src-layout-vs-flat-layout setup-py-deprecated - considerations_for_binary_wheels diff --git a/source/guides/packaging-binary-extensions.rst b/source/guides/packaging-binary-extensions.rst index 589ed89c8..b664d68a4 100644 --- a/source/guides/packaging-binary-extensions.rst +++ b/source/guides/packaging-binary-extensions.rst @@ -403,3 +403,15 @@ a Debian system, see the following articles: * `What are (c)python extension modules? `_ * `Releasing the gil `_ * `Writing cpython extension modules using C++ `_ + +Additional considerations for binary wheels +------------------------------------------- + +The `pypackaging-native `_ website has +additional coverage of packaging Python packages with native code. It aims to +provide an overview of the most important packaging issues for such projects, +with in-depth explanations and references. + +Topics cover for example non-Python compiled dependencies ("native dependencies"), +the importance of the ABI (Application Binary Interface) of native code, +dependency on SIMD code and cross compilation. From fb2192df714ec14879ec2ef7e37050481339512b Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Sat, 1 Jun 2024 19:36:03 +0000 Subject: [PATCH 08/10] [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --- source/guides/packaging-binary-extensions.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/source/guides/packaging-binary-extensions.rst b/source/guides/packaging-binary-extensions.rst index b664d68a4..ff7298658 100644 --- a/source/guides/packaging-binary-extensions.rst +++ b/source/guides/packaging-binary-extensions.rst @@ -407,11 +407,11 @@ a Debian system, see the following articles: Additional considerations for binary wheels ------------------------------------------- -The `pypackaging-native `_ website has -additional coverage of packaging Python packages with native code. It aims to -provide an overview of the most important packaging issues for such projects, +The `pypackaging-native `_ website has +additional coverage of packaging Python packages with native code. It aims to +provide an overview of the most important packaging issues for such projects, with in-depth explanations and references. -Topics cover for example non-Python compiled dependencies ("native dependencies"), -the importance of the ABI (Application Binary Interface) of native code, -dependency on SIMD code and cross compilation. +Topics cover for example non-Python compiled dependencies ("native dependencies"), +the importance of the ABI (Application Binary Interface) of native code, +dependency on SIMD code and cross compilation. From bd9956a0f90865ce704bb19587ab6c1129bb4c80 Mon Sep 17 00:00:00 2001 From: Victor Blomqvist Date: Sat, 1 Jun 2024 21:57:05 +0200 Subject: [PATCH 09/10] Minor improvement of text --- source/guides/packaging-binary-extensions.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/guides/packaging-binary-extensions.rst b/source/guides/packaging-binary-extensions.rst index b664d68a4..25a897d2e 100644 --- a/source/guides/packaging-binary-extensions.rst +++ b/source/guides/packaging-binary-extensions.rst @@ -412,6 +412,6 @@ additional coverage of packaging Python packages with native code. It aims to provide an overview of the most important packaging issues for such projects, with in-depth explanations and references. -Topics cover for example non-Python compiled dependencies ("native dependencies"), +Example of topics are non-Python compiled dependencies ("native dependencies"), the importance of the ABI (Application Binary Interface) of native code, dependency on SIMD code and cross compilation. From ce3653dc5f0f7376cc240954ecac71528ce2022e Mon Sep 17 00:00:00 2001 From: "pre-commit-ci[bot]" <66853113+pre-commit-ci[bot]@users.noreply.github.com> Date: Sat, 1 Jun 2024 19:58:24 +0000 Subject: [PATCH 10/10] [pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci --- source/guides/packaging-binary-extensions.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/guides/packaging-binary-extensions.rst b/source/guides/packaging-binary-extensions.rst index 4a3be2cc3..de8a9d2d6 100644 --- a/source/guides/packaging-binary-extensions.rst +++ b/source/guides/packaging-binary-extensions.rst @@ -412,6 +412,6 @@ additional coverage of packaging Python packages with native code. It aims to provide an overview of the most important packaging issues for such projects, with in-depth explanations and references. -Examples of topics covered are non-Python compiled dependencies ("native -dependencies"), the importance of the ABI (Application Binary Interface) of +Examples of topics covered are non-Python compiled dependencies ("native +dependencies"), the importance of the ABI (Application Binary Interface) of native code, dependency on SIMD code and cross compilation.