Skip to content

Commit 3496d36

Browse files
AlexanderWells-diamondAlexanderWells-diamond
committed
deploy: dad702c 
1 parent 6e81111 commit 3496d36

23 files changed

Lines changed: 48 additions & 48 deletions

‎master/.buildinfo‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
# Sphinx build info version 1
22
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
3-
config: 346d7cfe43e31f28d60aed339fd6e6e6
3+
config: 32b519292b81778488b1942ec76ad27a
44
tags: 645f666f9bcd5a90fca523b33c5a78b7

‎master/.doctrees/environment.pickle‎

35.1 KB
Binary file not shown.

‎master/_modules/epicsdbbuilder/recordbase.html‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
<head>
44
<meta charset="utf-8" />
55
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
6-
<title>epicsdbbuilder.recordbase &mdash; pythonSoftIOC 4.3.0+7.g07b1168 documentation</title>
6+
<title>epicsdbbuilder.recordbase &mdash; pythonSoftIOC 4.4.0+1.gdad702c documentation</title>
77
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
88
<link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
99
<link rel="stylesheet" href="../../_static/theme_overrides.css" type="text/css" />

‎master/_modules/index.html‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
<head>
44
<meta charset="utf-8" />
55
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
6-
<title>Overview: module code &mdash; pythonSoftIOC 4.3.0+7.g07b1168 documentation</title>
6+
<title>Overview: module code &mdash; pythonSoftIOC 4.4.0+1.gdad702c documentation</title>
77
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
88
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
99
<link rel="stylesheet" href="../_static/theme_overrides.css" type="text/css" />

‎master/_modules/softioc/asyncio_dispatcher.html‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
<head>
44
<meta charset="utf-8" />
55
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
6-
<title>softioc.asyncio_dispatcher &mdash; pythonSoftIOC 4.3.0+7.g07b1168 documentation</title>
6+
<title>softioc.asyncio_dispatcher &mdash; pythonSoftIOC 4.4.0+1.gdad702c documentation</title>
77
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
88
<link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
99
<link rel="stylesheet" href="../../_static/theme_overrides.css" type="text/css" />

‎master/_modules/softioc/builder.html‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
<head>
44
<meta charset="utf-8" />
55
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
6-
<title>softioc.builder &mdash; pythonSoftIOC 4.3.0+7.g07b1168 documentation</title>
6+
<title>softioc.builder &mdash; pythonSoftIOC 4.4.0+1.gdad702c documentation</title>
77
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
88
<link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
99
<link rel="stylesheet" href="../../_static/theme_overrides.css" type="text/css" />

‎master/_modules/softioc/device.html‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
<head>
44
<meta charset="utf-8" />
55
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
6-
<title>softioc.device &mdash; pythonSoftIOC 4.3.0+7.g07b1168 documentation</title>
6+
<title>softioc.device &mdash; pythonSoftIOC 4.4.0+1.gdad702c documentation</title>
77
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
88
<link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
99
<link rel="stylesheet" href="../../_static/theme_overrides.css" type="text/css" />

‎master/_modules/softioc/softioc.html‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
<head>
44
<meta charset="utf-8" />
55
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
6-
<title>softioc.softioc &mdash; pythonSoftIOC 4.3.0+7.g07b1168 documentation</title>
6+
<title>softioc.softioc &mdash; pythonSoftIOC 4.4.0+1.gdad702c documentation</title>
77
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
88
<link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
99
<link rel="stylesheet" href="../../_static/theme_overrides.css" type="text/css" />

‎master/_static/documentation_options.js‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
var DOCUMENTATION_OPTIONS = {
22
URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'),
3-
VERSION: '4.3.0+7.g07b1168',
3+
VERSION: '4.4.0+1.gdad702c',
44
LANGUAGE: 'None',
55
COLLAPSE_INDEX: false,
66
BUILDER: 'html',

‎master/explanations/asyncio-cothread-differences.html‎

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
55

66
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
7-
<title>What are the differences between asyncio and cothread? &mdash; pythonSoftIOC 4.3.0+7.g07b1168 documentation</title>
7+
<title>What are the differences between asyncio and cothread? &mdash; pythonSoftIOC 4.4.0+1.gdad702c documentation</title>
88
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
99
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
1010
<link rel="stylesheet" href="../_static/theme_overrides.css" type="text/css" />
@@ -98,8 +98,8 @@
9898
<div itemprop="articleBody">
9999

100100
<section id="what-are-the-differences-between-asyncio-and-cothread">
101-
<h1>What are the differences between <a class="reference external" href="https://docs.python.org/3/library/asyncio.html#module-asyncio" title="(in Python v3.11)"><code class="xref any docutils literal notranslate"><span class="pre">asyncio</span></code></a> and <a class="reference external" href="https://cothread.readthedocs.io/en/stable/cothread.html#module-cothread" title="(in Cothread)"><code class="xref any docutils literal notranslate"><span class="pre">cothread</span></code></a>?<a class="headerlink" href="#what-are-the-differences-between-asyncio-and-cothread" title="Permalink to this headline"></a></h1>
102-
<p>There are two concurrency frameworks that pythonSoftIOC supports, <a class="reference external" href="https://docs.python.org/3/library/asyncio.html#module-asyncio" title="(in Python v3.11)"><code class="xref any docutils literal notranslate"><span class="pre">asyncio</span></code></a> and
101+
<h1>What are the differences between <a class="reference external" href="https://docs.python.org/3/library/asyncio.html#module-asyncio" title="(in Python v3.12)"><code class="xref any docutils literal notranslate"><span class="pre">asyncio</span></code></a> and <a class="reference external" href="https://cothread.readthedocs.io/en/stable/cothread.html#module-cothread" title="(in Cothread)"><code class="xref any docutils literal notranslate"><span class="pre">cothread</span></code></a>?<a class="headerlink" href="#what-are-the-differences-between-asyncio-and-cothread" title="Permalink to this headline"></a></h1>
102+
<p>There are two concurrency frameworks that pythonSoftIOC supports, <a class="reference external" href="https://docs.python.org/3/library/asyncio.html#module-asyncio" title="(in Python v3.12)"><code class="xref any docutils literal notranslate"><span class="pre">asyncio</span></code></a> and
103103
<a class="reference external" href="https://cothread.readthedocs.io/en/stable/cothread.html#module-cothread" title="(in Cothread)"><code class="xref any docutils literal notranslate"><span class="pre">cothread</span></code></a>. This page details the differences between them and reasons why you
104104
should use one over the other</p>
105105
<div class="admonition seealso">
@@ -123,7 +123,7 @@ <h2>The Similarities<a class="headerlink" href="#the-similarities" title="Permal
123123
<h2>The Differences<a class="headerlink" href="#the-differences" title="Permalink to this headline"></a></h2>
124124
<p>The main difference between the libraries is how a coroutine yields control.</p>
125125
<ul class="simple">
126-
<li><p><a class="reference external" href="https://docs.python.org/3/library/asyncio.html#module-asyncio" title="(in Python v3.11)"><code class="xref any docutils literal notranslate"><span class="pre">asyncio</span></code></a> uses an <code class="docutils literal notranslate"><span class="pre">async</span> <span class="pre">def</span></code> which will yield control when they <code class="docutils literal notranslate"><span class="pre">await</span></code>.
126+
<li><p><a class="reference external" href="https://docs.python.org/3/library/asyncio.html#module-asyncio" title="(in Python v3.12)"><code class="xref any docutils literal notranslate"><span class="pre">asyncio</span></code></a> uses an <code class="docutils literal notranslate"><span class="pre">async</span> <span class="pre">def</span></code> which will yield control when they <code class="docutils literal notranslate"><span class="pre">await</span></code>.
127127
Only an <code class="docutils literal notranslate"><span class="pre">async</span> <span class="pre">def</span></code> can <code class="docutils literal notranslate"><span class="pre">await</span></code> another <code class="docutils literal notranslate"><span class="pre">async</span> <span class="pre">def</span></code>, so functions that
128128
yield control are explicitly marked as such by the presence of the <code class="docutils literal notranslate"><span class="pre">async</span></code>
129129
keyword.</p></li>
@@ -171,17 +171,17 @@ <h2>The Differences<a class="headerlink" href="#the-differences" title="Permalin
171171
<h2>Which to use<a class="headerlink" href="#which-to-use" title="Permalink to this headline"></a></h2>
172172
<p>There are some questions to ask to help you choose which one to use:</p>
173173
<ul class="simple">
174-
<li><p>If you run python2.7 then you need to use <a class="reference external" href="https://cothread.readthedocs.io/en/stable/cothread.html#module-cothread" title="(in Cothread)"><code class="xref any docutils literal notranslate"><span class="pre">cothread</span></code></a> as <a class="reference external" href="https://docs.python.org/3/library/asyncio.html#module-asyncio" title="(in Python v3.11)"><code class="xref any docutils literal notranslate"><span class="pre">asyncio</span></code></a> is python3
174+
<li><p>If you run python2.7 then you need to use <a class="reference external" href="https://cothread.readthedocs.io/en/stable/cothread.html#module-cothread" title="(in Cothread)"><code class="xref any docutils literal notranslate"><span class="pre">cothread</span></code></a> as <a class="reference external" href="https://docs.python.org/3/library/asyncio.html#module-asyncio" title="(in Python v3.12)"><code class="xref any docutils literal notranslate"><span class="pre">asyncio</span></code></a> is python3
175175
only</p></li>
176-
<li><p>If you run on Windows then you need <a class="reference external" href="https://docs.python.org/3/library/asyncio.html#module-asyncio" title="(in Python v3.11)"><code class="xref any docutils literal notranslate"><span class="pre">asyncio</span></code></a> as <a class="reference external" href="https://cothread.readthedocs.io/en/stable/cothread.html#module-cothread" title="(in Cothread)"><code class="xref any docutils literal notranslate"><span class="pre">cothread</span></code></a> doesn’t work on
176+
<li><p>If you run on Windows then you need <a class="reference external" href="https://docs.python.org/3/library/asyncio.html#module-asyncio" title="(in Python v3.12)"><code class="xref any docutils literal notranslate"><span class="pre">asyncio</span></code></a> as <a class="reference external" href="https://cothread.readthedocs.io/en/stable/cothread.html#module-cothread" title="(in Cothread)"><code class="xref any docutils literal notranslate"><span class="pre">cothread</span></code></a> doesn’t work on
177177
Windows</p></li>
178-
<li><p>If you need to integrate with a library that uses <a class="reference external" href="https://docs.python.org/3/library/asyncio.html#module-asyncio" title="(in Python v3.11)"><code class="xref any docutils literal notranslate"><span class="pre">asyncio</span></code></a> like one from
179-
<a class="reference external" href="https://github.com/aio-libs">aio-libs</a> then use <a class="reference external" href="https://docs.python.org/3/library/asyncio.html#module-asyncio" title="(in Python v3.11)"><code class="xref any docutils literal notranslate"><span class="pre">asyncio</span></code></a></p></li>
178+
<li><p>If you need to integrate with a library that uses <a class="reference external" href="https://docs.python.org/3/library/asyncio.html#module-asyncio" title="(in Python v3.12)"><code class="xref any docutils literal notranslate"><span class="pre">asyncio</span></code></a> like one from
179+
<a class="reference external" href="https://github.com/aio-libs">aio-libs</a> then use <a class="reference external" href="https://docs.python.org/3/library/asyncio.html#module-asyncio" title="(in Python v3.12)"><code class="xref any docutils literal notranslate"><span class="pre">asyncio</span></code></a></p></li>
180180
<li><p>If you need to turn a script using <a class="reference external" href="https://cothread.readthedocs.io/en/stable/catools.html#module-cothread.catools" title="(in Cothread)"><code class="xref any docutils literal notranslate"><span class="pre">cothread.catools</span></code></a> into an IOC then use
181181
<a class="reference external" href="https://cothread.readthedocs.io/en/stable/cothread.html#module-cothread" title="(in Cothread)"><code class="xref any docutils literal notranslate"><span class="pre">cothread</span></code></a></p></li>
182182
</ul>
183183
<p>In general, avoid mixing concurrency frameworks if you can. While it is possible
184-
to mix <a class="reference external" href="https://docs.python.org/3/library/asyncio.html#module-asyncio" title="(in Python v3.11)"><code class="xref any docutils literal notranslate"><span class="pre">asyncio</span></code></a> and <a class="reference external" href="https://cothread.readthedocs.io/en/stable/cothread.html#module-cothread" title="(in Cothread)"><code class="xref any docutils literal notranslate"><span class="pre">cothread</span></code></a>, it’s messy and tricky to get right. Better to
184+
to mix <a class="reference external" href="https://docs.python.org/3/library/asyncio.html#module-asyncio" title="(in Python v3.12)"><code class="xref any docutils literal notranslate"><span class="pre">asyncio</span></code></a> and <a class="reference external" href="https://cothread.readthedocs.io/en/stable/cothread.html#module-cothread" title="(in Cothread)"><code class="xref any docutils literal notranslate"><span class="pre">cothread</span></code></a>, it’s messy and tricky to get right. Better to
185185
keep to one if possible.</p>
186186
</section>
187187
</section>

0 commit comments

Comments
 (0)