restrack 0.0.1 → 0.0.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (3) hide show
  1. data/README.rdoc +27 -15
  2. data/lib/restrack/version.rb +1 -1
  3. metadata +4 -4
data/README.rdoc CHANGED
@@ -1,15 +1,32 @@
1
1
  = RESTRack
2
2
 
3
3
  == Description:
4
- RESTRack is an Rack-based MVC framework tailored specifically to RESTful data
5
- services.
4
+ RESTRack is a Rack based MVC framework that makes it extremely easy to
5
+ develop RESTful data services. It is inspired by Rails, and follows a few of
6
+ its conventions. But it has no routes file, routing relationships are done
7
+ through supplying custom code blocks to class methods such as
8
+ 'has_relationship_to', 'has_mapped_relationships_to',
9
+ 'has_direct_relationship_to', and 'has_direct_relationships_to'.
10
+ RESTRack aims at being lightweight and easy to use. RESTRack will
11
+ automatically render JSON and XML for the data structures you return in your
12
+ actions (any structure parsable by the 'json' and 'xml-simple' gems,
13
+ respectively).
14
+ If you supply a view for a controller action, you do that using a builder
15
+ file (view/<controller>/<action>.xml.builder). XML format requests will then
16
+ render the view template with the builder gem, rather than generating XML with
17
+ XmlSimple.
18
+
6
19
 
7
20
  == Installation:
8
21
  <sudo> gem install restrack
9
22
 
10
23
 
11
24
  == Why RESTRack when there is Rails?
12
-
25
+ Rails is a powerful tool for full web applications. RESTRack is targetted at
26
+ making development of lightweight data services as easy as possible, while
27
+ still giving you a performant and extensible framework. The primary goal of
28
+ the framework was to add as little as possible to the framework to give the
29
+ web developer a good application space for developing JSON or XML services.
13
30
 
14
31
 
15
32
  == Usage:
@@ -20,23 +37,18 @@
20
37
 
21
38
  == REST action method names
22
39
  All default RESTful controller method names align with their Rails
23
- counterparts, with more actions supported.
24
-
25
- === RESTRack:
26
- # HTTP Verb: | GET | PUT | POST | DELETE
27
- # Collection URI (/widgets/): | index | replace | create | drop
28
- # Element URI (/widgets/42): | show | update | add | destroy
40
+ counterparts, with two additional actions being supported(*).
29
41
 
30
- === Rails
31
42
  # HTTP Verb: | GET | PUT | POST | DELETE
32
- # Collection URI (/widgets/): | index | | create |
33
- # Element URI (/widgets/42): | show | update | | destroy
43
+ # Collection URI (/widgets/): | index | replace | create | *drop
44
+ # Element URI (/widgets/42): | show | update | *add | destroy
34
45
 
35
46
 
36
47
  == How-Tos
37
- === Authentication
38
-
39
- === Logging Level
48
+
49
+ ...yet to be done...
50
+
51
+ === Logging/Logging Level
40
52
 
41
53
  === XML Serialization
42
54
  ==== With Builder
@@ -1,3 +1,3 @@
1
1
  module RESTRack
2
- VERSION = "0.0.1"
2
+ VERSION = "0.0.2"
3
3
  end
metadata CHANGED
@@ -1,13 +1,13 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: restrack
3
3
  version: !ruby/object:Gem::Version
4
- hash: 29
4
+ hash: 27
5
5
  prerelease: false
6
6
  segments:
7
7
  - 0
8
8
  - 0
9
- - 1
10
- version: 0.0.1
9
+ - 2
10
+ version: 0.0.2
11
11
  platform: ruby
12
12
  authors:
13
13
  - Chris St. John
@@ -15,7 +15,7 @@ autorequire:
15
15
  bindir: bin
16
16
  cert_chain: []
17
17
 
18
- date: 2011-01-25 00:00:00 -05:00
18
+ date: 2011-01-26 00:00:00 -05:00
19
19
  default_executable:
20
20
  dependencies:
21
21
  - !ruby/object:Gem::Dependency