railroady 0.9.0 → 0.11.0
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.
- 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