Pyjamas 0.7 / 0.8 Alpha 1  

Pyjamas is a toolkit and library designed to enable writing AJAX applications in Python. Pyjamas is based on Google's GWT, which does the same thing for Java.

ike GWT, pyjamas involves the translation of the application and libraries (including UI widgets and DOM classes) to Javascript and the packaging up of that Javascript code.

There are two core developer tools included with pyjamas. pyjs translates Python code to Javascript by walking the Python abstract syntax tree and generating Javascript.

In many cases, built-in Python types require a custom Javascript implementation. For example, even though Python lists are similar to Javascript arrays, Python lists are converted to custom objects that implement methods like append. These custom objects required for translation by pyjs are defined in a library called pyjslib.

Like GWT, pyjamas comes with a set of UI widgets as well as a library for DOM manipulation. These libraries are written in Python but are, like everything else, translated to Javascript for deployment.

The overall translation of individual components is managed by build which also creates the necessary boilerplate code. The result is a set of .html and .js files that can be served up by a Web server.

There are other components planned which have not been covered here such as server-side code for communication in client-server applications.


Product's homepage

What's New in This Release: [ read full changelog ]



· Simple sys.stdout and sys.stderr objects were added. sys.exc_info() was fixed to behave more like Python.

· A very basic traceback module was added.

· oninput and onpropertychange event support was added.

· A getWidget problem with HTMLTable under pyjd on Windows was fixed.

· Parsing of XML documents under pyjd on Windows was added.

· An auto-build (file monitoring) option was added to pyjsbuild.

· pyjscompressor.py was added.

· Various bugs were fixed.

· Several other features were added.

Version History
Version 1 added on: 15 Apr 2012



Changes on the new version:
What's new in Pyjamas 0.8 Alpha 1: May 20th, 2011

· Simple sys.stdout and sys.stderr objects were added. sys.exc_info() was fixed to behave more like Python.
· A very basic traceback module was added.
· oninput and onpropertychange event support was added.
· A getWidget problem with HTMLTable under pyjd on Windows was fixed.
· Parsing of XML documents under pyjd on Windows was added.
· An auto-build (file monitoring) option was added to pyjsbuild.
· pyjscompressor.py was added.
· Various bugs were fixed.
· Several other features were added.



What's new in Pyjamas 0.5p1: April 12th, 2009

· Fixed Autocompletion which just needed non-modal on PopupPanel (thanks to lovelysystems for implementing non-modal dialogs otherwise it wouldn't be possible to fix Autocompletion)
· Added implementation of metaclass "type" function
· Made KeyboardListener a singleton module rather than have a class named the same as the module. Likewise with MouseListener, Event and Focus.
· Added Right-clickable Context Menus, and added an example in KitchenSink Menus.py to show how to set them up.
· Added python-spidermonkey as an experimental platform, exactly like pyv8run.py now there is pysmrun.py
· Top-level global variables, and top-level functions, now correctly scope in a module (thanks to Jose for raising this one)
· String constants are now returned as instances of String() which results in them having the __iter__ method that has been added to the proto of the javascript base String type.
· made TypeError inherit from BaseException rather than being a javascript proto from Error(). TypeError can now be raised as an Exception, with a message.
· made == comparison use __eq__, which conditionally uses __cmp__ if it is available: this fixes bugs in comparison of lists in the LibTest. replaced a large number of numerical "==" comparisons with "is", so that __eq__ doesn't get called (efficiency).
· added support for calling *args on functions: previously, a call function(*args) would result in the args being thrown away!
· made Tuple its own class, rather than inheriting from List, in order that it can be distinguished from List. __cmp__ of a List with a Tuple now correctly fails.
· rewrote the examples/libtest so that they can be run under standard python (python ./LibTest.py). this allows for a comparison of pyjs against standard python.
· add method extend to pyjslib.List
· add float to builtins
· add pyjamas.log based on examples/libtest/write.py
· registered builtin function 'cmp'. was already implemented but not registered in pyjs.py
· added an --optimize option to which results in removing print statements. this could be further improved. e.g. when assert is implemented
· fixed Mozilla "Permission Denied" bug in DOM.isOrHasChild
· pyjslib.Dict now use the hash method to generate keys internally, so it si possible to use objects as keys like in python. For limitations on dicts read examples/libtest/DictTest.py



What's new in Pyjamas 0.4p1: January 14th, 2009

· This is a minor patch release of pyjamas 0.4p1, the Python-to-Javascript compiler and Python Web UI Widgets Toolkit.
· Significant bugs fixed include HorizontalPanel's remove() function, SimplePanel's clear() function, and sprintf with multiple arguments ("%s %d" % ("hello", 2) will now work) Dialog Box now has modal functionality (thanks to jurgen kartnaller).
· HorizontalSplitPanel has been added, although both the horizontal and vertical panels operate correctly on Mozilla-based browsers, but Safari and IE need volunteers to work on them.



What's new in Pyjamas 0.4: December 2nd, 2008

Enhancements:
· Added library/splitpanel.py and library/vertsplitpanel.py, along with examples/splitpanel. NOTE: splitpanels should be in ui.
· Changed ui.TabBar.insertTab() to allow widgets to be passed as well as text.
· Added examples/tabpanelwidget
· Added gtk_converter to the "contrib" directory (thanks to Jeremy)
· Added library/decoratorpanel.py which includes DecoratorPanel, DecoratedTabPanel and DecoratedTabBar. NOTE: these classes should be in ui.
· Added examples/slideshow
· Added support for slicing with negative numbers.
· Added examples/jsobject
· Added support for a debugging mode, which can be turned on by include a "-d" command-line option when calling build.py. With this option turned on, each statement in your Python code is surrounded by a try...except statement that displays an alert if an exception occurs. The alert message contains the original Python source text, the line number in your Python source file where the error occurred, and the details of the Javscript error which occurred. This should greatly simplify debugging your Pyjamas code.
· Issue #75: Added support for "is not None" syntax.
· Issue #85: Implemented the repr() built-in function.
· Issue #93: Implemented dict.items().
· Issue #95: Implemented Window.prompt().
· Issue #100: Added a setPadding() method to ui.CellPanel.
· Issue #103: Implemented the enumerate() built-in function.
· Issue #104: Added the ability to assign to a list of variables, for example: x,y = self.method()
· Issue #105: Implemented the min() and max() built-in functions.
· Issue #88: It is now possible to use the getattr() built-in function to obtain a method, and then pass parameters to that method when you call it. There is a new example in the "examples/" directory, called "getattr", which demonstrates how this can be used.
· Issue #111: Added XOR and bit-shift operators, thanks to legith.
· Issue #112: Added support for the ord() and chr() built-in functions (thanks, legith!).
· Issue #113: Implemented support for basic try...except statements. There is also a new module, examples/libtest/ExceptionTest.py, which tests the use of the try...except statement.

Bug Fixes:
· Added a new implementation of sprintf.
· Issue #86: Fixed a bug which could cause HTTPRequest to crash. Thanks to finder83 from code.google.com/p/pyjamas for helping to find this.
· Added standard images to use for the edges and corners of a dialog box
· Various changes to ui.py and DOM.py to (partially) support event handling on dialog boxes.
· Fixed a bug in ui.CellFormatter.getElement() which could cause a crash.
· Fixed a problem with ui.FormSubmitEvent.setCancelled()
· Fixed bug in ui.clickDelegatePanel.onBrowserEvent() which caused a crash when processing a keyDown event.
· Changed ui.ClickDelegatePanel.onBrowserEvent() to check that the key delegate actually has an "onKeyDown" method before attempting to call it.
· Issue #54: Fixed a probem with browser detection (via the "user-agent" string) under Internet Explorer 7.0. Apparently Microsoft decided to change the user-agent string in IE 7, breaking the code in Pyjamas which identified the user's browser.
· Removed code from DOM.init() which was attempting to fix a bug with capturing elements, but didn't work.
· Fixed a bug in ComplexPanel.insert which was causing Internet Explorer 6 to corrupt its DOM model.
· Issue #53: Fixed a problem with operator precedence.
· Issue #91: Added DOM.eventGetCurrentEvent() function to retrieve the current event.
· Changed FocusWidget.onBrowserEvent() to check that the click listener actually has an "onClick" method before attempting to call it.
· Issue #82: Changed content-type sent by library/HTTPRequest.asyncPostImpl to "application/x-www-form-urlencoded" rather than "text/plain". This allows the HTTPRequest object to be used to make AJAX calls using HTTP POST requests.
· Issue #81: Fixed library/ui.Panel.clear().
· Added a cascading stylesheet to the examples/mail program
· Issue #106: Fixed a problem where using a tuple as a dictionary key produced unexpected results
· Issue #107: It is now possible to include a plus sign at the start of a numeric literal
· Moved datetime.py from the addons directory into library.
· Issue #80: Changed many of the examples to use the new "pyjamas" package name.
· Fixed a problem with using negative slices on lists (thanks, Legith).