€•—      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”Œdocutils.nodes”Œsection”“”)”}”(hhh]”(h	Œtitle”“”)”}”(hŒCThe philosophy behind Transcrypt and its impact on design decisions”h]”h	ŒText”“”ŒCThe philosophy behind Transcrypt and its impact on design decisions”…””}”(hhŒparent”hhhŒsource”NŒline”NubaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”uŒtagname”hhhhhhŒ^/home/jac/active/geatec/transcrypt/Transcrypt/transcrypt/docs/sphinx/philosophy_directions.rst”hKubh)”}”(hhh]”(h)”}”(hŒ$Transcrypt's primary target audience”h]”hŒ&Transcryptâ€™s primary target audience”…””}”(hh1hh/hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hhh,hhhh+hKubh	Œ	paragraph”“”)”}”(hŒ2Transcrypt is written for internet developers who:”h]”hŒ2Transcrypt is written for internet developers who:”…””}”(hhAhh?hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hKhh,hhubh	Œbullet_list”“”)”}”(hhh]”(h	Œ	list_item”“”)”}”(hŒxPrefer Python over JavaScript for the development of complex, yet maintainable web software with minimal lifecycle costs”h]”h>)”}”(hhVh]”hŒxPrefer Python over JavaScript for the development of complex, yet maintainable web software with minimal lifecycle costs”…””}”(hhVhhXubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hK	hhTubah}”(h ]”h"]”h$]”h&]”h(]”uh*hRhhOhhhh+hNubhS)”}”(hŒ]Need their software to be every bit as fast and compact as the native JavaScript counterparts”h]”h>)”}”(hhmh]”hŒ]Need their software to be every bit as fast and compact as the native JavaScript counterparts”…””}”(hhmhhoubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hK
hhkubah}”(h ]”h"]”h$]”h&]”h(]”uh*hRhhOhhhh+hNubhS)”}”(hŒ<Want unrestricted use of any JavaScript library or platform
”h]”h>)”}”(hŒ;Want unrestricted use of any JavaScript library or platform”h]”hŒ;Want unrestricted use of any JavaScript library or platform”…””}”(hhˆhh†ubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hKhh‚ubah}”(h ]”h"]”h$]”h&]”h(]”uh*hRhhOhhhh+hNubeh}”(h ]”h"]”h$]”h&]”h(]”Œbullet”Œ-”uh*hMhh+hK	hh,hhubh>)”}”(hŒrIn this primary target audience there are at least two groups to be distinguished and a third group on the border.”h]”hŒrIn this primary target audience there are at least two groups to be distinguished and a third group on the border.”…””}”(hh¤hh¢hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hKhh,hhubh)”}”(hhh]”(h)”}”(hŒSeasoned Python developers”h]”hŒSeasoned Python developers”…””}”(hhµhh³hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hhh°hhhh+hKubh>)”}”(hXØ  They may be using Python on the server-side (e.g. Django) or in developing computational applications (NumPy, SciPy), or in fact in any area of computing.
These 'pythonistas' value what they've got: A clean, concise, powerful language, able to tackle any IT problem, especially in combination with C++.
When faced with JavaScript in the browser, they experience a frustrating loss of productivity, being bogged down in an organically grown mix of HTML, CSS and JavaScript.”h]”hXÞ  They may be using Python on the server-side (e.g. Django) or in developing computational applications (NumPy, SciPy), or in fact in any area of computing.
These â€˜pythonistasâ€™ value what theyâ€™ve got: A clean, concise, powerful language, able to tackle any IT problem, especially in combination with C++.
When faced with JavaScript in the browser, they experience a frustrating loss of productivity, being bogged down in an organically grown mix of HTML, CSS and JavaScript.”…””}”(hhÃhhÁhhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hKhh°hhubh>)”}”(hŒ8For them the news is that they have more viable options:”h]”hŒ8For them the news is that they have more viable options:”…””}”(hhÑhhÏhhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hKhh°hhubh>)”}”(hX$  Is HTML ok? They can use it. Do they find it restrictive? They can manipulate the underlying object model directly in Python.
Is CSS ok for them? No need to change then. Do they find it utterly confusing, inconsequent, repetitive and static? They can access the underlying style attributes dynamically in Python.
Is JavaScript ok for them? If it ain't broke, don't fix it. Did they already experience that for larger applications the overall structure tends to become messy? They can switch to Python, keeping full access to any JavaScript library.”h]”hX(  Is HTML ok? They can use it. Do they find it restrictive? They can manipulate the underlying object model directly in Python.
Is CSS ok for them? No need to change then. Do they find it utterly confusing, inconsequent, repetitive and static? They can access the underlying style attributes dynamically in Python.
Is JavaScript ok for them? If it ainâ€™t broke, donâ€™t fix it. Did they already experience that for larger applications the overall structure tends to become messy? They can switch to Python, keeping full access to any JavaScript library.”…””}”(hhßhhÝhhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hKhh°hhubh>)”}”(hXa  Recently legitimate worries have surfaced about the JavaScript world becoming more an more fragmented. Transcrypt is not about fragmentation but about unification. It doesn't introduce a new language. It makes a mainstream server side language available for development of client side code, without sacrificing performance, compactness or compatibility.”h]”hXc  Recently legitimate worries have surfaced about the JavaScript world becoming more an more fragmented. Transcrypt is not about fragmentation but about unification. It doesnâ€™t introduce a new language. It makes a mainstream server side language available for development of client side code, without sacrificing performance, compactness or compatibility.”…””}”(hhíhhëhhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hKhh°hhubeh}”(h ]”Œseasoned-python-developers”ah"]”h$]”Œseasoned python developers”ah&]”h(]”uh*h
hh,hhhh+hKubh)”}”(hhh]”(h)”}”(hŒSeasoned JavaScript developers”h]”hŒSeasoned JavaScript developers”…””}”(hj  hj  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hhj  hhhh+hKubh>)”}”(hX>  They may have been using JavaScript for a long time and have accepted its quirks as a fact of life. If it's their first language they will probably not perceive any of its drawbacks as restrictive. But even in that case a part of them will eventually explore other languages, look back and clearly see its limitations.”h]”hX@  They may have been using JavaScript for a long time and have accepted its quirks as a fact of life. If itâ€™s their first language they will probably not perceive any of its drawbacks as restrictive. But even in that case a part of them will eventually explore other languages, look back and clearly see its limitations.”…””}”(hj  hj  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hK!hj  hhubh>)”}”(hX¬  All the talk of speed in JavaScript suddenly becomes irrelevant in the light of using C++ for computation-intensive algorithms. And all the talk about prototypes in fact being superior to class based object orientation suddenly seems to lack substance when real, non-textbook programming experience is gained in a truly class based language rather than one eventually acquiring the keyword 'class' to cover its prototyping guts.”h]”hX°  All the talk of speed in JavaScript suddenly becomes irrelevant in the light of using C++ for computation-intensive algorithms. And all the talk about prototypes in fact being superior to class based object orientation suddenly seems to lack substance when real, non-textbook programming experience is gained in a truly class based language rather than one eventually acquiring the keyword â€˜classâ€™ to cover its prototyping guts.”…””}”(hj"  hj   hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hK#hj  hhubh>)”}”(hX  If these developers are confronted with the need to develop a new, large, complex web application, they may think about software lifecycle costs and decide that it would be best to develop the client side in Python, provided that execution- and page-load performance is fully maintained.”h]”hX  If these developers are confronted with the need to develop a new, large, complex web application, they may think about software lifecycle costs and decide that it would be best to develop the client side in Python, provided that execution- and page-load performance is fully maintained.”…””}”(hj0  hj.  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hK%hj  hhubeh}”(h ]”Œseasoned-javascript-developers”ah"]”h$]”Œseasoned javascript developers”ah&]”h(]”uh*h
hh,hhhh+hKubh)”}”(hhh]”(h)”}”(hŒOther developers”h]”hŒOther developers”…””}”(hjI  hjG  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hhjD  hhhh+hK(ubh>)”}”(hŒ×In this group will be experienced developers who are familiar with C++, C, C#, Java or any other language. But it also includes students of any kind, being serious about a professional IT carreer, but not yet there.”h]”hŒ×In this group will be experienced developers who are familiar with C++, C, C#, Java or any other language. But it also includes students of any kind, being serious about a professional IT carreer, but not yet there.”…””}”(hjW  hjU  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hK*hjD  hhubh>)”}”(hX-  Programming for the web may be new to them, and rather than following the lowest common denominator, they may just as well enter this new world the proper way, respecting the constitution of software design: modularity and thin interfaces, learning to balance loose coupling against internal cohesion.”h]”hX-  Programming for the web may be new to them, and rather than following the lowest common denominator, they may just as well enter this new world the proper way, respecting the constitution of software design: modularity and thin interfaces, learning to balance loose coupling against internal cohesion.”…””}”(hje  hjc  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hK,hjD  hhubh>)”}”(hX<  The fact that it took so long to introduce something simple like a decent module mechanism into JavaScript is a telltale sign of severe underdevelopment in this area. In the vast pool of JavaScript developers there are many that are highly skilled and resourceful, and they have successfully circumvented this restriction by using functions as modules, keeping their local variables and functions alive artificially. But a language having modularisation so low on its priority list, is a less than ideal starting point for acquiring good manners in web application design.”h]”hX<  The fact that it took so long to introduce something simple like a decent module mechanism into JavaScript is a telltale sign of severe underdevelopment in this area. In the vast pool of JavaScript developers there are many that are highly skilled and resourceful, and they have successfully circumvented this restriction by using functions as modules, keeping their local variables and functions alive artificially. But a language having modularisation so low on its priority list, is a less than ideal starting point for acquiring good manners in web application design.”…””}”(hjs  hjq  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hK.hjD  hhubeh}”(h ]”Œother-developers”ah"]”h$]”Œother developers”ah&]”h(]”uh*h
hh,hhhh+hK(ubeh}”(h ]”Œ$transcrypt-s-primary-target-audience”ah"]”h$]”Œ$transcrypt's primary target audience”ah&]”h(]”uh*h
hhhhhh+hKubh)”}”(hhh]”(h)”}”(hŒ&How to best serve this target audience”h]”hŒ&How to best serve this target audience”…””}”(hj”  hj’  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hhj  hhhh+hK2ubh>)”}”(hXÂ  The main point, as with any design, is the willingness to let go of dogmaticism in favor of a good balance.
Starting out from the fact that Transcypt should be 100% CPython compatible would be very clear and unambigous, and in that sense attractive.
However with current technology it's also completely off-limits for any viable real world development, directly competing with JavaScript in the area of speed and compactness.
Users of web applications don't care about technology.
If they have to wait for more than two seconds for a page to load, many of them zap.
If the rest have to wait for more that half a minute, they conclude its time for a browser restart, a modem reset, or a new access provider.”h]”hXÆ  The main point, as with any design, is the willingness to let go of dogmaticism in favor of a good balance.
Starting out from the fact that Transcypt should be 100% CPython compatible would be very clear and unambigous, and in that sense attractive.
However with current technology itâ€™s also completely off-limits for any viable real world development, directly competing with JavaScript in the area of speed and compactness.
Users of web applications donâ€™t care about technology.
If they have to wait for more than two seconds for a page to load, many of them zap.
If the rest have to wait for more that half a minute, they conclude its time for a browser restart, a modem reset, or a new access provider.”…””}”(hj¢  hj   hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hK4hj  hhubh>)”}”(hX  And developers don't care about purism. They cannot afford to paint themselves into a corner but need direct access to the full spectrum of JavaScript libraries and frameworks. Application development is hard enough without extra restrictions posed by your development tools.”h]”hX  And developers donâ€™t care about purism. They cannot afford to paint themselves into a corner but need direct access to the full spectrum of JavaScript libraries and frameworks. Application development is hard enough without extra restrictions posed by your development tools.”…””}”(hj°  hj®  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hK;hj  hhubh>)”}”(hŒ¦It's completely agreed that having native CPython in the browser would be great.
But having JavaScript in between, even as asm.js, unfortunately makes it impractical.”h]”hŒ¨Itâ€™s completely agreed that having native CPython in the browser would be great.
But having JavaScript in between, even as asm.js, unfortunately makes it impractical.”…””}”(hj¾  hj¼  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hK=hj  hhubh>)”}”(hX[  It's completely agreed that many Python developers would like all of their familiar libraries to be avaible.
But the fact that most of them are written in C, makes it equally impractical, since they would load at snail speed in a browser.
Apart from that, for viable web development, unimpeded access to JavaScript libraries is far more important.”h]”hX]  Itâ€™s completely agreed that many Python developers would like all of their familiar libraries to be avaible.
But the fact that most of them are written in C, makes it equally impractical, since they would load at snail speed in a browser.
Apart from that, for viable web development, unimpeded access to JavaScript libraries is far more important.”…””}”(hjÌ  hjÊ  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hK@hj  hhubh>)”}”(hXh  One alternative is to wait from the browser manufacturers to support descents to pure, true assembler, or at least C or C++.
Given the fact that Java was kicked out because of security concerns, it is unlikely that a language without array boundary checks would be allowed in.
And if such checks were added it would be rather slow, though not unuseable per se.”h]”hXh  One alternative is to wait from the browser manufacturers to support descents to pure, true assembler, or at least C or C++.
Given the fact that Java was kicked out because of security concerns, it is unlikely that a language without array boundary checks would be allowed in.
And if such checks were added it would be rather slow, though not unuseable per se.”…””}”(hjÚ  hjØ  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hKDhj  hhubh>)”}”(hX  If ever a fast, compact, browser-native CPython implementation gets developed, with seamless access to the huge investment represented by existing JavaScript libraries, converting from Transcrypt to it will be a snap compared to conversion from JavaScript. So actually Transcrypt, because of its proximity to CPython, is very future-proof, whereas all types of 'better JavaScript' or propietary languages are not. What matters to Transcrypt developers is not Transcrypt's future, but Python's future, which is bright without restriction.”h]”hX!  If ever a fast, compact, browser-native CPython implementation gets developed, with seamless access to the huge investment represented by existing JavaScript libraries, converting from Transcrypt to it will be a snap compared to conversion from JavaScript. So actually Transcrypt, because of its proximity to CPython, is very future-proof, whereas all types of â€˜better JavaScriptâ€™ or propietary languages are not. What matters to Transcrypt developers is not Transcryptâ€™s future, but Pythonâ€™s future, which is bright without restriction.”…””}”(hjè  hjæ  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hKHhj  hhubh>)”}”(hXG  Transcrypt strikes a careful balance between completely implementing CPython including this last 10% which will cause 90% of the bloat on one hand, and being too much restricted by JavaScript's shortcomings without necessity on the other. This balance e.g. means that Python's 'eval' and 'exec' (not to be confused with JavaScript's) are out, and multiple inheritance and selective operator overloading are in.
It means that Transcrypt's and JavaScript's type system are unified, compact, fast and interoperable, rather than stricktly separated, bulky, slow and requiring conversion.”h]”hXY  Transcrypt strikes a careful balance between completely implementing CPython including this last 10% which will cause 90% of the bloat on one hand, and being too much restricted by JavaScriptâ€™s shortcomings without necessity on the other. This balance e.g. means that Pythonâ€™s â€˜evalâ€™ and â€˜execâ€™ (not to be confused with JavaScriptâ€™s) are out, and multiple inheritance and selective operator overloading are in.
It means that Transcryptâ€™s and JavaScriptâ€™s type system are unified, compact, fast and interoperable, rather than stricktly separated, bulky, slow and requiring conversion.”…””}”(hjö  hjô  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hKJhj  hhubh>)”}”(hX  **In short: Transcrypt serves its target audience by allowing them to develop fast, compact, future-proof web applications on clients and servers in one stable, well-established language, running on any platform, minimizing lifecycle costs. Not as a promise, but now.**”h]”h	Œstrong”“”)”}”(hj  h]”hX	  In short: Transcrypt serves its target audience by allowing them to develop fast, compact, future-proof web applications on clients and servers in one stable, well-established language, running on any platform, minimizing lifecycle costs. Not as a promise, but now.”…””}”(hhhj  ubah}”(h ]”h"]”h$]”h&]”h(]”uh*j  hj  ubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hKMhj  hhubeh}”(h ]”Œ&how-to-best-serve-this-target-audience”ah"]”h$]”Œ&how to best serve this target audience”ah&]”h(]”uh*h
hhhhhh+hK2ubh)”}”(hhh]”(h)”}”(hŒKSpecific design choices made for Transcrypt and their underlying motivation”h]”hŒKSpecific design choices made for Transcrypt and their underlying motivation”…””}”(hj(  hj&  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hhj#  hhhh+hKPubh)”}”(hhh]”(h)”}”(hŒ9Why is Transcrypt written in Python and not in JavaScript”h]”hŒ9Why is Transcrypt written in Python and not in JavaScript”…””}”(hj9  hj7  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hhj4  hhhh+hKSubh>)”}”(hXµ  Transcrypt departs from the Python side of things. It is not JavaScript approaching the Python world, but Python approaching the JavaScript world. What enabled this approach, is that the notion of compiling on the fly in the browser was rejected from the start. While this would have enabled things like 'exec' and 'eval' and would have made the compilation process fully transparent, compiling a piece of interpreted code on the fly will always stand in the way of performance. And any compromise with regard to performance was judged to be lethal for accepting Transcrypt as a serious win-win alternative for JavaScript in a world where download size and page-load speed are crucial factors.”h]”hX½  Transcrypt departs from the Python side of things. It is not JavaScript approaching the Python world, but Python approaching the JavaScript world. What enabled this approach, is that the notion of compiling on the fly in the browser was rejected from the start. While this would have enabled things like â€˜execâ€™ and â€˜evalâ€™ and would have made the compilation process fully transparent, compiling a piece of interpreted code on the fly will always stand in the way of performance. And any compromise with regard to performance was judged to be lethal for accepting Transcrypt as a serious win-win alternative for JavaScript in a world where download size and page-load speed are crucial factors.”…””}”(hjG  hjE  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hKUhj4  hhubh>)”}”(hXM  Syntactically speaking, Python isn't as simple as it may seem. Using indentation to indicate blocks has a profoundly positive effect upon the readability of the language, but also creates parsing anomalies. The flexibility with regard to formal and actual function parameters makes parsing even more complex. Developing Transcrypt in Python makes available the original, rock-solid Python parser to do the job fast and concise. And since Transcrypt and Python use the same parser, Python can never syntactically develop into a direction that Transcrypt couldn't follow. To JavaScript developers having '__new__ ()' instead of 'new' may well indeed be new, to Python developers it's just another function call. Given the turmoil created by getting rid of Python's 'print' statement in favour of 'print ()' it wouldn't be wise to introduce another unnecessary syntactic anomaly. Even a __pragma__ syntactically (but not semantically) is just another function call. This approach also facilitates reuse of the existing concise documentation on Python's syntax. Transcrypt syntax == Python syntax. Period.”h]”hXi  Syntactically speaking, Python isnâ€™t as simple as it may seem. Using indentation to indicate blocks has a profoundly positive effect upon the readability of the language, but also creates parsing anomalies. The flexibility with regard to formal and actual function parameters makes parsing even more complex. Developing Transcrypt in Python makes available the original, rock-solid Python parser to do the job fast and concise. And since Transcrypt and Python use the same parser, Python can never syntactically develop into a direction that Transcrypt couldnâ€™t follow. To JavaScript developers having â€˜__new__ ()â€™ instead of â€˜newâ€™ may well indeed be new, to Python developers itâ€™s just another function call. Given the turmoil created by getting rid of Pythonâ€™s â€˜printâ€™ statement in favour of â€˜print ()â€™ it wouldnâ€™t be wise to introduce another unnecessary syntactic anomaly. Even a __pragma__ syntactically (but not semantically) is just another function call. This approach also facilitates reuse of the existing concise documentation on Pythonâ€™s syntax. Transcrypt syntax == Python syntax. Period.”…””}”(hjU  hjS  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hKWhj4  hhubh>)”}”(hX…  And then there's the matter of distribution. Transcrypt is just another Python application, available from PyPi like any other, requiring Python like any other. And its library modules can be distributed via PyPi or any of its successors. It is very well possible to write 'pure Python modules' that run both under CPython and Transcrypt. But the importance of this is, apart from some fundamental modules, limited. For use in the browser, the enormous amount of 'actually existing' JavaScript libraries are far more interesting. And they can be loaded the JavaScript way, either on the fly from a content distribution network, or via 'require'.”h]”hX“  And then thereâ€™s the matter of distribution. Transcrypt is just another Python application, available from PyPi like any other, requiring Python like any other. And its library modules can be distributed via PyPi or any of its successors. It is very well possible to write â€˜pure Python modulesâ€™ that run both under CPython and Transcrypt. But the importance of this is, apart from some fundamental modules, limited. For use in the browser, the enormous amount of â€˜actually existingâ€™ JavaScript libraries are far more interesting. And they can be loaded the JavaScript way, either on the fly from a content distribution network, or via â€˜requireâ€™.”…””}”(hjc  hja  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hKYhj4  hhubh>)”}”(hŒÿFinally there's the efficiency of development of Transcypt itself. Transcrypt was written because programming in Python was very much preferred over programming in JavaScript. So why on earth then would JavaScript be preferred over Python in writing it...”h]”hX  Finally thereâ€™s the efficiency of development of Transcypt itself. Transcrypt was written because programming in Python was very much preferred over programming in JavaScript. So why on earth then would JavaScript be preferred over Python in writing itâ€¦”…””}”(hjq  hjo  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hK[hj4  hhubeh}”(h ]”Œ9why-is-transcrypt-written-in-python-and-not-in-javascript”ah"]”h$]”Œ9why is transcrypt written in python and not in javascript”ah&]”h(]”uh*h
hj#  hhhh+hKSubh)”}”(hhh]”(h)”}”(hŒDWhy does Transcrypt blend Python datatypes with JavaScript datatypes”h]”hŒDWhy does Transcrypt blend Python datatypes with JavaScript datatypes”…””}”(hjŠ  hjˆ  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hhj…  hhhh+hK^ubh>)”}”(hXP  The answer can be short: Compactness, speed and interoperability on the library front. Being able e.g. to interpret {'color': 'red', 'size': 'medium'} both as a JavaScript object and as a Python dictionary save lots of conversions, library encapsulation layers and counterintuitive restrictions. It minize code size and maximizes speed of data exchange between JavaScript and Python. Crucial to making it work is the identifier aliasing mechanism. It facilitates carefree use of Python keywords and identifiers, solving any name clashes with their JavaScript counterparts, now and in the future. It doesn't matter that both Python and JavaScript have a 'strip' method for strings that do different things. Using 'strip' in Python will translate to 'py_strip' and JavaScript's native 'strip' method can be used from Python under the name 'js_strip'.”h]”hXx  The answer can be short: Compactness, speed and interoperability on the library front. Being able e.g. to interpret {â€˜colorâ€™: â€˜redâ€™, â€˜sizeâ€™: â€˜mediumâ€™} both as a JavaScript object and as a Python dictionary save lots of conversions, library encapsulation layers and counterintuitive restrictions. It minize code size and maximizes speed of data exchange between JavaScript and Python. Crucial to making it work is the identifier aliasing mechanism. It facilitates carefree use of Python keywords and identifiers, solving any name clashes with their JavaScript counterparts, now and in the future. It doesnâ€™t matter that both Python and JavaScript have a â€˜stripâ€™ method for strings that do different things. Using â€˜stripâ€™ in Python will translate to â€˜py_stripâ€™ and JavaScriptâ€™s native â€˜stripâ€™ method can be used from Python under the name â€˜js_stripâ€™.”…””}”(hj˜  hj–  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hK`hj…  hhubeh}”(h ]”ŒDwhy-does-transcrypt-blend-python-datatypes-with-javascript-datatypes”ah"]”h$]”ŒDwhy does transcrypt blend python datatypes with javascript datatypes”ah&]”h(]”uh*h
hj#  hhhh+hK^ubh)”}”(hhh]”(h)”}”(hŒcWhy are certain Python constructions supported as a local (or global) option rather than by default”h]”hŒcWhy are certain Python constructions supported as a local (or global) option rather than by default”…””}”(hj±  hj¯  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hhj¬  hhhh+hKcubh>)”}”(hXù  Efficiency is the reason. While it seems very sophisticated to globally support operator overloading by default, replacing x = 2 * (3 + 4) by x = __mul__ (__add__ (3, 4)) in a program full of such expressions, possibly in inner loops, would have a disastrous impact on both performance and readability of the generated JavaScript code. And readability of the generated code is a must. Transcrypt should not be a magical toolbox, close your eyes, trust us and here's the rabbit. The way it works should be fully transparent, including quality and correctness of the generated JavaScript code. On the other hand, who would like to write v4 = add (multiply (add (v1, v2)), v3) rather than v4 = M (v1 + v2) + v3 in a program consisting of many lines of vector math.”h]”hXû  Efficiency is the reason. While it seems very sophisticated to globally support operator overloading by default, replacing x = 2 * (3 + 4) by x = __mul__ (__add__ (3, 4)) in a program full of such expressions, possibly in inner loops, would have a disastrous impact on both performance and readability of the generated JavaScript code. And readability of the generated code is a must. Transcrypt should not be a magical toolbox, close your eyes, trust us and hereâ€™s the rabbit. The way it works should be fully transparent, including quality and correctness of the generated JavaScript code. On the other hand, who would like to write v4 = add (multiply (add (v1, v2)), v3) rather than v4 = M (v1 + v2) + v3 in a program consisting of many lines of vector math.”…””}”(hj¿  hj½  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hKehj¬  hhubh>)”}”(hX  In general compiler facilities that may have a negative impact on performance if applied in the wrong places can be switched on and off locally. The reason they sometimes also are available as a global option is educational use. If straightforward pythonic code matters more than performance, which is the case in an educational situation, setting all switches to maximize CPython compliance may be a good idea, especially if the generated JavaScript code is taken for granted as are assembly instructions with a C compiler.”h]”hX  In general compiler facilities that may have a negative impact on performance if applied in the wrong places can be switched on and off locally. The reason they sometimes also are available as a global option is educational use. If straightforward pythonic code matters more than performance, which is the case in an educational situation, setting all switches to maximize CPython compliance may be a good idea, especially if the generated JavaScript code is taken for granted as are assembly instructions with a C compiler.”…””}”(hjÍ  hjË  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hKghj¬  hhubh>)”}”(hŒrThe following benchmark results give an indication of the performance of Transcrypt'ed code with default settings:”h]”hŒtThe following benchmark results give an indication of the performance of Transcryptâ€™ed code with default settings:”…””}”(hjÛ  hjÙ  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hKihj¬  hhubh	Œfigure”“”)”}”(hhh]”h	Œimage”“”)”}”(hŒa.. figure:: ../images/benchmark.png
    :alt: Relative performance measured by Pystone benchmark
”h]”h}”(h ]”h"]”h$]”h&]”h(]”Œalt”Œ2Relative performance measured by Pystone benchmark”Œuri”Œ../images/benchmark.png”Œ
candidates”}”Œ*”jû  suh*jì  hjé  hh+hNubah}”(h ]”h"]”h$]”h&]”h(]”uh*jç  hj¬  hhhh+hNubh>)”}”(hX\  Note that Transcrypt avoids constructs that cannot be made to perform in the browser. This means that Transcrypt and CPython are playing in different leagues. Transcrypt makes it possible for Python programmers to take a lot of their skills to the browser, but it is in no way a replacement for CPython. The two should be regarded as complementary.”h]”hX\  Note that Transcrypt avoids constructs that cannot be made to perform in the browser. This means that Transcrypt and CPython are playing in different leagues. Transcrypt makes it possible for Python programmers to take a lot of their skills to the browser, but it is in no way a replacement for CPython. The two should be regarded as complementary.”…””}”(hj  hj  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hKnhj¬  hhubeh}”(h ]”Œawhy-are-certain-python-constructions-supported-as-a-local-or-global-option-rather-than-by-default”ah"]”h$]”Œcwhy are certain python constructions supported as a local (or global) option rather than by default”ah&]”h(]”uh*h
hj#  hhhh+hKcubh)”}”(hhh]”(h)”}”(hŒ#Why were the \_\_pragma\_\_'s added”h]”hŒ%Why were the  _ _pragma _ _â€™s added”…””}”(hŒ#Why were the \_\_pragma\_\_'s added”hj  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*hhj  hhhh+hKqubh>)”}”(hXŒ  Several special facilities were needed that don't play a role in CPython: local compilation options, setting identifier aliases, e.g. replacing jq or S by $ to be able to bridge the gap with JQuery, conditional compilation of code fragments like imports, who, by nature of compilation rather than interpretation, are done compile time rather than runtime hence won't obey normal 'if' statements, etc.. For all those special facilities special keywords could have been devised. It would make such special facilities hard to recognize and keyword-hungry. Using \_\_pragma\_\_ in these cases provides a simple clue to what's going on, both for developers and for the compiler. In the C/C++ world pragma's serve a comparable purpose. They are, as the word suggest, pragmatic solutions to practical problems. Pragmatism is good. But it should be insulated and carefully managed. A special keyword helps with that.”h]”hX˜  Several special facilities were needed that donâ€™t play a role in CPython: local compilation options, setting identifier aliases, e.g. replacing jq or S by $ to be able to bridge the gap with JQuery, conditional compilation of code fragments like imports, who, by nature of compilation rather than interpretation, are done compile time rather than runtime hence wonâ€™t obey normal â€˜ifâ€™ statements, etc.. For all those special facilities special keywords could have been devised. It would make such special facilities hard to recognize and keyword-hungry. Using  _ _pragma _ _ in these cases provides a simple clue to whatâ€™s going on, both for developers and for the compiler. In the C/C++ world pragmaâ€™s serve a comparable purpose. They are, as the word suggest, pragmatic solutions to practical problems. Pragmatism is good. But it should be insulated and carefully managed. A special keyword helps with that.”…””}”(hXŒ  Several special facilities were needed that don't play a role in CPython: local compilation options, setting identifier aliases, e.g. replacing jq or S by $ to be able to bridge the gap with JQuery, conditional compilation of code fragments like imports, who, by nature of compilation rather than interpretation, are done compile time rather than runtime hence won't obey normal 'if' statements, etc.. For all those special facilities special keywords could have been devised. It would make such special facilities hard to recognize and keyword-hungry. Using \_\_pragma\_\_ in these cases provides a simple clue to what's going on, both for developers and for the compiler. In the C/C++ world pragma's serve a comparable purpose. They are, as the word suggest, pragmatic solutions to practical problems. Pragmatism is good. But it should be insulated and carefully managed. A special keyword helps with that.”hj-  hhhNhNubah}”(h ]”h"]”h$]”h&]”h(]”uh*h=hh+hKshj  hhubeh}”(h ]”Œwhy-were-the-pragma-s-added”ah"]”h$]”Œwhy were the __pragma__'s added”ah&]”h(]”uh*h
hj#  hhhh+hKqubeh}”(h ]”ŒKspecific-design-choices-made-for-transcrypt-and-their-underlying-motivation”ah"]”h$]”ŒKspecific design choices made for transcrypt and their underlying motivation”ah&]”h(]”uh*h
hhhhhh+hKPubeh}”(h ]”ŒCthe-philosophy-behind-transcrypt-and-its-impact-on-design-decisions”ah"]”h$]”ŒCthe philosophy behind transcrypt and its impact on design decisions”ah&]”h(]”uh*h
hhhhhh+hKubah}”(h ]”h"]”h$]”h&]”h(]”Œsource”h+uh*hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hNŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jw  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h+Œ_destination”NŒ_config_files”]”Œpep_references”NŒpep_base_url”Œ https://www.python.org/dev/peps/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œhttps://tools.ietf.org/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œfile_insertion_enabled”ˆŒraw_enabled”KŒsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jQ  jN  jŒ  j‰  hþhûjA  j>  j„  j  j   j  jI  jF  j‚  j  j©  j¦  j  j  jA  j>  uŒ	nametypes”}”(jQ  NjŒ  NhþNjA  Nj„  Nj   NjI  Nj‚  Nj©  Nj  NjA  Nuh }”(jN  hj‰  h,hûh°j>  j  j  jD  j  j  jF  j#  j  j4  j¦  j…  j  j¬  j>  j  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒ
decoration”Nhhub.