docs update

Author: electronstudio

docs/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 9916125ae8fbc6b931a6987aa12f983d
+config: 614f580883a5bffb7f1606004f7be223
 tags: 645f666f9bcd5a90fca523b33c5a78b7

docs/BUILDING.html

@@ -7,7 +7,7 @@
   <title>Building from source &mdash; Raylib Python  documentation</title>
       <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" />
       <link rel="stylesheet" type="text/css" href="_static/css/theme.css?v=19f00094" />
-      <link rel="stylesheet" type="text/css" href="_static/graphviz.css?v=eafc0fe6" />
+      <link rel="stylesheet" type="text/css" href="_static/graphviz.css?v=fd3f3429" />
 
 
   <!--[if lt IE 9]>
@@ -17,7 +17,7 @@
         <script src="_static/jquery.js?v=5d32c60e"></script>
         <script src="_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
         <script src="_static/documentation_options.js?v=5929fcd5"></script>
-        <script src="_static/doctools.js?v=888ff710"></script>
+        <script src="_static/doctools.js?v=9a2dae69"></script>
         <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/js/theme.js"></script>
     <link rel="index" title="Index" href="genindex.html" />

docs/README.html

@@ -7,7 +7,7 @@
   <title>Python Bindings for Raylib 5.0 &mdash; Raylib Python  documentation</title>
       <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" />
       <link rel="stylesheet" type="text/css" href="_static/css/theme.css?v=19f00094" />
-      <link rel="stylesheet" type="text/css" href="_static/graphviz.css?v=eafc0fe6" />
+      <link rel="stylesheet" type="text/css" href="_static/graphviz.css?v=fd3f3429" />
 
 
   <!--[if lt IE 9]>
@@ -17,7 +17,7 @@
         <script src="_static/jquery.js?v=5d32c60e"></script>
         <script src="_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
         <script src="_static/documentation_options.js?v=5929fcd5"></script>
-        <script src="_static/doctools.js?v=888ff710"></script>
+        <script src="_static/doctools.js?v=9a2dae69"></script>
         <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="_static/js/theme.js"></script>
     <link rel="index" title="Index" href="genindex.html" />
@@ -193,7 +193,6 @@ <h1>Running in a web browser<a class="headerlink" href="#running-in-a-web-browse
 <div class="highlight-none notranslate"><div class="highlight"><pre><span></span># /// script
 # dependencies = [
 #     &quot;cffi&quot;,
-#     &quot;inflection&quot;,
 #     &quot;raylib&quot;
 # ]
 # ///
@@ -250,10 +249,18 @@ <h1>License (updated)<a class="headerlink" href="#license-updated" title="Link t
 </section>
 <section id="performance">
 <h1>Performance<a class="headerlink" href="#performance" title="Link to this heading"></a></h1>
-<p>For fastest performance use Pypy rather than standard Python.</p>
-<p>Every call to C is costly, so it’s slightly faster if you use Python data structures and functions when calculating
+<p>If you need more performance, do in this order:</p>
+<ol class="arabic simple">
+<li><p>Use Pypy rather than standard CPython.  It is much, much faster and will make more difference than any other optimisations you might do.</p></li>
+<li><p>Every call to C is costly, so it’s slightly faster if you use Python data structures and functions when calculating
 in your update loop
-and then only convert them to C data structures when you have to call the C functions for drawing.</p>
+and then only convert them to C data structures when you have to call the C functions for drawing.</p></li>
+<li><p>The raylib.* functions are potentially 1.5x faster than the pyray.* equivalents, so if you need a tiny bit more performance
+you can switch your inner loop functions to these.</p></li>
+<li><p>There is a version of Python that is faster than Pypy: GraalPy.  However it’s not fully compatible with all Python
+packages.  It doesn’t work with CFFI and so doesn’t work with this binding.  But it <em>is</em> compatible with the
+<em>Java</em> binding, Jaylib!  There is an example of this here: https://github.com/electronstudio/megabunny/tree/master/raylib-python-jaylib</p></li>
+</ol>
 <section id="bunnymark">
 <h2>Bunnymark<a class="headerlink" href="#bunnymark" title="Link to this heading"></a></h2>
 <table class="docutils align-default">
@@ -265,33 +272,49 @@ <h2>Bunnymark<a class="headerlink" href="#bunnymark" title="Link to this heading
 </tr>
 </thead>
 <tbody>
-<tr class="row-even"><td><p>Raylib 3.7</p></td>
+<tr class="row-even"><td><p>Raylib 5.0</p></td>
+<td><p>C</p></td>
+<td><p>180000</p></td>
+<td><p>100%</p></td>
+</tr>
+<tr class="row-odd"><td><p>Raylib Python CFFI 5.0.0.2</p></td>
+<td><p>Python 3.12</p></td>
+<td><p>10500</p></td>
+<td><p>5.8%</p></td>
+</tr>
+<tr class="row-even"><td><p>Raylib Python CFFI 5.0.0.2</p></td>
+<td><p>Pypy 3.10</p></td>
+<td><p>95000</p></td>
+<td><p>53%</p></td>
+</tr>
+<tr class="row-odd"><td><p>Raylib 3.7</p></td>
 <td><p>C</p></td>
 <td><p>168100</p></td>
 <td><p>100%</p></td>
 </tr>
-<tr class="row-odd"><td><p>Raylib Python CFFI 3.7</p></td>
+<tr class="row-even"><td><p>Raylib Python CFFI 3.7</p></td>
 <td><p>Pypy 3.7</p></td>
 <td><p>33800</p></td>
 <td><p>20%</p></td>
 </tr>
-<tr class="row-even"><td><p>Raylib Python CFFI 3.7</p></td>
+<tr class="row-odd"><td><p>Raylib Python CFFI 3.7</p></td>
 <td><p>Python 3.9</p></td>
 <td><p>7700</p></td>
 <td><p>4.5%</p></td>
 </tr>
-<tr class="row-odd"><td><p>Raylib Python CFFI 3.7</p></td>
+<tr class="row-even"><td><p>Raylib Python CFFI 3.7</p></td>
 <td><p>Python 3.9 Nuitka</p></td>
 <td><p>8600</p></td>
 <td><p>5.1%</p></td>
 </tr>
-<tr class="row-even"><td><p>Raylib Python CFFI 3.7 Dynamic</p></td>
+<tr class="row-odd"><td><p>Raylib Python CFFI 3.7 Dynamic</p></td>
 <td><p>Python 3.9</p></td>
 <td><p>6300</p></td>
 <td><p>3.7%</p></td>
 </tr>
 </tbody>
 </table>
+<p>See also https://github.com/electronstudio/megabunny/</p>
 </section>
 </section>
 <section id="packaging-your-app">

docs/_sources/README.md.txt

@@ -1,7 +1,5 @@
 # Python Bindings for Raylib 5.0
 
-<iframe src="https://electronstudio.github.io/raylib-python-cffi-pygbag-examples/shapes_bouncing_ball/build/web/" style="border:0px #ffffff none;" name="myiFrame" scrolling="no" frameborder="1" marginheight="0px" marginwidth="0px" height="450px" width="800px" allowfullscreen></iframe>
-
 Chatroom: [Discord](https://discord.gg/fKDwt85aX6) or [Matrix](https://matrix.to/#/#raylib-python-cffi:matrix.org)
 
 New CFFI API static bindings.
@@ -94,7 +92,6 @@ Make a folder `my_project` with a file `main.py`:
     # /// script
     # dependencies = [
     #     "cffi",
-    #     "inflection",
     #     "raylib"
     # ]
     # ///
@@ -153,22 +150,36 @@ statically link and use in non-free / proprietary / commercial projects!
 
 # Performance
 
-For fastest performance use Pypy rather than standard Python.
+If you need more performance, do in this order:
+
+1. Use Pypy rather than standard CPython.  It is much, much faster and will make more difference than any other optimisations you might do.
 
-Every call to C is costly, so it's slightly faster if you use Python data structures and functions when calculating
+2. Every call to C is costly, so it's slightly faster if you use Python data structures and functions when calculating
 in your update loop
 and then only convert them to C data structures when you have to call the C functions for drawing.
 
+3. The raylib.* functions are potentially 1.5x faster than the pyray.* equivalents, so if you need a tiny bit more performance
+you can switch your inner loop functions to these.
+
+4. There is a version of Python that is faster than Pypy: GraalPy.  However it's not fully compatible with all Python
+packages.  It doesn't work with CFFI and so doesn't work with this binding.  But it *is* compatible with the
+*Java* binding, Jaylib!  There is an example of this here: https://github.com/electronstudio/megabunny/tree/master/raylib-python-jaylib
+
 ## Bunnymark
 
 
-| Library                | Implementation    | Bunnies (60 FPS) | Percentage    |
-| -------------          | -------------     | -------------    | ------------- |
-| Raylib 3.7             | C                 | 168100           | 100%          |
-| Raylib Python CFFI 3.7 | Pypy 3.7          | 33800            | 20%           |
-| Raylib Python CFFI 3.7 | Python 3.9        | 7700             |  4.5%         |
-| Raylib Python CFFI 3.7 | Python 3.9 Nuitka | 8600             |  5.1%         |
-| Raylib Python CFFI 3.7 Dynamic | Python 3.9 | 6300             |  3.7%         |
+| Library                        | Implementation    | Bunnies (60 FPS) | Percentage |
+|--------------------------------|-------------------|------------------|------------|
+| Raylib 5.0                     | C                 | 180000           | 100%       |
+| Raylib Python CFFI 5.0.0.2     | Python 3.12       | 10500            | 5.8%       |
+| Raylib Python CFFI 5.0.0.2     | Pypy 3.10         | 95000            | 53%        |
+| Raylib 3.7                     | C                 | 168100           | 100%       |
+| Raylib Python CFFI 3.7         | Pypy 3.7          | 33800            | 20%        |
+| Raylib Python CFFI 3.7         | Python 3.9        | 7700             | 4.5%       |
+| Raylib Python CFFI 3.7         | Python 3.9 Nuitka | 8600             | 5.1%       |
+| Raylib Python CFFI 3.7 Dynamic | Python 3.9        | 6300             | 3.7%       |
+
+See also https://github.com/electronstudio/megabunny/
 
 # Packaging your app
 
@@ -183,4 +194,4 @@ You can create a standalone binary using the Nuitka compiler.  For example, here
 [RetroWar: 8-bit Party Battle](https://store.steampowered.com/app/664240/RetroWar_8bit_Party_Battle/?git) is out now.  Defeat up to 15 of your friends in a tournament of 80s-inspired retro mini games.
 
 [Coding Games With Pygame Zero & Python](https://github.com/electronstudio/pygame-zero-book) is 
-a book for Python beginners.
+a book for Python beginners.

docs/_static/basic.css

@@ -4,7 +4,7 @@
  *
  * Sphinx stylesheet -- basic theme.
  *
- * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
+ * :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
  * :license: BSD, see LICENSE for details.
  *
  */

docs/_static/doctools.js

@@ -4,7 +4,7 @@
  *
  * Base JavaScript utilities for all Sphinx HTML documentation.
  *
- * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
+ * :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
  * :license: BSD, see LICENSE for details.
  *
  */

docs/_static/graphviz.css

@@ -4,7 +4,7 @@
  *
  * Sphinx stylesheet -- graphviz extension.
  *
- * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
+ * :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
  * :license: BSD, see LICENSE for details.
  *
  */

docs/_static/language_data.js

@@ -5,15 +5,15 @@
  * This script contains the language-specific data used by searchtools.js,
  * namely the list of stopwords, stemmer, scorer and splitter.
  *
- * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
+ * :copyright: Copyright 2007-2024 by the Sphinx team, see AUTHORS.
  * :license: BSD, see LICENSE for details.
  *
  */
 
 var stopwords = ["a", "and", "are", "as", "at", "be", "but", "by", "for", "if", "in", "into", "is", "it", "near", "no", "not", "of", "on", "or", "such", "that", "the", "their", "then", "there", "these", "they", "this", "to", "was", "will", "with"];
 
 
-/* Non-minified version is copied as a separate JS file, is available */
+/* Non-minified version is copied as a separate JS file, if available */
 
 /**
  * Porter Stemmer