Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 106 lines (70 sloc) 3.304 kb
f28a63b more instructions
John Woodell authored
1 =Dubious for App Engine
3e52600 @takeru first commit
takeru authored
2
29669b6 compiles, but the new controller not yet complete
John Woodell authored
3 See the published demo: http://dubious-demo.appspot.com
80d48d3 Add a link to the demo app
John Woodell authored
4
5 ===Introducing Dubious
fd9faec @baroquebobcat preping readme for merging into mirah/dubious
baroquebobcat authored
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.
38a3de9 update Duby references to Mirah
John Woodell authored
9 Mirah has no runtime dependencies, everything is compiled ahead-of-time.
fd9faec @baroquebobcat preping readme for merging into mirah/dubious
baroquebobcat authored
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
d6f21c7 update the copy
John Woodell authored
12 similar to DataMapper.
80d48d3 Add a link to the demo app
John Woodell authored
13
38a3de9 update Duby references to Mirah
John Woodell authored
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
80d48d3 Add a link to the demo app
John Woodell authored
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
508eaea @baroquebobcat updated readme instructions
baroquebobcat authored
20 make. Mirah uses the Java type system. Join the mirah mailing list to get
21 involved: http://groups.google.com/group/mirah
80d48d3 Add a link to the demo app
John Woodell authored
22
508eaea @baroquebobcat updated readme instructions
baroquebobcat authored
23 === Getting Started
24
d9d6cb0 @baroquebobcat add note about needing jruby
baroquebobcat authored
25 Install Dubious(Note: Dubious requires JRuby).
7236842 @baroquebobcat clean up readme with working instructions, remove old instructions
baroquebobcat authored
26
27 gem install dubious
508eaea @baroquebobcat updated readme instructions
baroquebobcat authored
28
29 This will add a `dubious` command that you can create new apps, generate controllers and models etc with.
30
31 Once dubious is installed, you can generate an app skeleton.
32
33 dubious new my-app
34 cd my-app
35
36 ===Directory Layout
37
38 The layout is based on Rails' with some Java WAR directories, and files geared towards deploying on AppEngine.
39
40 * WEB-INF/app.yaml
f03d12d @baroquebobcat update description of app.yaml
baroquebobcat authored
41 contains handlers for different routes, as well as filters and settings for serving static files.
508eaea @baroquebobcat updated readme instructions
baroquebobcat authored
42
f03d12d @baroquebobcat update description of app.yaml
baroquebobcat authored
43 http://code.google.com/appengine/docs/java/configyaml/appconfig_yaml.html
508eaea @baroquebobcat updated readme instructions
baroquebobcat authored
44
45 ==Hacking on Dubious
38a3de9 update Duby references to Mirah
John Woodell authored
46 ===Setup the Mirah development environment
3e52600 @takeru first commit
takeru authored
47
7236842 @baroquebobcat clean up readme with working instructions, remove old instructions
baroquebobcat authored
48 * Install JRuby. You can find good instructions on the JRuby website http://jruby.org/
49 * Install the prerelease appengine-sdk gem from http://code.google.com/p/appengine-jruby/
3e52600 @takeru first commit
takeru authored
50
7236842 @baroquebobcat clean up readme with working instructions, remove old instructions
baroquebobcat authored
51 * Now git clone bitescript, mirah and dubious to your drive
3e52600 @takeru first commit
takeru authored
52
290eb7b clean up the instructions
John Woodell authored
53 mkdir -p ~/mystuff; cd ~/mystuff
3e52600 @takeru first commit
takeru authored
54 git clone http://github.com/headius/bitescript.git
508eaea @baroquebobcat updated readme instructions
baroquebobcat authored
55 git clone http://github.com/mirah/mirah.git
32feb42 @baroquebobcat got everything working properly except rake server,
baroquebobcat authored
56 git clone http://github.com/mirah/mirah_model.git
9136442 @baroquebobcat small doc fix: fixing url for dubious repo in commandline instructions
baroquebobcat authored
57 git clone http://github.com/mirah/dubious.git
3e52600 @takeru first commit
takeru authored
58
7236842 @baroquebobcat clean up readme with working instructions, remove old instructions
baroquebobcat authored
59 * Then build and install the gems for Mirah, Bitescript and Dubious
5075b54 better instructions
John Woodell authored
60
7236842 @baroquebobcat clean up readme with working instructions, remove old instructions
baroquebobcat authored
61 cd bitescript
62 gem build bitescript.gemspec
63 gem install bitescript-*
64 cd -
65 cd mirah
66 rake jar:bootstrap
67 gem build mirah.gemspec
68 gem install mirah-*
69 cd -
70 cd dubious
b2f6b2d @baroquebobcat update readme to reflect new rake task
baroquebobcat authored
71 rake gem
72 gem install pkg/dubious-*
7236842 @baroquebobcat clean up readme with working instructions, remove old instructions
baroquebobcat authored
73 cd -
426d862 @hakunin
hakunin authored
74
75
7a6bed5 @baroquebobcat use rake in readme
baroquebobcat authored
76 To build the gem (requires RubyGems ~> 1.5.0 to build)
8d91393 @baroquebobcat add docs around gemy goodness.
baroquebobcat authored
77
7a6bed5 @baroquebobcat use rake in readme
baroquebobcat authored
78 rake package
8d91393 @baroquebobcat add docs around gemy goodness.
baroquebobcat authored
79
80d48d3 Add a link to the demo app
John Woodell authored
80 ===Developing your App
81
8d91393 @baroquebobcat add docs around gemy goodness.
baroquebobcat authored
82 Install the gem
83
84 jgem install dubious
85
86 Generate your app
5782af1 more detail about ho to get started
John Woodell authored
87
8d91393 @baroquebobcat add docs around gemy goodness.
baroquebobcat authored
88 dubious new my-app
89 cd my-app
5782af1 more detail about ho to get started
John Woodell authored
90
e3a10fa Update the README and clean-up the form_helper
John Woodell authored
91 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.
92
93 === Use the New Rakefile
94
95 Run the app locally
80d48d3 Add a link to the demo app
John Woodell authored
96
af4c3b7 @baroquebobcat updated readme with jruby-isms, added publish task.
baroquebobcat authored
97 jruby -S rake server
90e3977 @baroquebobcat added appengine_task support when running rake in jruby(live updates)
baroquebobcat authored
98
290eb7b clean up the instructions
John Woodell authored
99 Edit the app-id in app.yaml, then publish to appspot.com
f28a63b more instructions
John Woodell authored
100
af4c3b7 @baroquebobcat updated readme with jruby-isms, added publish task.
baroquebobcat authored
101 jruby -S rake publish
f28a63b more instructions
John Woodell authored
102
80d48d3 Add a link to the demo app
John Woodell authored
103 ===Apache License 2.0
95b1bb8 Update the readme
John Woodell authored
104
105 http://www.apache.org/licenses/LICENSE-2.0
Something went wrong with that request. Please try again.