asimpy 0.4.1__tar.gz → 0.5.0__tar.gz

{asimpy-0.4.1 → asimpy-0.5.0}/.gitignore

@@ -21,3 +21,4 @@ coverage.json
 
 # MacOS
 .DS_store
+.aider*

{asimpy-0.4.1 → asimpy-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: asimpy
-Version: 0.4.1
+Version: 0.5.0
 Summary: A simple discrete event simulator using async/await
 Author-email: Greg Wilson <gvwilson@third-bit.com>
 Maintainer-email: Greg Wilson <gvwilson@third-bit.com>
@@ -10,17 +10,6 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.12
-Provides-Extra: dev
-Requires-Dist: build>=1.4.0; extra == 'dev'
-Requires-Dist: markdown-include>=0.8.1; extra == 'dev'
-Requires-Dist: mkdocs-awesome-pages-plugin>=2.10.1; extra == 'dev'
-Requires-Dist: mkdocs-material>=9.7.1; extra == 'dev'
-Requires-Dist: mkdocs>=1.6.1; extra == 'dev'
-Requires-Dist: mkdocstrings[python]>=1.0.0; extra == 'dev'
-Requires-Dist: ruff>=0.14.10; extra == 'dev'
-Requires-Dist: taskipy>=1.14.1; extra == 'dev'
-Requires-Dist: twine>=6.2.0; extra == 'dev'
-Requires-Dist: ty>=0.0.11; extra == 'dev'
 Description-Content-Type: text/markdown
 
 # asimpy
@@ -30,7 +19,6 @@ A simple discrete event simulation framework in Python using `async`/`await`.
 -   [Documentation][docs]
 -   [Package][package]
 -   [Repository][repo]
--   [Examples][examples]
 
 *Thanks to the creators of [SimPy][simpy] for inspiration.*
 
@@ -234,8 +222,7 @@ The sequence of events is:
 | FirstOf succeeds with winner              | q1=[], q2=["B"]    | _value=("a","A"), _triggered=True       | Processes waiting on FirstOf resumed             | `Tester` receives ("a","A")                               |
 | `Tester` continues execution              | q1=[], q2=["B"]    | -                                       | -                                                | Remaining queue items untouched; correct order guaranteed |
 
-[docs]: https://gvwilson.github.io/asimpy
-[examples]: https://gvwilson.github.io/asimpy/examples/
+[docs]: https://asimpy.readthedocs.io/
 [package]: https://pypi.org/project/asimpy/
 [repo]: https://github.com/gvwilson/asimpy
 [simpy]: https://simpy.readthedocs.io/

{asimpy-0.4.1 → asimpy-0.5.0}/README.md

@@ -5,7 +5,6 @@ A simple discrete event simulation framework in Python using `async`/`await`.
 -   [Documentation][docs]
 -   [Package][package]
 -   [Repository][repo]
--   [Examples][examples]
 
 *Thanks to the creators of [SimPy][simpy] for inspiration.*
 
@@ -209,8 +208,7 @@ The sequence of events is:
 | FirstOf succeeds with winner              | q1=[], q2=["B"]    | _value=("a","A"), _triggered=True       | Processes waiting on FirstOf resumed             | `Tester` receives ("a","A")                               |
 | `Tester` continues execution              | q1=[], q2=["B"]    | -                                       | -                                                | Remaining queue items untouched; correct order guaranteed |
 
-[docs]: https://gvwilson.github.io/asimpy
-[examples]: https://gvwilson.github.io/asimpy/examples/
+[docs]: https://asimpy.readthedocs.io/
 [package]: https://pypi.org/project/asimpy/
 [repo]: https://github.com/gvwilson/asimpy
 [simpy]: https://simpy.readthedocs.io/

{asimpy-0.4.1 → asimpy-0.5.0}/docs/index.html

@@ -1109,10 +1109,9 @@
 <h1 id="asimpy">asimpy</h1>
 <p>A simple discrete event simulation framework in Python using <code>async</code>/<code>await</code>.</p>
 <ul>
-<li><a href="https://gvwilson.github.io/asimpy">Documentation</a></li>
+<li><a href="https://asimpy.readthedocs.io/">Documentation</a></li>
 <li><a href="https://pypi.org/project/asimpy/">Package</a></li>
 <li><a href="https://github.com/gvwilson/asimpy">Repository</a></li>
-<li><a href="https://gvwilson.github.io/asimpy/examples/">Examples</a></li>
 </ul>
 <p><em>Thanks to the creators of <a href="https://simpy.readthedocs.io/">SimPy</a> for inspiration.</em></p>
 <h2 id="what-this-is">What This Is</h2>

{asimpy-0.4.1 → asimpy-0.5.0}/docs/reference/allof/index.html

@@ -1117,7 +1117,7 @@
                 <code>env</code>
             </td>
             <td>
-                  <code><span title="asimpy.environment.Environment">Environment</span></code>
+                  <code><a class="autorefs autorefs-internal" title="Environment (asimpy.environment.Environment)" href="../environment/#asimpy.environment.Environment">Environment</a></code>
             </td>
             <td>
               <div class="doc-md-description">

{asimpy-0.4.1 → asimpy-0.5.0}/docs/reference/barrier/index.html

@@ -1143,7 +1143,7 @@
                 <code>env</code>
             </td>
             <td>
-                  <code><span title="asimpy.environment.Environment">Environment</span></code>
+                  <code><a class="autorefs autorefs-internal" title="Environment (asimpy.environment.Environment)" href="../environment/#asimpy.environment.Environment">Environment</a></code>
             </td>
             <td>
               <div class="doc-md-description">

{asimpy-0.4.1 → asimpy-0.5.0}/docs/reference/environment/index.html

@@ -462,6 +462,17 @@
     </span>
   </a>
   
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#asimpy.environment.Environment" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        Environment
+      
+    </span>
+  </a>
+  
 </li>
       
     </ul>
@@ -875,6 +886,17 @@
     </span>
   </a>
   
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#asimpy.environment.Environment" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        Environment
+      
+    </span>
+  </a>
+  
 </li>
       
     </ul>
@@ -924,6 +946,119 @@
 
 
 
+<div class="doc doc-object doc-class">
+
+
+
+<h2 id="asimpy.environment.Environment" class="doc doc-heading">
+            <code>Environment</code>
+
+
+</h2>
+
+
+    <div class="doc doc-contents ">
+
+
+
+        <p>Simulation environment.</p>
+
+
+
+
+
+
+
+
+              <details class="mkdocstrings-source">
+                <summary>Source code in <code>src/asimpy/environment.py</code></summary>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">12</span>
+<span class="normal">13</span>
+<span class="normal">14</span>
+<span class="normal">15</span>
+<span class="normal">16</span>
+<span class="normal">17</span>
+<span class="normal">18</span>
+<span class="normal">19</span>
+<span class="normal">20</span>
+<span class="normal">21</span>
+<span class="normal">22</span>
+<span class="normal">23</span>
+<span class="normal">24</span>
+<span class="normal">25</span>
+<span class="normal">26</span>
+<span class="normal">27</span>
+<span class="normal">28</span>
+<span class="normal">29</span>
+<span class="normal">30</span>
+<span class="normal">31</span>
+<span class="normal">32</span>
+<span class="normal">33</span>
+<span class="normal">34</span>
+<span class="normal">35</span>
+<span class="normal">36</span>
+<span class="normal">37</span>
+<span class="normal">38</span>
+<span class="normal">39</span>
+<span class="normal">40</span>
+<span class="normal">41</span>
+<span class="normal">42</span>
+<span class="normal">43</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">class</span><span class="w"> </span><span class="nc">Environment</span><span class="p">:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Simulation environment.&quot;&quot;&quot;</span>
+
+    <span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">logging</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">_now</span> <span class="o">=</span> <span class="mi">0</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">_logging</span> <span class="o">=</span> <span class="n">logging</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">_pending</span> <span class="o">=</span> <span class="p">[]</span>
+
+    <span class="nd">@property</span>
+    <span class="k">def</span><span class="w"> </span><span class="nf">now</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_now</span>
+
+    <span class="k">def</span><span class="w"> </span><span class="nf">schedule</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">time</span><span class="p">,</span> <span class="n">callback</span><span class="p">):</span>
+        <span class="n">heapq</span><span class="o">.</span><span class="n">heappush</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_pending</span><span class="p">,</span> <span class="n">_Pending</span><span class="p">(</span><span class="n">time</span><span class="p">,</span> <span class="n">callback</span><span class="p">))</span>
+
+    <span class="k">def</span><span class="w"> </span><span class="nf">timeout</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">delay</span><span class="p">):</span>
+        <span class="k">return</span> <span class="n">Timeout</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">delay</span><span class="p">)</span>
+
+    <span class="k">def</span><span class="w"> </span><span class="nf">run</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">until</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+        <span class="k">while</span> <span class="bp">self</span><span class="o">.</span><span class="n">_pending</span><span class="p">:</span>
+            <span class="n">pending</span> <span class="o">=</span> <span class="n">heapq</span><span class="o">.</span><span class="n">heappop</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_pending</span><span class="p">)</span>
+            <span class="k">if</span> <span class="n">until</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">pending</span><span class="o">.</span><span class="n">time</span> <span class="o">&gt;</span> <span class="n">until</span><span class="p">:</span>
+                <span class="k">break</span>
+            <span class="n">result</span> <span class="o">=</span> <span class="n">pending</span><span class="o">.</span><span class="n">callback</span><span class="p">()</span>
+            <span class="k">if</span> <span class="p">(</span><span class="n">result</span> <span class="ow">is</span> <span class="ow">not</span> <span class="n">NO_TIME</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="n">pending</span><span class="o">.</span><span class="n">time</span> <span class="o">&gt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">_now</span><span class="p">):</span>
+                <span class="bp">self</span><span class="o">.</span><span class="n">_now</span> <span class="o">=</span> <span class="n">pending</span><span class="o">.</span><span class="n">time</span>
+
+    <span class="k">def</span><span class="w"> </span><span class="nf">_immediate</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">callback</span><span class="p">):</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">schedule</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_now</span><span class="p">,</span> <span class="n">callback</span><span class="p">)</span>
+
+    <span class="k">def</span><span class="w"> </span><span class="fm">__str__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+        <span class="k">return</span> <span class="sa">f</span><span class="s2">&quot;Env(t=</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">_now</span><span class="si">}</span><span class="s2">)&quot;</span>
+</code></pre></div></td></tr></table></div>
+              </details>
+
+
+
+<div class="doc doc-children">
+
+
+
+
+
+
+
+
+
+
+
+
+  </div>
+
+    </div>
+
+</div>
+
 
 
 

{asimpy-0.4.1 → asimpy-0.5.0}/docs/reference/event/index.html

@@ -490,6 +490,17 @@
     </span>
   </a>
   
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#asimpy.event.NO_TIME" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        NO_TIME
+      
+    </span>
+  </a>
+  
 </li>
       
         <li class="md-nav__item">
@@ -925,6 +936,17 @@
     </span>
   </a>
   
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#asimpy.event.NO_TIME" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        NO_TIME
+      
+    </span>
+  </a>
+  
 </li>
       
         <li class="md-nav__item">
@@ -1022,6 +1044,28 @@
 
 
 
+<div class="doc doc-object doc-attribute">
+
+
+
+<h2 id="asimpy.event.NO_TIME" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">NO_TIME</span> <span class="o">=</span> <span class="nb">object</span><span class="p">()</span></code>
+
+  <span class="doc doc-labels">
+      <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small>
+  </span>
+
+</h2>
+
+
+    <div class="doc doc-contents ">
+
+        <p>Sentinel indicating that time should not advance.</p>
+
+    </div>
+
+</div>
+
 
 
 <div class="doc doc-object doc-class">
@@ -1050,11 +1094,7 @@
 
               <details class="mkdocstrings-source">
                 <summary>Source code in <code>src/asimpy/event.py</code></summary>
-                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"> 9</span>
-<span class="normal">10</span>
-<span class="normal">11</span>
-<span class="normal">12</span>
-<span class="normal">13</span>
+                <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">13</span>
 <span class="normal">14</span>
 <span class="normal">15</span>
 <span class="normal">16</span>
@@ -1099,7 +1139,11 @@
 <span class="normal">55</span>
 <span class="normal">56</span>
 <span class="normal">57</span>
-<span class="normal">58</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">class</span><span class="w"> </span><span class="nc">Event</span><span class="p">:</span>
+<span class="normal">58</span>
+<span class="normal">59</span>
+<span class="normal">60</span>
+<span class="normal">61</span>
+<span class="normal">62</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">class</span><span class="w"> </span><span class="nc">Event</span><span class="p">:</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;Manage an event.&quot;&quot;&quot;</span>
 
     <span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">env</span><span class="p">:</span> <span class="s2">&quot;Environment&quot;</span><span class="p">):</span>
@@ -1195,7 +1239,7 @@
                 <code>env</code>
             </td>
             <td>
-                  <code><span title="asimpy.environment.Environment">Environment</span></code>
+                  <code><a class="autorefs autorefs-internal" title="Environment (asimpy.environment.Environment)" href="../environment/#asimpy.environment.Environment">Environment</a></code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -1212,11 +1256,7 @@
 
             <details class="mkdocstrings-source">
               <summary>Source code in <code>src/asimpy/event.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">12</span>
-<span class="normal">13</span>
-<span class="normal">14</span>
-<span class="normal">15</span>
-<span class="normal">16</span>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">16</span>
 <span class="normal">17</span>
 <span class="normal">18</span>
 <span class="normal">19</span>
@@ -1224,7 +1264,11 @@
 <span class="normal">21</span>
 <span class="normal">22</span>
 <span class="normal">23</span>
-<span class="normal">24</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">env</span><span class="p">:</span> <span class="s2">&quot;Environment&quot;</span><span class="p">):</span>
+<span class="normal">24</span>
+<span class="normal">25</span>
+<span class="normal">26</span>
+<span class="normal">27</span>
+<span class="normal">28</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">env</span><span class="p">:</span> <span class="s2">&quot;Environment&quot;</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Construct a new event.</span>
 
@@ -1259,14 +1303,14 @@
 
             <details class="mkdocstrings-source">
               <summary>Source code in <code>src/asimpy/event.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">41</span>
-<span class="normal">42</span>
-<span class="normal">43</span>
-<span class="normal">44</span>
-<span class="normal">45</span>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">45</span>
 <span class="normal">46</span>
 <span class="normal">47</span>
-<span class="normal">48</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">cancel</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<span class="normal">48</span>
+<span class="normal">49</span>
+<span class="normal">50</span>
+<span class="normal">51</span>
+<span class="normal">52</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">cancel</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;Cancel event.&quot;&quot;&quot;</span>
     <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_triggered</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">_cancelled</span><span class="p">:</span>
         <span class="k">return</span>
@@ -1327,11 +1371,7 @@
 
             <details class="mkdocstrings-source">
               <summary>Source code in <code>src/asimpy/event.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">26</span>
-<span class="normal">27</span>
-<span class="normal">28</span>
-<span class="normal">29</span>
-<span class="normal">30</span>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">30</span>
 <span class="normal">31</span>
 <span class="normal">32</span>
 <span class="normal">33</span>
@@ -1340,7 +1380,11 @@
 <span class="normal">36</span>
 <span class="normal">37</span>
 <span class="normal">38</span>
-<span class="normal">39</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">succeed</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">:</span> <span class="n">Any</span> <span class="o">=</span> <span class="kc">None</span><span class="p">):</span>
+<span class="normal">39</span>
+<span class="normal">40</span>
+<span class="normal">41</span>
+<span class="normal">42</span>
+<span class="normal">43</span></pre></div></td><td class="code"><div><pre><span></span><code><span class="k">def</span><span class="w"> </span><span class="nf">succeed</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">:</span> <span class="n">Any</span> <span class="o">=</span> <span class="kc">None</span><span class="p">):</span>
 <span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">    Handle case of event succeeding.</span>
 

{asimpy-0.4.1 → asimpy-0.5.0}/docs/reference/firstof/index.html

@@ -1129,7 +1129,7 @@
                 <code>env</code>
             </td>
             <td>
-                  <code><span title="asimpy.environment.Environment">Environment</span></code>
+                  <code><a class="autorefs autorefs-internal" title="Environment (asimpy.environment.Environment)" href="../environment/#asimpy.environment.Environment">Environment</a></code>
             </td>
             <td>
               <div class="doc-md-description">

{asimpy-0.4.1 → asimpy-0.5.0}/docs/reference/process/index.html

@@ -1347,7 +1347,7 @@
                 <code>env</code>
             </td>
             <td>
-                  <code><span title="asimpy.environment.Environment">Environment</span></code>
+                  <code><a class="autorefs autorefs-internal" title="Environment (asimpy.environment.Environment)" href="../environment/#asimpy.environment.Environment">Environment</a></code>
             </td>
             <td>
               <div class="doc-md-description">

{asimpy-0.4.1 → asimpy-0.5.0}/docs/reference/resource/index.html

@@ -1217,7 +1217,7 @@
                 <code>env</code>
             </td>
             <td>
-                  <code><span title="asimpy.environment.Environment">Environment</span></code>
+                  <code><a class="autorefs autorefs-internal" title="Environment (asimpy.environment.Environment)" href="../environment/#asimpy.environment.Environment">Environment</a></code>
             </td>
             <td>
               <div class="doc-md-description">