CalicoDevelopment

From IPRE Wiki
Revision as of 16:22, 17 January 2011 by Doug Blank (Talk | contribs) (TODO)

Jump to: navigation, search

This page describes the planning of Pyjama Editor and Shell. The Pyjama IDE is a cross-platform environment for learning about computing. This is part of the Pyjama Project.

Development

Getting Source Code

For those with write permissions to the SVN Bryn Mawr College source code repository:

svn co https://svn.cs.brynmawr.edu/Pyjama/trunk Pyjama

You can browse the source code here:

You will also need:

  • mono
  • gtk (and libgtk2.0-cil-dev, for package-config files)
  • gtk-sourceview (libgtksourceview2-2.0-cil package on Ubuntu)

Building

To build everything, run "make" in the root:

cd Pyjama
make

That will build platform independent modules/Myro.dll, modules/Graphics.dll, and languages/Scheme.dll.

To run code:

cd Pyjama
make

Overview

There are 5 directories in the Pyjama folder:

  1. bin - contains the startup files, and language files for Python and Ruby
    1. bin/Lib - contains the standard Python libraries
  2. languages - contains the language definition files for Python, Ruby, Scheme, and Dinah
  3. modules - Cross-language modules that can be used by all Pyjama languages
  4. examples - sample code (currently just Python)
  5. src - the code to run the Pyjama Project

Pyjama is written in IronPython, using the Gtk# graphical user interface. The Python files for the Pyjama Project are in Pyjama/src/*.py. They are:

  • document.py - base classes for Document interface
  • editor.py - the Editor Window
  • engine.py - base classes for the Engine interface
  • pyjama.py - setup and startup code
  • reflection.py - code to read DLL data
  • shell.py - the Shell Window
  • utils.py - utility functions and classes
  • window.py - base class for Shell and Editor

Pyjama is an editor and executor of code from a Language. Languages are defined in Pyjama/languages and define two items: editor document, and an executor engine. Pyjama has 4 languages, in various states of completeness:

  1. Python (finished)
  2. Ruby (nearly finished)
  3. Scheme (somewhat working)
  4. Dinah (drag and drop language, just started)

A Language file in Pyjama/languages/*.py defines the editing document, and the shell executor API. Documents can do things like open, save, and display data for editing. Engines can do things like execute, execute_file, and parse files. Engines also allow for the languages to share data and functionality.

TODO

  1. Add proper opensource license information to all files
  2. Missing shapes: Circle, Oval, Text (C#, modules/Graphics/Graphics.cs)
  3. Doesn't ask to save files on Quit
  4. Need search/replace in editor
  5. Printing
  6. Get Dinah working
    1. read classes, methods, params and return values from DLL
    2. save/read file format
    3. execute file
  7. Provide "Hint" links to wiki page on error
  8. Log student time/events for analysis
  9. Find Libraries for text-to-speech, gamepad, 3D graphics, music, etc
  10. Can we run chiron and have our code run in web browser through Silverlight/Moonlight?
  11. Command-line history
    1. don't add empty entries
    2. sometimes doesn't add entries
    3. don't repeat items
  12. Console (tty) mode
  13. Edit menu (search, find, select, redo, undo)
  14. Read compressed JPG from fluke camera
  15. multi-point line using cairo
  16. Write do_together in C#
  17. Need move_to_top, move_to_bottom (for Shape objects in modules/Graphics/Graphics.cs)
  18. Unify graphics move/rotate (use Cairo rotate/translate or adjust our own points)
  19. alpha doesn't apply to Pictures yet

Screen Shots

Pyjama-010.gif

For more, see PyjamaScreenShots

Troubleshooting

If you have any trouble, find bugs, or want to make a feature request, please do that at:

pyjama.codeplex.com/WorkItem/