README_FOR_TEMPLATE
2.7 KB
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
This is Heroku Suspenders, the thoughtbot Rails template modified to be used for
deployment to Heroku. To create a new project, checkout this repository and run:
./script/create_project projectname
This will create a project in ../projectname. You should then follow the
instructions to deploy to Heroku. This script creates an
entirely new git repository, and is not meant to be used against an existing
repo.
When making a change to a project that was created via this template, consider
whether it's a change that should be made across all projects. If so, then
make the change in this template, and pull it into your project via:
git pull heroku_suspenders master
About Suspenders
----------------
Suspenders was created for use at thoughtbot, inc. (http://thoughtbot.com) as a
baseline application setup, with intelligent defaults.
Suspenders currently runs on Rails 2.3.2.
Gems (in .gems):
----------------
For testing:
mocha
thoughtbot-factory_girl
thoughtbot-shoulda
For file uploads:
thoughtbot-paperclip
right_aws
For email through SMTP (particularly Gmail):
ambethia-smtp-tls
For background processing:
tobi-delayed_job
Plugins (in vendor/plugins):
----------------------------
For authentication:
thoughtbot-clearance
For exception notification:
hoptoad_notifier
For models, controllers, helpers, & features generators:
coulda
For rake tasks:
limerick_rake
Initializers (in config/initializers)
-------------------------------------
For email through SMTP (particularly Gmail):
mail.rb
Get your API key at http://hoptoadapp.com
hoptoad.rb
Get your free Google Analytics account at http://www.google.com/analytics
google_anayltics.rb
For Delayed Job settings:
delayed_job.rb
Two time formats are available by default, :short_date and :long_date. Add other time formats here.
time_formats.rb
Testing
-------
Testing is done utilizing Test::Unit, Shoulda, factory_girl, and mocha.
Shoulda is a pragmatic testing framework for TDD built on top of Test::Unit.
thoughtbot-shoulda --version '>= 2.10.1' --source gems.github.com
factory_girl is a fixture replacement library, following the factory pattern.
Place your factories in test/factories.rb. The fixture directory has been
removed, as fixtures are not used.
thoughtbot-factory_girl --version '>= 1.2.0' --source gems.github.com
Mocha is a widely-used mocking library, including by Rails itself. We use a fork
from Joe Ferris that adds test spies (assert_received) to Mocha.
jferris-mocha --version '0.9.5.0.1241126838' --source gems.github.com
Mascot
------
The official Suspenders mascot is Suspenders Boy:
http://media.tumblr.com/1TEAMALpseh5xzf0Jt6bcwSMo1_400.png