jmettraux / ruote-rest
watch download tarball
public
Forks4Right
Watchers23Right
Description: restful workflow engine based on Rack and ruote (Warning : ruote-rest will be replaced by ruote-kit soon)
Homepage: http://openwferu.rubyforge.org
Clone URL: git://github.com/jmettraux/ruote-rest.git
ruote-rest / README.txt
100644 127 lines (64 sloc) 2.583 kb
raw blame history 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127

= ruote-rest
 
A RESTful instance of OpenWFEru (ruote) powered by Rack (http://rack.rubyforge.org/)
 
 
== getting it
 
Get it from GitHub or download a prepackaged release at http://rubyforge.org/frs/?group_id=2609 (and jump to '== preparing it')
 
To get Ruote and Ruote-Rest :
 
  git clone git://github.com/jmettraux/ruote-rest.git
 
Then
 
  cd ruote-rest 
  rake ruote:install
 
to install the Ruote (OpenWFEru) workflow engine and its dependencies (in a vendor/ subdirectory). Alternatively, you could do 
 
  rake ruote:gem_install
 
to get the dependencies as gems.
 
If you want to grab the gem and freeze them under vendorf/ do :
 
  rake ruote:install_freeze
 
 
== preparing it
 
To prepare the development database
 
  rake mysql:setup
 
Expects a mysql db with a 'root' admin account with sufficient access rights. 
It will create a database named "ruoterest_development".
 
(
To prepare the test database
 
  rake mysql:setup stage=test
 
To prepare the dev database with the admin 'toto'
 
  rake mysql:setup dbadmin=toto
)
 
The last step of the database preparation is loading the authentication settings :
 
  rake mysql:populate
 
These settings may be modified by editing tasks/fixtures/host.yml and/or tasks/fixtures/users.yml
 
To generate a password for a user :
 
  rake password:generate smd5 my_very_secret_password
 
or
 
  rake password:generate ssha my_very_secret_password
 
The resulting string (something like "{SMD5}HKBKsOPQ1PleLG3KOlmHTWtoNW9HVGxC") can be inserted in the fixture or in the 'password' column database for the given user.
 
 
== starting it
 
  ruby lib/start.rb
 
 
Then head to
 
  http://localhost:4567/
 
(
to start it on port 3333 :
 
  ruby lib/start.rb -p 3333
)
 
it will lead you to the "service document" with links to all the resources/
collection that make ruote-rest.
 
 
== interface
 
Just navigate the interface with your browser, everything is there.
 
 
== configuration
 
conf/db.rb
 
  database configuration
 
conf/engine.rb
 
  engine configuration
 
conf/participants.rb
conf/participants_development.yaml
 
  participants configuration, the yaml file holds the list of 
  'active participants' (the worklist in fact).
 
conf/auth.rb
 
  authentication filters, contains an HTTP basic authentication example
  and a "whitelist" authentication example.
 
 
== license
 
MIT
 
 
== feedback
 
user mailing list :        http://groups.google.com/group/openwferu-users
developers mailing list :  http://groups.google.com/group/openwferu-dev
 
issue tracker :            http://github.com/jmettraux/ruote-rest/issues/
 
irc :                      irc.freenode.net #ruote