restrack 0.0.1 → 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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