Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 155 lines (100 sloc) 4.717 kb
f28a63b6 » John Woodell
2010-07-01 more instructions
1 =Dubious for App Engine
3e526004 » takeru
2010-07-02 first commit
2
29669b63 » John Woodell
2010-07-04 compiles, but the new controller not yet complete
3 See the published demo: http://dubious-demo.appspot.com
80d48d3e » John Woodell
2010-07-03 Add a link to the demo app
4
5 ===Introducing Dubious
fd9faec9 » baroquebobcat
2010-09-22 preping readme for merging into mirah/dubious
6 This is a web framework written in Mirah geared towards running on App Engine.
7 Dubious provide a way to build apps in Mirah, with conventions familiar to
8 Rails developers.
38a3de91 » John Woodell
2010-07-09 update Duby references to Mirah
9 Mirah has no runtime dependencies, everything is compiled ahead-of-time.
fd9faec9 » baroquebobcat
2010-09-22 preping readme for merging into mirah/dubious
10 So, Mirah apps have none of the initialization costs associated with JRuby.
11 Dubious supports ERb and uses a simple datastore adapter that uses a syntax
d6f21c78 » John Woodell
2010-07-15 update the copy
12 similar to DataMapper.
80d48d3e » John Woodell
2010-07-03 Add a link to the demo app
13
38a3de91 » John Woodell
2010-07-09 update Duby references to Mirah
14 ===Introducing Mirah
15 Mirah is a new language with Ruby-inspired syntax that compiles to JVM bytecode.
16 Mirah is statically typed, with local type inference, and a simple macro system.
17 The goal is to make Mirah as expressive as Ruby without introducing any runtime
80d48d3e » John Woodell
2010-07-03 Add a link to the demo app
18 library and while maintaining Java's level of performance. Just write code that
19 looks like Ruby, but reference the Java docs to find out what method calls to
508eaeab » baroquebobcat
2010-09-14 updated readme instructions
20 make. Mirah uses the Java type system. Join the mirah mailing list to get
21 involved: http://groups.google.com/group/mirah
80d48d3e » John Woodell
2010-07-03 Add a link to the demo app
22
508eaeab » baroquebobcat
2010-09-14 updated readme instructions
23 === Getting Started
fd9faec9 » baroquebobcat
2010-09-22 preping readme for merging into mirah/dubious
24 Since Dubious relies on features of Mirah and Bitescript that have not been
25 released yet, you need to clone the repositories and manually build and install
26 the gems for each of them.
508eaeab » baroquebobcat
2010-09-14 updated readme instructions
27
28 #assuming you are in a workspace directory.
29 git clone http://github.com/headius/bitescript.git
30 git clone http://github.com/mirah/mirah.git
fd9faec9 » baroquebobcat
2010-09-22 preping readme for merging into mirah/dubious
31 git clone http://github.com/mirah/dubious.git
508eaeab » baroquebobcat
2010-09-14 updated readme instructions
32
33 #assuming your gem command is the one from jruby
34 cd bitescript
35 gem build bitescript.gemspec
36 gem install bitescript-*
37 cd ../mirah
38 gem build mirah.gemspec
39 gem install mirah-*
40 cd ../dubious
41 gem build dubious.gemspec
42 gem install dubious-*
43
44 In the future, you will be able to simply install Dubious as a JRuby gem. That will look likke the following:
45
46 If your gem command is the JRuby one, run
47
48 gem install dubious
49
50 If not run
51
52 jruby -S gem install dubious
53
54 This will add a `dubious` command that you can create new apps, generate controllers and models etc with.
55
56 Once dubious is installed, you can generate an app skeleton.
57
58 dubious new my-app
59 cd my-app
60
61 ===Directory Layout
62
63 The layout is based on Rails' with some Java WAR directories, and files geared towards deploying on AppEngine.
64
65 * WEB-INF/app.yaml
66 contains handlers for different routes. It's like a lightweight version of web.xml--I think it actually generates it
67
68 http://code.google.com/appengine/docs/python/config/appconfig.html#About_app_yaml
69
70 ==Hacking on Dubious
38a3de91 » John Woodell
2010-07-09 update Duby references to Mirah
71 ===Setup the Mirah development environment
3e526004 » takeru
2010-07-02 first commit
72
290eb7b5 » John Woodell
2010-07-02 clean up the instructions
73 Fetch App Engine Java SDK and JRuby, then install them into /usr/local
3e526004 » takeru
2010-07-02 first commit
74
508eaeab » baroquebobcat
2010-09-14 updated readme instructions
75 //-included in the gem-* http://googleappengine.googlecode.com/files/appengine-java-sdk-1.3.7.zip
5075b541 » John Woodell
2010-07-02 better instructions
76 * http://jruby.org.s3.amazonaws.com/downloads/1.5.1/jruby-bin-1.5.1.tar.gz
95b1bb8e » John Woodell
2010-07-01 Update the readme
77
290eb7b5 » John Woodell
2010-07-02 clean up the instructions
78 Make sure the appengine tools are executable
3e526004 » takeru
2010-07-02 first commit
79
40141c3a » John Woodell
2010-09-05 move app.yaml for SDK 1.3.6+
80 sudo chmod a+x /usr/local/appengine-java-sdk-1.3.7/bin/*.sh
3e526004 » takeru
2010-07-02 first commit
81
5782af10 » John Woodell
2010-07-09 more detail about ho to get started
82 Now git clone bitescript, mirah and dubious to your drive
3e526004 » takeru
2010-07-02 first commit
83
290eb7b5 » John Woodell
2010-07-02 clean up the instructions
84 mkdir -p ~/mystuff; cd ~/mystuff
3e526004 » takeru
2010-07-02 first commit
85 git clone http://github.com/headius/bitescript.git
508eaeab » baroquebobcat
2010-09-14 updated readme instructions
86 git clone http://github.com/mirah/mirah.git
91364429 » baroquebobcat
2010-07-16 small doc fix: fixing url for dubious repo in commandline instructions
87 git clone http://github.com/mirah/dubious.git
3e526004 » takeru
2010-07-02 first commit
88
290eb7b5 » John Woodell
2010-07-02 clean up the instructions
89 Edit .bash_profile to find these tools
95b1bb8e » John Woodell
2010-07-01 Update the readme
90
91 export JRUBY_HOME=/usr/local/jruby-1.5.1
3647e462 » baroquebobcat
2010-07-16 mirah-fication
92 export MIRAH_HOME=~/mystuff/mirah
40141c3a » John Woodell
2010-09-05 move app.yaml for SDK 1.3.6+
93 export APPENGINE_JAVA_SDK=/usr/local/appengine-java-sdk-1.3.7
3647e462 » baroquebobcat
2010-07-16 mirah-fication
94 export PATH=$PATH:$JRUBY_HOME/bin:$MIRAH_HOME/bin:$APPENGINE_JAVA_SDK/bin
95b1bb8e » John Woodell
2010-07-01 Update the readme
95
5075b541 » John Woodell
2010-07-02 better instructions
96 Verify tools are configured properly, and check to see
97 that script/build.sh has the correct path to the SDK.
98
99 which appcfg.sh
100 which dev_appserver.sh
3647e462 » baroquebobcat
2010-07-16 mirah-fication
101 which mirah
5075b541 » John Woodell
2010-07-02 better instructions
102 which jruby
103
426d8622 » hakunin
2010-08-22
104 After that you should install the appengine-sdk gem
105
106 jgem install appengine-sdk
107
8d91393f » baroquebobcat
2010-09-10 add docs around gemy goodness.
108 To build the gem
109
110 jgem build dubious.gemspec
111
80d48d3e » John Woodell
2010-07-03 Add a link to the demo app
112 ===Developing your App
113
8d91393f » baroquebobcat
2010-09-10 add docs around gemy goodness.
114 Install the gem
115
116 jgem install dubious
117
118 Generate your app
5782af10 » John Woodell
2010-07-09 more detail about ho to get started
119
8d91393f » baroquebobcat
2010-09-10 add docs around gemy goodness.
120 dubious new my-app
121 cd my-app
5782af10 » John Woodell
2010-07-09 more detail about ho to get started
122
e3a10fa7 » John Woodell
2010-08-08 Update the README and clean-up the form_helper
123 There are two ways to develop the app. The first way is to run the build script each time you make a change. The new way is to use the Rakefile. If you are using jruby's rake, the task will watch for source file changes and update the running class files. Otherwise, you need to restart the server when you have changes.
124
125 === Use the Original Scripts
126
15a06b38 » John Woodell
2010-07-25 fix link_to and image_tag
127 Compile the Mirah files and populate the WEB-INF/lib dir
128
ba084c47 » John Woodell
2010-08-23 fix README, add custom routes
129 ./script/build.sh
15a06b38 » John Woodell
2010-07-25 fix link_to and image_tag
130
e3a10fa7 » John Woodell
2010-08-08 Update the README and clean-up the form_helper
131 Run the app locally
80d48d3e » John Woodell
2010-07-03 Add a link to the demo app
132
e3a10fa7 » John Woodell
2010-08-08 Update the README and clean-up the form_helper
133 ./script/server.sh
134
135 Edit the app-id in app.yaml, then publish to appspot.com
136
137 ./script/publish.sh
f28a63b6 » John Woodell
2010-07-01 more instructions
138
e3a10fa7 » John Woodell
2010-08-08 Update the README and clean-up the form_helper
139 === Use the New Rakefile
140
af4c3b78 » baroquebobcat
2010-07-31 updated readme with jruby-isms, added publish task.
141 Populate the WEB-INF/lib dir
15a06b38 » John Woodell
2010-07-25 fix link_to and image_tag
142
af4c3b78 » baroquebobcat
2010-07-31 updated readme with jruby-isms, added publish task.
143 ./script/environment.rb
15a06b38 » John Woodell
2010-07-25 fix link_to and image_tag
144
e3a10fa7 » John Woodell
2010-08-08 Update the README and clean-up the form_helper
145 Run the app locally
80d48d3e » John Woodell
2010-07-03 Add a link to the demo app
146
af4c3b78 » baroquebobcat
2010-07-31 updated readme with jruby-isms, added publish task.
147 jruby -S rake server
90e3977c » baroquebobcat
2010-07-21 added appengine_task support when running rake in jruby(live updates)
148
290eb7b5 » John Woodell
2010-07-02 clean up the instructions
149 Edit the app-id in app.yaml, then publish to appspot.com
f28a63b6 » John Woodell
2010-07-01 more instructions
150
af4c3b78 » baroquebobcat
2010-07-31 updated readme with jruby-isms, added publish task.
151 jruby -S rake publish
f28a63b6 » John Woodell
2010-07-01 more instructions
152
80d48d3e » John Woodell
2010-07-03 Add a link to the demo app
153 ===Apache License 2.0
95b1bb8e » John Woodell
2010-07-01 Update the readme
154
155 http://www.apache.org/licenses/LICENSE-2.0
Something went wrong with that request. Please try again.