public
Fork of onecrayon/tea-for-espresso
Description: An Espresso Sugar containing Textmate-style Text Editor Actions, written in Python
Homepage: http://wiki.macrabbit.com/forums/viewthread/160/
Clone URL: git://github.com/subtleGradient/tea-for-espresso.git
Fri Jul 03 18:17:27 -0700 2009
commit  4ee0b3de419548e5c1605a185c8b5a172c174ed0
tree    24785dcc948bd141b850036b0ee70dad16b0bb94
parent  facbffc01bbf636f1f0acda1be583720f5126716 parent  077c98a30d9ce82faca2330b32e4454fdc16f05b
name age message
directory MySugar.sugar/ Loading commit data...
file README.markdown Wed Apr 22 07:42:09 -0700 2009 Updated bug submission info [onecrayon]
file main.py
file setup.py Thu Jun 25 19:40:06 -0700 2009 1.0b16 release [onecrayon]
directory src/
README.markdown

Text Editor Actions for Espresso

Text Editor Actions (TEA) for Espresso is an Espresso plugin that provides:

  1. Some of my favorite text actions for HTML, such as Wrap Selection In Tag (inspired mainly by Textmate's excellent HTML bundle)
  2. Generic text manipulation scripts that can be leveraged by any Sugar (or through custom user actions)

TEA has been bundled with Espresso since version 1.0, so you do not need to download it (unless you want to test bleeding edge improvements).

TEA for users

Many people will be content with the default TEA HTML actions, but if you wish you can add your own custom actions by defining them in XML (I plan to add an interface for managing custom actions; until then you'll need to use XML):

Found something about TEA that makes you unhappy? Submit a bug report or feature request (requires free GitHub account) or visit the official TEA forum post. You can, of course, also email me: ian@onecrayon.com. I typically respond within a day.

TEA for Sugar developers

There are three ways to leverage TEA within your own Sugar:

  1. Use TEA's generic internal actions simply by adding XML definitions (syntax is identical to custom user actions above; only difference is you put your actions in your Sugar's TextActions folder). For a full list of available actions, see the generic action API.

  2. Use the TEALoader class to run a custom script in any language supported by the Mac OS X command line. See Running shell scripts for more info.

  3. Code your own Python scripts for TEA, leveraging the numerous built-in helper functions. See Adding or overriding Python scripts for more info.

Errata

The TEA for Espresso wiki is currently the best place for information about extending TEA. I do not yet have any documentation about using TEA's bundled HTML actions; hopefully their names will be self-explanatory to some extent.

If you are interested in coding your own Sugar in Python, the TEA for Espresso project can also serve as an excellent starting point. The code is released under the MIT license, as described in the main bundle file.