<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="Generator" content="Microsoft Word 14 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
        {font-family:Calibri;
        panose-1:2 15 5 2 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
        {margin:0cm;
        margin-bottom:.0001pt;
        font-size:11.0pt;
        font-family:"Calibri","sans-serif";
        mso-fareast-language:EN-US;}
a:link, span.MsoHyperlink
        {mso-style-priority:99;
        color:blue;
        text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
        {mso-style-priority:99;
        color:purple;
        text-decoration:underline;}
p.MsoListParagraph, li.MsoListParagraph, div.MsoListParagraph
        {mso-style-priority:34;
        margin-top:0cm;
        margin-right:0cm;
        margin-bottom:0cm;
        margin-left:36.0pt;
        margin-bottom:.0001pt;
        font-size:11.0pt;
        font-family:"Calibri","sans-serif";
        mso-fareast-language:EN-US;}
span.EmailStyle17
        {mso-style-type:personal-compose;
        font-family:"Calibri","sans-serif";
        color:windowtext;}
.MsoChpDefault
        {mso-style-type:export-only;
        font-family:"Calibri","sans-serif";
        mso-fareast-language:EN-US;}
@page WordSection1
        {size:612.0pt 792.0pt;
        margin:72.0pt 72.0pt 72.0pt 72.0pt;}
div.WordSection1
        {page:WordSection1;}
/* List Definitions */
@list l0
        {mso-list-id:476845330;
        mso-list-type:hybrid;
        mso-list-template-ids:1614032922 134807569 134807577 134807579 134807567 134807577 134807579 134807567 134807577 134807579;}
@list l0:level1
        {mso-level-text:"%1\)";
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;}
@list l0:level2
        {mso-level-number-format:alpha-lower;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;}
@list l0:level3
        {mso-level-number-format:roman-lower;
        mso-level-tab-stop:none;
        mso-level-number-position:right;
        text-indent:-9.0pt;}
@list l0:level4
        {mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;}
@list l0:level5
        {mso-level-number-format:alpha-lower;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;}
@list l0:level6
        {mso-level-number-format:roman-lower;
        mso-level-tab-stop:none;
        mso-level-number-position:right;
        text-indent:-9.0pt;}
@list l0:level7
        {mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;}
@list l0:level8
        {mso-level-number-format:alpha-lower;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;}
@list l0:level9
        {mso-level-number-format:roman-lower;
        mso-level-tab-stop:none;
        mso-level-number-position:right;
        text-indent:-9.0pt;}
@list l1
        {mso-list-id:488444985;
        mso-list-type:hybrid;
        mso-list-template-ids:1941186194 134807569 134807577 134807579 134807567 134807577 134807579 134807567 134807577 134807579;}
@list l1:level1
        {mso-level-text:"%1\)";
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;}
@list l1:level2
        {mso-level-number-format:alpha-lower;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;}
@list l1:level3
        {mso-level-number-format:roman-lower;
        mso-level-tab-stop:none;
        mso-level-number-position:right;
        text-indent:-9.0pt;}
@list l1:level4
        {mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;}
@list l1:level5
        {mso-level-number-format:alpha-lower;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;}
@list l1:level6
        {mso-level-number-format:roman-lower;
        mso-level-tab-stop:none;
        mso-level-number-position:right;
        text-indent:-9.0pt;}
@list l1:level7
        {mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;}
@list l1:level8
        {mso-level-number-format:alpha-lower;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;}
@list l1:level9
        {mso-level-number-format:roman-lower;
        mso-level-tab-stop:none;
        mso-level-number-position:right;
        text-indent:-9.0pt;}
@list l2
        {mso-list-id:641035709;
        mso-list-type:hybrid;
        mso-list-template-ids:727888576 134807569 134807577 134807579 134807567 134807577 134807579 134807567 134807577 134807579;}
@list l2:level1
        {mso-level-text:"%1\)";
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;}
@list l2:level2
        {mso-level-number-format:alpha-lower;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;}
@list l2:level3
        {mso-level-number-format:roman-lower;
        mso-level-tab-stop:none;
        mso-level-number-position:right;
        text-indent:-9.0pt;}
@list l2:level4
        {mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;}
@list l2:level5
        {mso-level-number-format:alpha-lower;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;}
@list l2:level6
        {mso-level-number-format:roman-lower;
        mso-level-tab-stop:none;
        mso-level-number-position:right;
        text-indent:-9.0pt;}
@list l2:level7
        {mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;}
@list l2:level8
        {mso-level-number-format:alpha-lower;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;}
@list l2:level9
        {mso-level-number-format:roman-lower;
        mso-level-tab-stop:none;
        mso-level-number-position:right;
        text-indent:-9.0pt;}
@list l3
        {mso-list-id:1809279325;
        mso-list-type:hybrid;
        mso-list-template-ids:-371434666 134807575 134807577 134807579 134807567 134807577 134807579 134807567 134807577 134807579;}
@list l3:level1
        {mso-level-number-format:alpha-lower;
        mso-level-text:"%1\)";
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;}
@list l3:level2
        {mso-level-number-format:alpha-lower;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;}
@list l3:level3
        {mso-level-number-format:roman-lower;
        mso-level-tab-stop:none;
        mso-level-number-position:right;
        text-indent:-9.0pt;}
@list l3:level4
        {mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;}
@list l3:level5
        {mso-level-number-format:alpha-lower;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;}
@list l3:level6
        {mso-level-number-format:roman-lower;
        mso-level-tab-stop:none;
        mso-level-number-position:right;
        text-indent:-9.0pt;}
@list l3:level7
        {mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;}
@list l3:level8
        {mso-level-number-format:alpha-lower;
        mso-level-tab-stop:none;
        mso-level-number-position:left;
        text-indent:-18.0pt;}
@list l3:level9
        {mso-level-number-format:roman-lower;
        mso-level-tab-stop:none;
        mso-level-number-position:right;
        text-indent:-9.0pt;}
ol
        {margin-bottom:0cm;}
ul
        {margin-bottom:0cm;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang="EN-GB" link="blue" vlink="purple">
<div class="WordSection1">
<p class="MsoNormal"><span lang="IS">Hi there.<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="IS">I just checked in an addition to the stacklesslib, the async module.<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="IS">See </span><a href="https://bitbucket.org/krisvale/stacklesslib">https://bitbucket.org/krisvale/stacklesslib</a><span lang="IS"><o:p></o:p></span></p>
<p class="MsoNormal"><span lang="IS">This was inspired by the C#async feature, </span>
<a href="http://msdn.microsoft.com/en-us/library/vstudio/hh191443.aspx">http://msdn.microsoft.com/en-us/library/vstudio/hh191443.aspx</a><o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">The module provides two things:<o:p></o:p></p>
<p class="MsoListParagraph" style="text-indent:-18.0pt;mso-list:l0 level1 lfo1"><![if !supportLists]><span lang="IS"><span style="mso-list:Ignore">1)<span style="font:7.0pt "Times New Roman"">     
</span></span></span><![endif]><span lang="IS">A Task class, which represents an execution unit, and functions to create tasks and decorators to help create „task“ functions.<o:p></o:p></span></p>
<p class="MsoListParagraph" style="text-indent:-18.0pt;mso-list:l0 level1 lfo1"><![if !supportLists]><span lang="IS"><span style="mso-list:Ignore">2)<span style="font:7.0pt "Times New Roman"">     
</span></span></span><![endif]><span lang="IS">„Await“ support, through a decorator that automatically passes in an AwaitManager object as the first argument to a function.<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="IS"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="IS"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="IS">It is 2) that I was really gunning for, because it is a cool feature in C# (and VBScript).<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="IS">Basically, in C# you can create a function roughly like this:<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="IS"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="IS"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="IS">int <span style="background:yellow;mso-highlight:yellow">
async</span> fooAsync(string bar)</span><span lang="IS"> </span><span lang="EN-US">{<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">    Task  task = loadFormWebAsync(bar);<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">    do_other_stuff();<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">    data = <span style="background:yellow;mso-highlight:yellow">
await</span> task;<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">    return do_stuff_with_data();<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">and call it using:<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">void caller() {<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">    Task t = fooAsync(“stuff”);<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">    do_other_stuff();<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">    int result = t.get_result();<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">}<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">The magic with the await keyword (only in an async method) is this:<o:p></o:p></span></p>
<p class="MsoListParagraph" style="text-indent:-18.0pt;mso-list:l2 level1 lfo3"><![if !supportLists]><span lang="EN-US"><span style="mso-list:Ignore">1)<span style="font:7.0pt "Times New Roman"">     
</span></span></span><![endif]><span lang="EN-US">When the async method is invoked, (as in the first line in “caller” above) execution immediately continues in the async method in the same thread.  It is just like a function call,
<u>until</u> the async  method calls “await” for a Task object.<o:p></o:p></span></p>
<p class="MsoListParagraph" style="text-indent:-18.0pt;mso-list:l2 level1 lfo3"><![if !supportLists]><span lang="EN-US"><span style="mso-list:Ignore">2)<span style="font:7.0pt "Times New Roman"">     
</span></span></span><![endif]><span lang="EN-US">at this point, execution <u>resumes</u> in the caller, and the rest of the async method will execute as a continuation when task it is waiting on completes.<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">What this means is that execution is depth-first with no context switches until they are actually required.  the C# compiler will generate helper code to to this and post continuation callbacks to the Task objects and
 so on.<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">In stacklesslib, I’m experimenting with doing similar things with explicit task scheduling<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">from stacklesslib import async<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">@async.async<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">def fooAsync(awaiter, arg1, arg2):<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">    t1  = getSomeOtherTask(arg1)<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">    t2  = getSomeOtherTask(arg2)<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">    do_some_other_work()<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">    return awaiter.await(t1) + awaiter(t2)<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">def caller():<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">    t = fooAsync(“foo”, “bar”)<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">    # fooAsync has now run up to its first “await”<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">    r = t.get_result()<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">    # fooAsync has not completed.<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">Stackless has no continuations anymore, so fooAsync is actually run entirely as a new tasklet, but we use explicit switching to run it, and to jump back to the caller.  Stackless actually lacks a tasklet.switch() argument,
 or perhaps, tasklet.run(remove=True) which runs a target tasklet, and removes the previous one from the scheduler in an atomic operation.  I may add that later, since it is a useful building block.<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">The task based structure is also cool, and there are primitives to wait for all tasks, or any task, and to create Task on worker tasklets or worker thread.<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">@async.task(async.threadTaskFactory)<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">def httpJob(url):<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">    return urllib.download_url(url)<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">@async.task(async.taskletTaskFactory):<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">def executeWithDelay(delay, callable):<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">    stacklesslib.main.sleep(delay)<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US">    return callable()<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="DE">def caller():<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="DE">    t1 = httpJob(“myurl”)<o:p></o:p></span></p>
<p class="MsoNormal">    t2 = executeWithDelay(0.1, (lambda:print“hi“))<o:p></o:p></p>
<p class="MsoNormal">    #wait for all of them:<o:p></o:p></p>
<p class="MsoNormal"><span lang="DE">    async.Task.waitAll([t1, t2])<o:p></o:p></span></p>
<p class="MsoNormal">    assert t1.ready and t2.ready<o:p></o:p></p>
<p class="MsoNormal">    # or any:<o:p></o:p></p>
<p class="MsoNormal">   which  =    async.Task.waitAny([t1, t2])<o:p></o:p></p>
<p class="MsoNormal">    assert [t1,t2][which].ready<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">    #or create helper jobs that do that:<o:p></o:p></p>
<p class="MsoNormal"><span lang="DE">    t3 = async.Task.whenAll([t1, t2])<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="DE">    t4 = async.Task.whenAny([t1, t2])<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="DE"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="DE"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="DE"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="DE"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="DE">Thoughts:<o:p></o:p></span></p>
<p class="MsoListParagraph" style="text-indent:-18.0pt;mso-list:l1 level1 lfo4"><![if !supportLists]><span style="mso-list:Ignore">1)<span style="font:7.0pt "Times New Roman"">     
</span></span><![endif]>is the „await“ behavioru useful, i.e. depth first execution until blocking?  It makes sense in c# because it does not involve threads.<o:p></o:p></p>
<p class="MsoListParagraph" style="text-indent:-18.0pt;mso-list:l1 level1 lfo4"><![if !supportLists]><span style="mso-list:Ignore">2)<span style="font:7.0pt "Times New Roman"">     
</span></span><![endif]>What about the names of classes, modules, functions?<o:p></o:p></p>
<p class="MsoListParagraph" style="text-indent:-18.0pt;mso-list:l1 level1 lfo4"><![if !supportLists]><span style="mso-list:Ignore">3)<span style="font:7.0pt "Times New Roman"">     
</span></span><![endif]>whenAny, whenAll, waitAny, waitAll are currently Task static methods.  This is copied from the C# “Task” class, but it may be un-pythonic.  Perhaps just global functions in the module?<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Anyway, see if you think this is interesting.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Cheers,<o:p></o:p></p>
<p class="MsoNormal">K<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
</body>
</html>