Google App Engine Oil (GAEO)

The First Step of Rebooting

2010-02-08T15:22:00.002+08:00

GAEO has started rebooting. Now you can checkout the rebooted code from the new Mercurial repository (check out here). Feel free to report us feedbacks or bugs. By the way, the new home page is also on the way. Please look forward to it.

GAEO Is Going To Reboot

2010-01-07T17:18:00.002+08:00

Hey guys,

Sorry for that there's no updates on GAEO framework for a long time.
However, we're trying to REBOOT(actually, re-design) this framework.

The new version of GAEO will be 0.5. The newer version will be more light and flexible.
I cannot promise that the old application could work perfectly with new GAEO,
but we try to give you a better one. Please looking forward to it.

The GAEO Framework Leader,
ericsk

GAEO 0.3 Released!

2009-08-31T13:58:00.002+08:00

I'm glad to announce that gaeo has new version-- 0.3. In this version, some features are added. You can see what are added/removed in the Changelog.

If you are interested in GAEO, please upgrade to 0.3 version and feel free to issue us any problem.

0.3 Beta is out

2009-05-20T10:56:00.004+08:00

We're glad to announce that GAEO 0.3 has released a beta version (link). In this release, we've fixed some bugs and added some features.

before_save and after_save hook in BaseModel
Now, you can override before_save or after_save method in a BaseModel in order to hook the save (put) method. If before_save returns a False, the data won't be put in Datastore.
For example,
.... class Bar(BaseModel): ..... def before_save(self): is_valid = # check the attributes return is_valid
flash (dict) object support
You can temporarily put something between actions through the flash object in a controller. For example:
class Foo(BaseController): .... def create(self): .... self.flash['message'] = 'Creation Done' .... def show(self): msg = self.flash.get('message', '') ...

The 0.3 will be soon released, please wait a moment :-)

GAEO Talk in OSDC.tw

2009-04-18T16:03:00.003+08:00

I've given a GAEO talk at OSDC (Open Source Developer Conference) in Taiwan. Here is the slide.

Slide Link

GAEO 0.3 Alpha 1

2009-04-07T21:48:00.003+08:00

I'm glad to announce that GAEO has been released a 0.3-alpha-1 version. You can download it from here.

In GAEO 0.3, the BaseView class is added and there will be an instance as a member of BaseController. From GAEO 0.3 on, the render process is handled by the BaseView object. The templates value will be also passed to the BaseView object. If you want to upgrade your application from the previous versions (before 0.3), you have to notice the changelog in the GAEO pacakage.

Send your feedback in our group. We want to hear from you. :-)

GAEO Doc in Japanese

2009-01-12T17:02:00.003+08:00

Thank Tetsunosuke for helping make the GAEO documents in Japanese.

His work locates here.

どうもありがとうございます！

0.2.1 Release

2008-12-23T09:23:00.004+08:00

The GAEO 0.2.1 has been released now. If you're using 0.2, I suggest you change to 0.2.1.

What's New in 0.2.1

Add BaseModel.belongs_to method back.

Add SearchBaseModel that extends BaseModel and SearchableModel

Some bugs fixed.

TextMate Bundle

GAEO TextMate bundle

2008-12-16T00:28:00.004+08:00

If you are a Mac programmer, I suppose that you love the TextMate editor and use it for coding. Now, the GAEO team provides a TextMate bundle for you. Please refer to the installation guide. We will keep on adding more useful commands, snippets, etc.

Maybe the bundle will be shipped with the GAEO package in the next release.

SearchableBaseModel and 0.2.1-Beta

2008-12-11T12:20:00.003+08:00

In 0.2.1, we've added a new model class -- gaeo.model.SearchableBaseModel. It directly inherits from gaeo.model.BaseModel and google.appengine.ext.search.SearchableModel. If your model is searchable (App Engine will help you construct the search indexes in each entity.), please create a model that extends SearchableBaseModel.

At the same time, we also release the 0.2.1 BETA version. The BaseModel.belongs_to and SearchableBaseMoel are included.

I want belongs_to method back!

2008-12-07T17:42:00.002+08:00

Before the release of 0.2, I found that there's a hard-to-resolve bug in BaseModel.belongs_to method. So I temporarily remove it from the 0.2 release. However, I tried a hack that make BaseModel.belongs_to more reasonable. In 0.2.1 release, this class_method will be officially provided.

Now you can download the nightly release from the project home to have BaseModel.belongs_to method.

Do You Love GAEO?

2008-12-03T10:04:00.004+08:00

We create a Gallery page here. It lists the sites who use GAEO as framework.

If you want to put your site in the list, please email [ericsk AT gaeo.org] the details. We will update ASAP.

0.2 Release

2008-12-03T09:12:00.003+08:00

The GAEO 0.2 version has been released (here). You can download the newer package or use

easy_install -U gaeo

to upgrade the previous install. You may refer to the CHANGELOG to know the changes from 0.1 to 0.2.

The document site would be modified soon. I hope you use GAEO 0.2 from now on and report us bugs :-)

GAEO+Facebook

2008-11-15T15:30:00.001+08:00

gasolin presented the GAEO+Facebook plugin in Happy Desinger 4. Here is the slide

GAEO RoadMap

2008-11-10T11:16:00.002+08:00

We've drawn a RoadMap here. If you want to know what feature we will implement, please refer it.

Feel free to send us any suggestions :-)

Talk in TOSSUG

2008-11-05T13:46:00.002+08:00

Last night I presented the GAEO (current/future) frameowrk in TOSSG (Taipei Open Source Software User Group). Here is the slide

The Beginning of Globalization

2008-10-30T14:00:00.003+08:00

In order to promote GAEO, we need lots of documentation for references or guides to develop. Officially, we only provide an English-based documentations. However, there're many people around the world doesn't read English (very well). So we want to make our documentation global.

Now, there're some enthusiastic people help us to translate the GAEO Documentation to Français and 正體中文 versions. If you want to help us to translate the docs to more languages, please leave message here and I will tell you how to start.

Thanks you who help promoting GAEO :-)

0.2 Beta

2008-10-30T13:56:00.002+08:00

We release GAEO 0.2 Beta today. It means that GAEO 0.2 is coming soon :-)

In 0.2-beta, an global initialization method has been added. You can write your global initialization script in ${APPHOME}/application/controllers/application.py's application_init method. The GAEO's dispatcher will automatically detect if the ApplicationController exists.

For more information, please refer to the CHANGELOG (rev 135).

0.2 Alpha 2

2008-10-15T22:43:00.002+08:00

We are glad to release the GAEO 0.2 alpha-2 for you. You can download it here and try the new features.

In 0.2a2, we've added the following features:

GAEO ZIP Import
Due to the disk space limitation on App Engine, we enabled your project importing GAEO through a zipped file. You can directly zip the gaeo directory in your project or create a new gaeo project by adding --zipped option while using gaeo.py script. (i.e., # gaeo.py --zipped foo)

A Basic Plugin Generation Script
Now you can use
gaeogen.py plugin FooBar
to generate a blank GAEO plugin in your project.

Default Static Files Expiration
We've added default_expiration config in the created app.yaml file. You can refer to this article to adjust the expiration duration in this file.

0.2a2 is also fixed a1's installation error (lacks of main.py). Please try this new version of GAEO and keep watching and sending us feedbacks :-)

GAEO 0.2 Alpha1 Released

2008-10-01T19:02:00.006+08:00

It's the first release of GAEO 0.2. You can download it from here.

In this release, we've added the following features:

easy_install Integration
- In GAEO's package, you can use easy_install gaeo to install GAEO in your system.

Scaffold
- This useful script helps you create pages according to a model. By using this script, you can quickly create a CRUD pages on a model. For more information, please refer to here and there.

Ajax helpers
- mentioned here.

Plugins
- This page shows you how to develop & install GAEO plugins. The plugins site will come soon.

Please try the GAEO's newer version and feel free report us bugs.

GAEO Recent Updates

2008-09-27T00:05:00.005+08:00

We had added these features (in 0.2 branch) recently:

respond_to support

You can add a routing rule r.connect('/:controller/:action/:id.:format') at the bottom of initRoutes. Then you can use respond_to method like this:
```
self.respond_to(
          html=lambda: self.render('<h1>Hello World</h1>'),
            js=lambda: self.render(script='alert("hello, world")')
        )
```
If 'http://example.com/foo/bar/12345.html' is requested, the controller will execute lambda: self.render('<h1>Hello World</h1>'). While 'http://example.com/foo/bar/12345.js' is request, the client will receive a script content. They are the same action.

Tell if a request is XHR

GAEO use X-Requested-With header to tell if a request is initiated by XMLHttpRequest object. You can tell that by seeing that self._is_xhr is True or False.

render method add script type

You can use self.render(script="alert('!')") to send client text/javascript data.

REST methods

Now we route the REST methods to the main dispatcher, and you can use self._request_method to get the request method (e.g., 'get', 'put', 'head', ...etc).

Scaffold in 0.2

2008-09-24T22:17:00.006+08:00

Source code is available here.

Scaffold helps you to quickly create pages that play with entities.
Here's an example:

gaeogen.py scaffold GuestBook new edit index show destroy name:StringProperty email:EmailProperty text:TextProperty

It creates a simple guestbook on http://your-host/guestbook/ which can list, add, modify, and delete posts.

The prototype of scaffold is:

gaeogen.py scaffold <scaffold_name> <actions> <data_name:data_types> ...

where actions include index/new/create/edit/update/show/destroy, and data types must be one of the defined types in GAE.

If you want to set some properties to the type, "name:StringProperty(required=True)" works.

I'm still working on it, and any suggestion is welcome.

Ajax Helpers in 0.2

2008-09-21T11:26:00.003+08:00

We will add ajax helpers in version 0.2. You can quickly generate some ajax calls by invoking these helpers. For example


from gaeo.view.helper import ajax

...
# generate a html link and send a request to /foo/bar
self.send_link = ajax.link_to_remote("Click me", "/foo/bar", callback="alert('!');")
...

thus, you can put this generated html in your template:


...
Click this link: {{ send_link }}
...

Of course, since the generated content uses jQuery, you shoud include the jQuery first. You can include it from Google's CDN: http://ajax.googleapis.com/ajax/libs/jquery/1/jquery.min.js

Is 'ajax helpers' a good idea?

GAEO 0.1 Released

2008-09-20T11:02:00.006+08:00

Since we don't find any significant bug in the alpha version, we decide to release a stable version.

You can download the GAEO version 0.1 from here. If you need documentations, this site should work for you. And most of all, report bugs here if you encounter anything strange.

Now, we have to start the version 0.2 works.

GAEO 0.1 alpha and reference guides

2008-09-10T16:41:00.003+08:00

We decide to release an alpha version of GAEO 0.1. Please try it and report any bug or suggestion to help the 0.1 stable release.

Besides the 0.1-alpha, we add more articles in GAEO's documentation site. You can refer to the usage of each class through the reference page. If you have written something about GAEO, please let us know, thanks :-)

Google App Engine Oil (GAEO)

The First Step of Rebooting

GAEO Is Going To Reboot

GAEO 0.3 Released!

0.3 Beta is out

before_save and after_save hook in BaseModel

flash (dict) object support

GAEO Talk in OSDC.tw

GAEO 0.3 Alpha 1

GAEO Doc in Japanese

0.2.1 Release

What's New in 0.2.1

GAEO TextMate bundle

SearchableBaseModel and 0.2.1-Beta

I want belongs_to method back!

Do You Love GAEO?

0.2 Release

GAEO+Facebook

GAEO RoadMap

Talk in TOSSUG

The Beginning of Globalization

0.2 Beta

0.2 Alpha 2

GAEO ZIP Import

A Basic Plugin Generation Script

Default Static Files Expiration

GAEO 0.2 Alpha1 Released

easy_install Integration

Scaffold

Ajax helpers

Plugins

GAEO Recent Updates

`respond_to` support

Tell if a request is XHR

`render` method add `script` type

REST methods

Scaffold in 0.2

Ajax Helpers in 0.2

GAEO 0.1 Released

GAEO 0.1 alpha and reference guides

Google App Engine Oil (GAEO)

The First Step of Rebooting

GAEO Is Going To Reboot

GAEO 0.3 Released!

0.3 Beta is out

before_save and after_save hook in BaseModel

flash (dict) object support

GAEO Talk in OSDC.tw

GAEO 0.3 Alpha 1

GAEO Doc in Japanese

0.2.1 Release

What's New in 0.2.1

GAEO TextMate bundle

SearchableBaseModel and 0.2.1-Beta

I want belongs_to method back!

Do You Love GAEO?

0.2 Release

GAEO+Facebook

GAEO RoadMap

Talk in TOSSUG

The Beginning of Globalization

0.2 Beta

0.2 Alpha 2

GAEO ZIP Import

A Basic Plugin Generation Script

Default Static Files Expiration

GAEO 0.2 Alpha1 Released

easy_install Integration

Scaffold

Ajax helpers

Plugins

GAEO Recent Updates

respond_to support

Tell if a request is XHR

render method add script type

REST methods

Scaffold in 0.2

Ajax Helpers in 0.2

GAEO 0.1 Released

GAEO 0.1 alpha and reference guides

`respond_to` support

`render` method add `script` type