|
12 | 12 | <link rel="prev" href="../ci/">
|
13 | 13 |
|
14 | 14 |
|
15 |
| - <link rel="next" href="../resources/"> |
| 15 | + <link rel="next" href="../faq/"> |
16 | 16 |
|
17 | 17 |
|
18 | 18 | <link rel="icon" href="../assets/images/favicon.png">
|
|
543 | 543 | </ul>
|
544 | 544 | </nav>
|
545 | 545 |
|
546 |
| -</li> |
547 |
| - |
548 |
| - <li class="md-nav__item"> |
549 |
| - <a href="#frequently-seen-errors-and-how-to-fix-them" class="md-nav__link"> |
550 |
| - <span class="md-ellipsis"> |
551 |
| - Frequently seen errors and how to fix them |
552 |
| - </span> |
553 |
| - </a> |
554 |
| - |
555 |
| - <nav class="md-nav" aria-label="Frequently seen errors and how to fix them"> |
556 |
| - <ul class="md-nav__list"> |
557 |
| - |
558 |
| - <li class="md-nav__item"> |
559 |
| - <a href="#cython-compilation-errors-unknown-type-name-__pyx_vectorcallfunc" class="md-nav__link"> |
560 |
| - <span class="md-ellipsis"> |
561 |
| - Cython compilation errors: unknown type name '__pyx_vectorcallfunc' |
562 |
| - </span> |
563 |
| - </a> |
564 |
| - |
565 |
| -</li> |
566 |
| - |
567 |
| - </ul> |
568 |
| - </nav> |
569 |
| - |
570 | 546 | </li>
|
571 | 547 |
|
572 | 548 | <li class="md-nav__item">
|
|
667 | 643 |
|
668 | 644 |
|
669 | 645 |
|
| 646 | + <li class="md-nav__item"> |
| 647 | + <a href="../faq/" class="md-nav__link"> |
| 648 | + |
| 649 | + |
| 650 | + |
| 651 | + <span class="md-ellipsis"> |
| 652 | + Frequently seen errors and how to fix them |
| 653 | + |
| 654 | + </span> |
| 655 | + |
| 656 | + |
| 657 | + </a> |
| 658 | + </li> |
| 659 | + |
| 660 | + |
| 661 | + |
| 662 | + |
| 663 | + |
| 664 | + |
| 665 | + |
| 666 | + |
| 667 | + |
670 | 668 | <li class="md-nav__item">
|
671 | 669 | <a href="../resources/" class="md-nav__link">
|
672 | 670 |
|
|
795 | 793 | </ul>
|
796 | 794 | </nav>
|
797 | 795 |
|
798 |
| -</li> |
799 |
| - |
800 |
| - <li class="md-nav__item"> |
801 |
| - <a href="#frequently-seen-errors-and-how-to-fix-them" class="md-nav__link"> |
802 |
| - <span class="md-ellipsis"> |
803 |
| - Frequently seen errors and how to fix them |
804 |
| - </span> |
805 |
| - </a> |
806 |
| - |
807 |
| - <nav class="md-nav" aria-label="Frequently seen errors and how to fix them"> |
808 |
| - <ul class="md-nav__list"> |
809 |
| - |
810 |
| - <li class="md-nav__item"> |
811 |
| - <a href="#cython-compilation-errors-unknown-type-name-__pyx_vectorcallfunc" class="md-nav__link"> |
812 |
| - <span class="md-ellipsis"> |
813 |
| - Cython compilation errors: unknown type name '__pyx_vectorcallfunc' |
814 |
| - </span> |
815 |
| - </a> |
816 |
| - |
817 |
| -</li> |
818 |
| - |
819 |
| - </ul> |
820 |
| - </nav> |
821 |
| - |
822 | 796 | </li>
|
823 | 797 |
|
824 | 798 | <li class="md-nav__item">
|
@@ -1119,34 +1093,6 @@ <h3 id="detecting-issues-in-cpython">Detecting issues in CPython</h3>
|
1119 | 1093 | by <code>gdb</code>/<code>lldb</code> at the moment of debugging. For more information regarding
|
1120 | 1094 | CPython installation sources, please visit the
|
1121 | 1095 | <a href="../installing_cpython/">Installing a free-threaded Python</a> page.</p>
|
1122 |
| -<h2 id="frequently-seen-errors-and-how-to-fix-them">Frequently seen errors and how to fix them</h2> |
1123 |
| -<p>These are error messages that we see come up often when working with code or |
1124 |
| -development workflows that have not been updated to accommodate the |
1125 |
| -free-threaded build. We also provide suggested fixes. Please send in pull |
1126 |
| -requests to <a href="https://github.com/quansight-labs/free-threaded-compatibility">the repository for this |
1127 |
| -document</a> if you |
1128 |
| -run into any confusing free-threading-specific errors that you suspect apply to |
1129 |
| -other libraries and aren't covered here.</p> |
1130 |
| -<h3 id="cython-compilation-errors-unknown-type-name-__pyx_vectorcallfunc">Cython compilation errors: <code>unknown type name '__pyx_vectorcallfunc'</code></h3> |
1131 |
| -<p>This happens if you try to build a Cython extension for the free-threaded build |
1132 |
| -using the current stable release of Cython (3.0.11 at the time of writing). The |
1133 |
| -current stable release of Cython does not support the free-threaded build. You |
1134 |
| -must either build Cython from the <code>master</code> branch <a href="https://github.com/cython/cython">on |
1135 |
| -Github</a> or use the nightly wheel:</p> |
1136 |
| -<div class="highlight"><pre><span></span><code>pip<span class="w"> </span>install<span class="w"> </span>-i<span class="w"> </span>https://pypi.anaconda.org/scientific-python-nightly-wheels/simple<span class="w"> </span>cython |
1137 |
| -</code></pre></div> |
1138 |
| -<p>See <a href="../porting/">the porting guide</a> for more detail about porting Cython code to |
1139 |
| -work under free-threading.</p> |
1140 |
| -<p>You may wonder why you are able to install a wheel for the current Cython |
1141 |
| -release at all. This is because Cython ships a pure-python wheel tagged with |
1142 |
| -<code>py2.py3-none-any</code>, which pip will install if it cannot find another wheel that |
1143 |
| -is compatible. A future version of Cython will ship a wheel with compiled code |
1144 |
| -that supports the free-threaded build.</p> |
1145 |
| -<p>The current nightly wheel is a pure-python build, so it works on all |
1146 |
| -architectures. The pure-python version of Cython is usually only marginally |
1147 |
| -slower than a compiled version, so you should default to installing the wheel in |
1148 |
| -CI instead of compiling Cython, which can take up to a few minutes on some CI |
1149 |
| -runners.</p> |
1150 | 1096 | <h2 id="compiling-cpython-and-foundational-packages-with-threadsanitizer">Compiling CPython and foundational packages with ThreadSanitizer</h2>
|
1151 | 1097 | <p><a href="https://github.com/google/sanitizers/wiki/ThreadSanitizerCppManual">Thread sanitizer</a> (or TSan) helps
|
1152 | 1098 | to detect C/C++ data races in concurrent systems. This tool can help to reveal free-threading
|
@@ -1351,7 +1297,7 @@ <h3 id="using-addresssanitizer-to-detect-thread-safety-issues">Using AddressSani
|
1351 | 1297 | <span class="md-icon" title="Last update">
|
1352 | 1298 | <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg>
|
1353 | 1299 | </span>
|
1354 |
| - <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="March 14, 2025 19:08:35">March 14, 2025</span> |
| 1300 | + <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="April 18, 2025 15:30:22">April 18, 2025</span> |
1355 | 1301 | </span>
|
1356 | 1302 |
|
1357 | 1303 |
|
|
0 commit comments