Skip to main content

Python to JavaScript transpiler, supporting multiple inheritance and generating lean, highly readable code

Project description

Transcrypt is a tool to precompile a fairly extensive subset of Python into compact, readable Javascript. It has the following characteristics:

  • Allows for classical OO programming with multiple inheritance using pure Python syntax, parsed by CPython’s native parser
  • Seamless integration with the universe of high-quality web-oriented JavaScript libraries, rather than the desktop-oriented Python ones
  • Hierarchical URL based module system to prevent name conflicts
  • Simple relation between Python source and generated JavaScript code for easy debugging
  • Compact downloads, kB’s rather than MB’s
  • Lightning fast JavaScript code, using memoization (call caching) to optionally bypass the prototype lookup chain
  • Operator overloading can be switched on and off locally to facilitate use for numerical math that’s both readable and efficient

Request to early adopters

As you may have already discovered, Transcrypt is lean, fast, generates highly readable JavaScript, covers most of Python, including multiple inheritance, properties, tuple assignment, **kwargs, *args and selective operator overloading, and it cooperates seamlessly with any JavaScript library. The first version is 3.5, not for marketing reasons, but to make clear what is the matching version of CPython.

While work on Transcrypt will continue, what’s most important now for Transcrypt to become a permanent, well-maintained asset for the programmer community is mindshare! This can only be achieved with your help. Do you think it deserves a lasting place under the sun? Do you want it to be at your disposal, evolve and have an active community to answer your questions? Then let the world know it exists! Do you know someone who can blog about it? Please ask that person to do so… Want to show your discovery to your colleagues, classmates or friends? Go ahead…

For me this is about having pleasure in ones job. I’ve enjoyed laying the groundwork for Transcrypt. And I hope many will enjoy using it.

Jacques de Hooge, Rotterdam, Netherlands

Logo

Transcription once used to be manual labour

Documentation with code examples and forum

Take a look at the documentation with code examples at the Transcrypt website: http://www.transcrypt.org . Some people have contacted me personally with ‘howto’ questions and feature requests. While that’s quite alright, if you want others to benefit from the answers, use the forum: http://transcrypt.boards.net .

Status

Transcrypt is in Beta now. This means that the core is considered feature complete for the first release and has been rather well tested, although omissions and bugs may still surface. It can be safely said that at this moment Transcrypt is already an attractive alternative for writing JavaScript code in a professional setting. The Beta status will be maintained for some time to allow for feedback and ironning out the last wrinkles. Bugs can be reported as GitHub issues at: https://github.com/JdeH/Transcrypt .

What’s new

  • Setup.py adapted to Linux’ case sensitivity
  • Unload preloaded org module to allow pip co-installation with Numscrypt
  • Package name changed to lowercase
  • Extended slices added to support Numscrypt, not yet finished
  • Tuple representation made more compact
  • Slices return list rather than array
  • Methods insert and pop added to list
  • Python pass statement now translates to /* pass */
  • Superfluous semicolons removed when in compiling with static check switch
  • nonlocal implemented + testcase.
  • Missing com.fabricjs module added.
  • Fix for missing getsitepackages () of virtualenv, tested.
  • Fix for missing global and nonlocal, only partially tested.
  • Core is feature complete for first release.
  • Status moved to Beta.

Known restrictions

  • No standard libs, use or encapsulate the JavaScript ones, that’s part of the concept. Some may be ported though.
  • Not all methods of builtin types are there by default. This results from a deliberate choice to keep Transcrypt lean. Such things can be distributed in separate libs.
  • No eval and exec of Python code. This is again part of the concept. Transcrypt code is compiled, optimized and minified in advance to warant fast page loads.
  • No threading of any kind. Will probably stay that way as long as JavaScript doesn’t properly support that.
  • No iterator, generator, xrange stuff. Maybe in the future if a broadly installed version of JavaScript suppports it.

Known bugs

  • None

Readability

As can be seen below, there’s a simple parallel between the Python and the JavaScript code. So it should be easy to debug. Also, code can be tested from the command prompt using stubs.

Screenshot of Python versus JavaScript code

Classic OO with multiple inheritance in JavaScript

Other packages you might like

Licence

Copyright 2014, 2015, 2016 Jacques de Hooge, GEATEC engineering, www.geatec.com

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Project details


Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
Transcrypt-3.5.123.zip (10.9 MB) Copy SHA256 hash SHA256 Source None Mar 15, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page