<div dir="ltr">Hi Walter,<div><br></div><div>Thank you for your help with the terminology.<br><div><br></div><div>You're right, a side-by-side view of blocks and python code is very demanding, not just in terms of implementing it, but also during run time.  We would have to capture every modification to either side and transform the code back and forth a lot.  Probably I should leave that for a future project.</div>
<div style>But I will keep it in mind and regard the export funtionality as part of a bigger project with this side-by-side view as its goal.  That gives me some guidance for upcoming design decisions.</div><div style><br>
</div><div style>As I'm working on my project proposal, I came accross SugarLab's application template:</div><div style><a href="http://www.google-melange.com/gsoc/org/google/gsoc2013/sugarlabs2013">http://www.google-melange.com/gsoc/org/google/gsoc2013/sugarlabs2013</a><br>
</div><div style>Point 1 under "YOU AND THE COMMUNITY" asks for the impact of my project on the SugarLabs community.  It says I should give my own answer plus two from the community.  Would you mind giving me yours?  And how can I get other community members to answer this question for me?  Shall I use this mailing list or another, or IRC?</div>
<div style><br></div><div style>I would also like to know whether I need a full development environment of Sugar set up, since I only work on one activity.  The template requires it in point 1 under "Miscellaneous".</div>
<div style><br></div><div style>As a rough outline of my schedule, do you think the following is realistic and in accordance with the requirements/ guidelines?</div><div style>3 weeks: determine what code needs to be shared by TurtleArt and the exported code, and restructure the modules to isolate this part</div>
<div style>3 weeks: get first transformation from a block to python code working (only for one or a few example blocks)</div><div style>midterm evaluation</div><div style>6 weeks: transformations of all other blocks to python code</div>
<div style><br></div><div style>Regarding the missing documentation, maybe I can fill some gaps while I get familiar with the code before the coding phase starts.  I know that this is harder to do once you are familiar with the code because then you suddenly take lots of things for granted that would need to be explained.</div>
<div style><br></div><div style>Thank you.</div><div style>Marion</div><div><br><div class="gmail_extra"><br><div class="gmail_quote">2013/4/28 Walter Bender <span dir="ltr"><<a href="mailto:walter.bender@gmail.com" target="_blank">walter.bender@gmail.com</a>></span><br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">
<div class="im">On Sat, Apr 27, 2013 at 5:58 PM, Marion Zepf <span dir="ltr"><<a href="mailto:marion.zepf@gmail.com" target="_blank">marion.zepf@gmail.com</a>></span> wrote:<br>
</div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div dir="ltr">Hi Walter,<div><br></div><div class="im">
<div>Sorry I always take so long to answer.  I'm planning to devote more time to this project in the coming weeks.<br>
</div></div></div></blockquote><div><br></div><div>No problem. I've been busy too.<br> <br></div><div class="im"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<div dir="ltr"><div><div>
<div><div><br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<span style="font-family:arial,sans-serif;font-size:12px">I think the code should run standalone, but it will require importing some modules from turtlebloicks. The idea would be to refactor turtleblocks to be able to use those same modules.</span></blockquote>


</div><div><span style="font-family:arial,sans-serif;font-size:12px">I'm not sure I understand what you mean by "refactor turtleblocks".  Do you mean the code that's necessary for running exported python code should be put into an extra module for easy importing?  Then it could be shared by the TurtleBlocks code and all exported code.</span></div>

</div></div></div></blockquote><div><br></div></div><div>That is exactly what I had in mind. In part, I want to make the code easier to understand.<br> <br></div><div class="im"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">

<div dir="ltr"><div><div>
<div><br></div><div>Taking this a little farther, what do you expect users to do with the exported code?  Of course, it's supposed to help them with the step from block-based programming to writing code in a 'real' programming language.  But how exactly does this export feature achieve that?</div>

</div></div></div></blockquote><div><br></div></div><div>Not really sure. This is somewhat of an experiment.<br> <br></div><div class="im"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<div dir="ltr">
<div><div>
</div><div>My guess would be that the kids would create some code using TurtleBlocks, export it to python code, and have a look at it.  Then they would go back to TurtleBlocks and modify their code to see how that changes the python code.  This way, they would learn the connection between the blocks and the python code step-by-step.  Do you think this is a realistic learning scenario?  If so, I think a side-by-side view of blocks and python code (with instant synchronization between the two) would be more helpful than a simple export feature.</div>

</div></div></blockquote><div><br></div></div><div>You may be correct. I have hesitated to go too far down this path because it is complex and inherently not very robust. That said, it is something we should consider.<br>
<br></div>
<div>There are some other "debugging" options we should explore as well, such as single-stepping through the code, or running the code backwards. (I recently introduced the idea of break points to make debugging easier.) <br>

<br></div><div class="im"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div dir="ltr"><div>
<div><br></div><div>I'm also slowly starting to understand the structure of the code and to find out which parts are relevant to the project I want to do.  I'm a bit confused about the terminology, though.  Could you please explain what primitives, docks, and connections are?  I have already found out that the 'name' attribute of a block specifies which prototype/ template block the user picked from the toolbars to create this block.  But then I'm not sure what the 'type' attribute stands for.  Do you have a dictionary or other documentation of the terminology used in TurtleBlocks somewhere?</div>

</div></div></blockquote><div><br></div></div><div>Other than the inline comments, I've not done a very good job of documenting the internal structure. (Something else we should add to the list.)<br><br></div><div>primitives are the Python code associated with blocks<br>

</div><div>docks and connections are the plumbing: where the blocks connect to one and another to constitute program flow. Connection 0 is always the way into a block; connection n is always the way out of a block. There may be additional (lateral) connections as well.<br>

</div><div>type is used to distinguish between blocks that are part of a program from blocks that are used as prototypes (on the palettes) to make other blocks, or blocks in the trash.<br><br></div><div>Hope that helps.<span class=""><font color="#888888"><br>

<br></font></span></div><span class=""><font color="#888888"><div>-walter <br></div></font></span><div><div class="h5"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<div dir="ltr"><div>
<div><br></div><div>Thank you.</div><span><font color="#888888"><div>Marion</div></font></span></div></div><div><div><div class="gmail_extra"><br><br><div class="gmail_quote">2013/4/24 Walter Bender <span dir="ltr"><<a href="mailto:walter.bender@gmail.com" target="_blank">walter.bender@gmail.com</a>></span><br>


<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">
<div>On Wed, Apr 24, 2013 at 10:43 AM, Marion Zepf <span dir="ltr"><<a href="mailto:marion.zepf@gmail.com" target="_blank">marion.zepf@gmail.com</a>></span> wrote:<br>


<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div dir="ltr">Hi Walter,<div><br></div><div>Thank you for the tips.  I now have a development version of only TurtleBlocks running in GNOME.</div>



<div><br></div><div>I've also had a brief look at tabasics.py and talogo.py.  tabasics is very easy to understand, but I'll probably take a little longer for talogo. </div></div></blockquote><div><br></div></div>


<div>talogo is a bit complex. <br>
</div><div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div dir="ltr"><div> Can I ask you my beginner's questions while I go through it?</div>

</div></blockquote>
<div><br></div></div><div>Sure. <br></div><div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div dir="ltr">

<div><br></div><div>As for the purpose of the project, I was wondering where the generated code is supposed to run.  Is it supposed to be self-contained, so it can be run on other machines that don't have TurtleBlocks installed, or is it supposed to run only in connection with TurtleBlocks?  If the latter is the case, should people include the code via the tamyblock module and the corresponding block, or do we also need conversion from python code back to TurtleBlock internal code?</div>



</div></blockquote><div><br></div></div><div>I think the code should run standalone, but it will require importing some modules from turtlebloicks. The idea would be to refactor turtleblocks to be able to use those same modules.<br>



<br></div><div>regards.<span><font color="#888888"><br><br></font></span></div><span><font color="#888888"><div>-walter<br></div></font></span><div><div><div> <br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">


<div dir="ltr">
<div><br></div><div>Thank you.</div><span><font color="#888888"><div>Marion</div></font></span></div><div><div><div class="gmail_extra"><br><br><div class="gmail_quote">2013/4/21 Walter Bender <span dir="ltr"><<a href="mailto:walter.bender@gmail.com" target="_blank">walter.bender@gmail.com</a>></span><br>




<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">
<div>On Sun, Apr 21, 2013 at 8:07 AM, Marion Zepf <span dir="ltr"><<a href="mailto:marion.zepf@gmail.com" target="_blank">marion.zepf@gmail.com</a>></span> wrote:<br>




<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex"><div dir="ltr">Hi,<div><br>My name is Marion Zepf and I am interested in the project 'Python export functionality for Turtle Blocks'.  Python is my favorite programming language and I often teach programming or other computer skills to my friends and family.  I think it is very important to teach programming to children because it is a very important skill in today's world.  Children are also very keen on playing around with the programming language, which is very important for learning new features of it.  This is why I would like to make the step from block-based programming to writing code easier for them.<div>






<br></div><div>My Background</div></div><div>I am a student of computational linguistics in my 6th semester.  I taught myself Python programming before I went to university.  So, I have three years of experience in writing Python programs of various kinds - from simple command line utilities to GUI applications (using the pygame and tkinter libraries) and code generators for Java code.  I also have strong competence in the object oriented programming paradigm.  I am new to Berkeley Logo, but I learn quickly, so I expect to acquire good Logo skills in a few days.</div>






<div>This will be my first contribution to the open source community.  However, I am familiar with commonly used frameworks and tools like version control software (svn, git), Eclipse IDE, and autotools.</div><div>
I have made myself familiar with the TurtleArt Activity in Sugar On A Stick as well as in the Debian package 'turtleart'.</div><div><br></div><div>Before I start writing my project proposal, I have a few questions about this project:</div>






<div>(1) Which git repositories/ branches should I clone?  I have found a list of repositories on</div><div><a href="http://wiki.sugarlabs.org/go/Development_Team/Source_Code" target="_blank">http://wiki.sugarlabs.org/go/Development_Team/Source_Code</a><br>






</div><div>but I am not sure which ones I need and how to fit them together.</div></div></blockquote><div><br></div></div><div>You can try to get a Sugar environment running [1] or just clone Turtle Blocks itself [2] and run it in GNOME.<br>





 <br></div><div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div>(2) I understand that TurtleArt is written in Python, but the code that users generate by putting together the blocks is in a different, internal language.  Is there documentation available for the syntax and semantics of this language?</div>





</div></blockquote><div><br></div></div><div>Not much to help with there.  There is an OK guide to creating blocks in tabasic.py. The internal parser is talogo.py<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex">





<div dir="ltr">
<div><br></div><div>Thank you.</div><span><font color="#888888"><div>Marion</div></font></span></div>
<br>_______________________________________________<br>
GSoC mailing list<br>
<a href="mailto:GSoC@lists.sugarlabs.org" target="_blank">GSoC@lists.sugarlabs.org</a><br>
<a href="http://lists.sugarlabs.org/listinfo/gsoc" target="_blank">http://lists.sugarlabs.org/listinfo/gsoc</a><br>
<br></blockquote></div><br></div><div class="gmail_extra">regards.<br><br></div><div class="gmail_extra">-walter<br></div><div class="gmail_extra"><br>[1] <a href="http://sugarlabs.org/~buildbot/docs/build.html" target="_blank">http://sugarlabs.org/~buildbot/docs/build.html</a><br>





</div><div class="gmail_extra">[2] <a href="http://git.sugarlabs.org/turtleart" target="_blank">git.sugarlabs.org/turtleart</a><span><font color="#888888"><br clear="all"></font></span></div><span><font color="#888888"><div class="gmail_extra">




<br>-- <br>Walter Bender<br>Sugar Labs<br><a href="http://www.sugarlabs.org" target="_blank">http://www.sugarlabs.org</a><br>

</div></font></span></div>
</blockquote></div><br></div>
</div></div></blockquote></div></div></div><div><div><br><br clear="all"><br>-- <br>Walter Bender<br>Sugar Labs<br><a href="http://www.sugarlabs.org" target="_blank">http://www.sugarlabs.org</a><br>
</div></div></div></div>
</blockquote></div><br></div>
</div></div></blockquote></div></div></div><div><div class="h5"><br><br clear="all"><br>-- <br>Walter Bender<br>Sugar Labs<br><a href="http://www.sugarlabs.org" target="_blank">http://www.sugarlabs.org</a><br>
</div></div></div></div>
</blockquote></div><br></div></div></div></div>