railroady 0.9.0 → 0.11.0
Sign up to get free protection for your applications and to get access to all the features.
- data/CHANGELOG.rdoc +4 -0
- data/README.rdoc +25 -10
- data/VERSION.yml +3 -3
- data/lib/railroady/railtie.rb +1 -2
- metadata +2 -2
data/CHANGELOG.rdoc
CHANGED
data/README.rdoc
CHANGED
@@ -1,20 +1,35 @@
|
|
1
1
|
= RailRoady
|
2
2
|
|
3
|
-
RailRoady generates
|
4
|
-
Rails application.
|
3
|
+
RailRoady generates Rails 3 model and controller UML diagrams as cross-platform .svg files, as well as in the DOT language.
|
5
4
|
|
6
|
-
|
5
|
+
Code is based on the original "railroad" gem, patched and maintained over the years. Lineage can be traced via GitHub.
|
7
6
|
|
8
|
-
I (
|
9
|
-
|
10
|
-
|
7
|
+
I (Preston Lee) am not trying to hijack Peter Hoeg or Javier's project, but rather create a dedicated, lean gem that can be used without major issue on Rails v3 projects. Rails v2 is not supported.
|
8
|
+
|
9
|
+
= System Requirements
|
10
|
+
|
11
|
+
You MUST have the the following utilities available at the command line.
|
12
|
+
* `dot` and `neato`. MacPorts users can install in via `sudo port install graphviz`.
|
13
|
+
|
14
|
+
* `sed`, which should already be available on all sane UNIX systems.
|
11
15
|
|
12
16
|
= Usage
|
13
17
|
|
14
|
-
|
15
|
-
|
16
|
-
|
17
|
-
|
18
|
+
The easiest (and recommend) usage is to include railroady as a development dependency with your Rails 3 Gemfile, like so...
|
19
|
+
|
20
|
+
group :development, :test do
|
21
|
+
gem 'railroady'
|
22
|
+
end
|
23
|
+
|
24
|
+
...and then run the master rake task...
|
25
|
+
|
26
|
+
rake diagram:all
|
27
|
+
|
28
|
+
This should generate four doc/*.svg files that can be opened in (most) web browsers as well as dedicate document viewers supporting the Scalable Vector Graphics format.
|
29
|
+
|
30
|
+
= Alternate Usage
|
31
|
+
|
32
|
+
Alternatively, you may run the 'railroady' command-line program at the Rails application's root directory. You can redirect its output to a .dot file or pipe it to the dot or neato utilities to produce a graphic. Model diagrams are intended to be processed using dot and controller diagrams are best processed using neato.
|
18
33
|
|
19
34
|
railroad [options] command
|
20
35
|
|
data/VERSION.yml
CHANGED
data/lib/railroady/railtie.rb
CHANGED