aliddle-sass 1.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (238) hide show
  1. data/.yardopts +11 -0
  2. data/CONTRIBUTING +3 -0
  3. data/MIT-LICENSE +20 -0
  4. data/README.md +201 -0
  5. data/Rakefile +347 -0
  6. data/VERSION +1 -0
  7. data/VERSION_NAME +1 -0
  8. data/bin/sass +9 -0
  9. data/bin/sass-convert +8 -0
  10. data/bin/scss +9 -0
  11. data/extra/update_watch.rb +13 -0
  12. data/init.rb +18 -0
  13. data/lib/sass.rb +95 -0
  14. data/lib/sass/cache_stores.rb +15 -0
  15. data/lib/sass/cache_stores/base.rb +88 -0
  16. data/lib/sass/cache_stores/chain.rb +33 -0
  17. data/lib/sass/cache_stores/filesystem.rb +60 -0
  18. data/lib/sass/cache_stores/memory.rb +47 -0
  19. data/lib/sass/cache_stores/null.rb +25 -0
  20. data/lib/sass/callbacks.rb +66 -0
  21. data/lib/sass/css.rb +409 -0
  22. data/lib/sass/engine.rb +928 -0
  23. data/lib/sass/environment.rb +101 -0
  24. data/lib/sass/error.rb +201 -0
  25. data/lib/sass/exec.rb +707 -0
  26. data/lib/sass/importers.rb +22 -0
  27. data/lib/sass/importers/base.rb +139 -0
  28. data/lib/sass/importers/filesystem.rb +190 -0
  29. data/lib/sass/logger.rb +15 -0
  30. data/lib/sass/logger/base.rb +32 -0
  31. data/lib/sass/logger/log_level.rb +49 -0
  32. data/lib/sass/media.rb +213 -0
  33. data/lib/sass/plugin.rb +132 -0
  34. data/lib/sass/plugin/compiler.rb +406 -0
  35. data/lib/sass/plugin/configuration.rb +123 -0
  36. data/lib/sass/plugin/generic.rb +15 -0
  37. data/lib/sass/plugin/merb.rb +48 -0
  38. data/lib/sass/plugin/rack.rb +60 -0
  39. data/lib/sass/plugin/rails.rb +47 -0
  40. data/lib/sass/plugin/staleness_checker.rb +183 -0
  41. data/lib/sass/railtie.rb +9 -0
  42. data/lib/sass/repl.rb +57 -0
  43. data/lib/sass/root.rb +7 -0
  44. data/lib/sass/script.rb +39 -0
  45. data/lib/sass/script/arg_list.rb +52 -0
  46. data/lib/sass/script/bool.rb +18 -0
  47. data/lib/sass/script/color.rb +606 -0
  48. data/lib/sass/script/css_lexer.rb +29 -0
  49. data/lib/sass/script/css_parser.rb +31 -0
  50. data/lib/sass/script/funcall.rb +237 -0
  51. data/lib/sass/script/functions.rb +1543 -0
  52. data/lib/sass/script/interpolation.rb +79 -0
  53. data/lib/sass/script/lexer.rb +348 -0
  54. data/lib/sass/script/list.rb +85 -0
  55. data/lib/sass/script/literal.rb +221 -0
  56. data/lib/sass/script/node.rb +99 -0
  57. data/lib/sass/script/null.rb +37 -0
  58. data/lib/sass/script/number.rb +453 -0
  59. data/lib/sass/script/operation.rb +110 -0
  60. data/lib/sass/script/parser.rb +495 -0
  61. data/lib/sass/script/string.rb +51 -0
  62. data/lib/sass/script/string_interpolation.rb +103 -0
  63. data/lib/sass/script/unary_operation.rb +69 -0
  64. data/lib/sass/script/variable.rb +58 -0
  65. data/lib/sass/scss.rb +16 -0
  66. data/lib/sass/scss/css_parser.rb +36 -0
  67. data/lib/sass/scss/parser.rb +1179 -0
  68. data/lib/sass/scss/rx.rb +133 -0
  69. data/lib/sass/scss/script_lexer.rb +15 -0
  70. data/lib/sass/scss/script_parser.rb +25 -0
  71. data/lib/sass/scss/static_parser.rb +54 -0
  72. data/lib/sass/selector.rb +452 -0
  73. data/lib/sass/selector/abstract_sequence.rb +94 -0
  74. data/lib/sass/selector/comma_sequence.rb +92 -0
  75. data/lib/sass/selector/sequence.rb +507 -0
  76. data/lib/sass/selector/simple.rb +119 -0
  77. data/lib/sass/selector/simple_sequence.rb +212 -0
  78. data/lib/sass/shared.rb +76 -0
  79. data/lib/sass/supports.rb +229 -0
  80. data/lib/sass/tree/charset_node.rb +22 -0
  81. data/lib/sass/tree/comment_node.rb +82 -0
  82. data/lib/sass/tree/content_node.rb +9 -0
  83. data/lib/sass/tree/css_import_node.rb +60 -0
  84. data/lib/sass/tree/debug_node.rb +18 -0
  85. data/lib/sass/tree/directive_node.rb +42 -0
  86. data/lib/sass/tree/each_node.rb +24 -0
  87. data/lib/sass/tree/extend_node.rb +36 -0
  88. data/lib/sass/tree/for_node.rb +36 -0
  89. data/lib/sass/tree/function_node.rb +34 -0
  90. data/lib/sass/tree/if_node.rb +52 -0
  91. data/lib/sass/tree/import_node.rb +75 -0
  92. data/lib/sass/tree/media_node.rb +58 -0
  93. data/lib/sass/tree/mixin_def_node.rb +38 -0
  94. data/lib/sass/tree/mixin_node.rb +39 -0
  95. data/lib/sass/tree/node.rb +196 -0
  96. data/lib/sass/tree/prop_node.rb +152 -0
  97. data/lib/sass/tree/return_node.rb +18 -0
  98. data/lib/sass/tree/root_node.rb +28 -0
  99. data/lib/sass/tree/rule_node.rb +132 -0
  100. data/lib/sass/tree/supports_node.rb +51 -0
  101. data/lib/sass/tree/trace_node.rb +32 -0
  102. data/lib/sass/tree/variable_node.rb +30 -0
  103. data/lib/sass/tree/visitors/base.rb +75 -0
  104. data/lib/sass/tree/visitors/check_nesting.rb +147 -0
  105. data/lib/sass/tree/visitors/convert.rb +316 -0
  106. data/lib/sass/tree/visitors/cssize.rb +229 -0
  107. data/lib/sass/tree/visitors/deep_copy.rb +102 -0
  108. data/lib/sass/tree/visitors/extend.rb +68 -0
  109. data/lib/sass/tree/visitors/perform.rb +446 -0
  110. data/lib/sass/tree/visitors/set_options.rb +125 -0
  111. data/lib/sass/tree/visitors/to_css.rb +230 -0
  112. data/lib/sass/tree/warn_node.rb +18 -0
  113. data/lib/sass/tree/while_node.rb +18 -0
  114. data/lib/sass/util.rb +906 -0
  115. data/lib/sass/util/multibyte_string_scanner.rb +155 -0
  116. data/lib/sass/util/subset_map.rb +109 -0
  117. data/lib/sass/util/test.rb +10 -0
  118. data/lib/sass/version.rb +126 -0
  119. data/rails/init.rb +1 -0
  120. data/test/Gemfile +3 -0
  121. data/test/Gemfile.lock +10 -0
  122. data/test/sass/cache_test.rb +89 -0
  123. data/test/sass/callbacks_test.rb +61 -0
  124. data/test/sass/conversion_test.rb +1760 -0
  125. data/test/sass/css2sass_test.rb +439 -0
  126. data/test/sass/data/hsl-rgb.txt +319 -0
  127. data/test/sass/engine_test.rb +3243 -0
  128. data/test/sass/exec_test.rb +86 -0
  129. data/test/sass/extend_test.rb +1461 -0
  130. data/test/sass/fixtures/test_staleness_check_across_importers.css +1 -0
  131. data/test/sass/fixtures/test_staleness_check_across_importers.scss +1 -0
  132. data/test/sass/functions_test.rb +1139 -0
  133. data/test/sass/importer_test.rb +192 -0
  134. data/test/sass/logger_test.rb +58 -0
  135. data/test/sass/mock_importer.rb +49 -0
  136. data/test/sass/more_results/more1.css +9 -0
  137. data/test/sass/more_results/more1_with_line_comments.css +26 -0
  138. data/test/sass/more_results/more_import.css +29 -0
  139. data/test/sass/more_templates/_more_partial.sass +2 -0
  140. data/test/sass/more_templates/more1.sass +23 -0
  141. data/test/sass/more_templates/more_import.sass +11 -0
  142. data/test/sass/plugin_test.rb +550 -0
  143. data/test/sass/results/alt.css +4 -0
  144. data/test/sass/results/basic.css +9 -0
  145. data/test/sass/results/cached_import_option.css +3 -0
  146. data/test/sass/results/compact.css +5 -0
  147. data/test/sass/results/complex.css +86 -0
  148. data/test/sass/results/compressed.css +1 -0
  149. data/test/sass/results/expanded.css +19 -0
  150. data/test/sass/results/filename_fn.css +3 -0
  151. data/test/sass/results/if.css +3 -0
  152. data/test/sass/results/import.css +31 -0
  153. data/test/sass/results/import_charset.css +5 -0
  154. data/test/sass/results/import_charset_1_8.css +5 -0
  155. data/test/sass/results/import_charset_ibm866.css +5 -0
  156. data/test/sass/results/import_content.css +1 -0
  157. data/test/sass/results/line_numbers.css +49 -0
  158. data/test/sass/results/mixins.css +95 -0
  159. data/test/sass/results/multiline.css +24 -0
  160. data/test/sass/results/nested.css +22 -0
  161. data/test/sass/results/options.css +1 -0
  162. data/test/sass/results/parent_ref.css +13 -0
  163. data/test/sass/results/script.css +16 -0
  164. data/test/sass/results/scss_import.css +31 -0
  165. data/test/sass/results/scss_importee.css +2 -0
  166. data/test/sass/results/subdir/nested_subdir/nested_subdir.css +1 -0
  167. data/test/sass/results/subdir/subdir.css +3 -0
  168. data/test/sass/results/units.css +11 -0
  169. data/test/sass/results/warn.css +0 -0
  170. data/test/sass/results/warn_imported.css +0 -0
  171. data/test/sass/script_conversion_test.rb +299 -0
  172. data/test/sass/script_test.rb +591 -0
  173. data/test/sass/scss/css_test.rb +1093 -0
  174. data/test/sass/scss/rx_test.rb +156 -0
  175. data/test/sass/scss/scss_test.rb +2043 -0
  176. data/test/sass/scss/test_helper.rb +37 -0
  177. data/test/sass/templates/_cached_import_option_partial.scss +1 -0
  178. data/test/sass/templates/_double_import_loop2.sass +1 -0
  179. data/test/sass/templates/_filename_fn_import.scss +11 -0
  180. data/test/sass/templates/_imported_charset_ibm866.sass +4 -0
  181. data/test/sass/templates/_imported_charset_utf8.sass +4 -0
  182. data/test/sass/templates/_imported_content.sass +3 -0
  183. data/test/sass/templates/_partial.sass +2 -0
  184. data/test/sass/templates/_same_name_different_partiality.scss +1 -0
  185. data/test/sass/templates/alt.sass +16 -0
  186. data/test/sass/templates/basic.sass +23 -0
  187. data/test/sass/templates/bork1.sass +2 -0
  188. data/test/sass/templates/bork2.sass +2 -0
  189. data/test/sass/templates/bork3.sass +2 -0
  190. data/test/sass/templates/bork4.sass +2 -0
  191. data/test/sass/templates/bork5.sass +3 -0
  192. data/test/sass/templates/cached_import_option.scss +3 -0
  193. data/test/sass/templates/compact.sass +17 -0
  194. data/test/sass/templates/complex.sass +305 -0
  195. data/test/sass/templates/compressed.sass +15 -0
  196. data/test/sass/templates/double_import_loop1.sass +1 -0
  197. data/test/sass/templates/expanded.sass +17 -0
  198. data/test/sass/templates/filename_fn.scss +18 -0
  199. data/test/sass/templates/if.sass +11 -0
  200. data/test/sass/templates/import.sass +12 -0
  201. data/test/sass/templates/import_charset.sass +9 -0
  202. data/test/sass/templates/import_charset_1_8.sass +6 -0
  203. data/test/sass/templates/import_charset_ibm866.sass +11 -0
  204. data/test/sass/templates/import_content.sass +4 -0
  205. data/test/sass/templates/importee.less +2 -0
  206. data/test/sass/templates/importee.sass +19 -0
  207. data/test/sass/templates/line_numbers.sass +13 -0
  208. data/test/sass/templates/mixin_bork.sass +5 -0
  209. data/test/sass/templates/mixins.sass +76 -0
  210. data/test/sass/templates/multiline.sass +20 -0
  211. data/test/sass/templates/nested.sass +25 -0
  212. data/test/sass/templates/nested_bork1.sass +2 -0
  213. data/test/sass/templates/nested_bork2.sass +2 -0
  214. data/test/sass/templates/nested_bork3.sass +2 -0
  215. data/test/sass/templates/nested_bork4.sass +2 -0
  216. data/test/sass/templates/nested_import.sass +2 -0
  217. data/test/sass/templates/nested_mixin_bork.sass +6 -0
  218. data/test/sass/templates/options.sass +2 -0
  219. data/test/sass/templates/parent_ref.sass +25 -0
  220. data/test/sass/templates/same_name_different_ext.sass +2 -0
  221. data/test/sass/templates/same_name_different_ext.scss +1 -0
  222. data/test/sass/templates/same_name_different_partiality.scss +1 -0
  223. data/test/sass/templates/script.sass +101 -0
  224. data/test/sass/templates/scss_import.scss +11 -0
  225. data/test/sass/templates/scss_importee.scss +1 -0
  226. data/test/sass/templates/single_import_loop.sass +1 -0
  227. data/test/sass/templates/subdir/nested_subdir/_nested_partial.sass +2 -0
  228. data/test/sass/templates/subdir/nested_subdir/nested_subdir.sass +3 -0
  229. data/test/sass/templates/subdir/subdir.sass +6 -0
  230. data/test/sass/templates/units.sass +11 -0
  231. data/test/sass/templates/warn.sass +3 -0
  232. data/test/sass/templates/warn_imported.sass +4 -0
  233. data/test/sass/test_helper.rb +8 -0
  234. data/test/sass/util/multibyte_string_scanner_test.rb +147 -0
  235. data/test/sass/util/subset_map_test.rb +91 -0
  236. data/test/sass/util_test.rb +313 -0
  237. data/test/test_helper.rb +80 -0
  238. metadata +348 -0
data/.yardopts ADDED
@@ -0,0 +1,11 @@
1
+ --readme README.md
2
+ --markup markdown
3
+ --markup-provider maruku
4
+ --default-return ""
5
+ --title "Sass Documentation"
6
+ --query 'object.type != :classvariable'
7
+ --query 'object.type != :constant || @api && @api.text == "public"'
8
+ --hide-void-return
9
+ --protected
10
+ --no-private
11
+ --no-highlight
data/CONTRIBUTING ADDED
@@ -0,0 +1,3 @@
1
+ Contributions are welcomed. Please see the following sites for guidelines:
2
+
3
+ http://sass-lang.com/development.html#contributing
data/MIT-LICENSE ADDED
@@ -0,0 +1,20 @@
1
+ Copyright (c) 2006-2013 Hampton Catlin, Nathan Weizenbaum, and Chris Eppstein
2
+
3
+ Permission is hereby granted, free of charge, to any person obtaining
4
+ a copy of this software and associated documentation files (the
5
+ "Software"), to deal in the Software without restriction, including
6
+ without limitation the rights to use, copy, modify, merge, publish,
7
+ distribute, sublicense, and/or sell copies of the Software, and to
8
+ permit persons to whom the Software is furnished to do so, subject to
9
+ the following conditions:
10
+
11
+ The above copyright notice and this permission notice shall be
12
+ included in all copies or substantial portions of the Software.
13
+
14
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
15
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
16
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
17
+ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
18
+ LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
19
+ OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
20
+ WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
data/README.md ADDED
@@ -0,0 +1,201 @@
1
+ # Sass [![Gem Version](https://badge.fury.io/rb/sass.png)](http://badge.fury.io/rb/sass)
2
+
3
+ **Sass makes CSS fun again**. Sass is an extension of CSS3,
4
+ adding nested rules, variables, mixins, selector inheritance, and more.
5
+ It's translated to well-formatted, standard CSS
6
+ using the command line tool or a web-framework plugin.
7
+
8
+ Sass has two syntaxes. The new main syntax (as of Sass 3)
9
+ is known as "SCSS" (for "Sassy CSS"),
10
+ and is a superset of CSS3's syntax.
11
+ This means that every valid CSS3 stylesheet is valid SCSS as well.
12
+ SCSS files use the extension `.scss`.
13
+
14
+ The second, older syntax is known as the indented syntax (or just "Sass").
15
+ Inspired by Haml's terseness, it's intended for people
16
+ who prefer conciseness over similarity to CSS.
17
+ Instead of brackets and semicolons,
18
+ it uses the indentation of lines to specify blocks.
19
+ Although no longer the primary syntax,
20
+ the indented syntax will continue to be supported.
21
+ Files in the indented syntax use the extension `.sass`.
22
+
23
+ ## Using
24
+
25
+ Sass can be used from the command line
26
+ or as part of a web framework.
27
+ The first step is to install the gem:
28
+
29
+ gem install sass
30
+
31
+ After you convert some CSS to Sass, you can run
32
+
33
+ sass style.scss
34
+
35
+ to compile it back to CSS.
36
+ For more information on these commands, check out
37
+
38
+ sass --help
39
+
40
+ To install Sass in Rails 2,
41
+ just add `config.gem "sass"` to `config/environment.rb`.
42
+ In Rails 3, add `gem "sass"` to your Gemfile instead.
43
+ `.sass` or `.scss` files should be placed in `public/stylesheets/sass`,
44
+ where they'll be automatically compiled
45
+ to corresponding CSS files in `public/stylesheets` when needed
46
+ (the Sass template directory is customizable...
47
+ see [the Sass reference](http://sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#template_location-option) for details).
48
+
49
+ Sass can also be used with any Rack-enabled web framework.
50
+ To do so, just add
51
+
52
+ require 'sass/plugin/rack'
53
+ use Sass::Plugin::Rack
54
+
55
+ to `config.ru`.
56
+ Then any Sass files in `public/stylesheets/sass`
57
+ will be compiled into CSS files in `public/stylesheets` on every request.
58
+
59
+ To use Sass programmatically,
60
+ check out the [YARD documentation](http://sass-lang.com/docs/yardoc/).
61
+
62
+ ## Formatting
63
+
64
+ Sass is an extension of CSS
65
+ that adds power and elegance to the basic language.
66
+ It allows you to use [variables][vars], [nested rules][nested],
67
+ [mixins][mixins], [inline imports][imports],
68
+ and more, all with a fully CSS-compatible syntax.
69
+ Sass helps keep large stylesheets well-organized,
70
+ and get small stylesheets up and running quickly,
71
+ particularly with the help of
72
+ [the Compass style library](http://compass-style.org).
73
+
74
+ [vars]: http://beta.sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#variables_
75
+ [nested]: http://beta.sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#nested_rules_
76
+ [mixins]: http://beta.sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#mixins
77
+ [imports]: http://beta.sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#import
78
+
79
+ Sass has two syntaxes.
80
+ The one presented here, known as "SCSS" (for "Sassy CSS"),
81
+ is fully CSS-compatible.
82
+ The other (older) syntax, known as the indented syntax or just "Sass",
83
+ is whitespace-sensitive and indentation-based.
84
+ For more information, see the [reference documentation][syntax].
85
+
86
+ [syntax]: http://beta.sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#syntax
87
+
88
+ To run the following examples and see the CSS they produce,
89
+ put them in a file called `test.scss` and run `sass test.scss`.
90
+
91
+ ### Nesting
92
+
93
+ Sass avoids repetition by nesting selectors within one another.
94
+ The same thing works for properties.
95
+
96
+ table.hl {
97
+ margin: 2em 0;
98
+ td.ln { text-align: right; }
99
+ }
100
+
101
+ li {
102
+ font: {
103
+ family: serif;
104
+ weight: bold;
105
+ size: 1.2em;
106
+ }
107
+ }
108
+
109
+ ### Variables
110
+
111
+ Use the same color all over the place?
112
+ Need to do some math with height and width and text size?
113
+ Sass supports variables, math operations, and many useful functions.
114
+
115
+ $blue: #3bbfce;
116
+ $margin: 16px;
117
+
118
+ .content_navigation {
119
+ border-color: $blue;
120
+ color: darken($blue, 10%);
121
+ }
122
+
123
+ .border {
124
+ padding: $margin / 2;
125
+ margin: $margin / 2;
126
+ border-color: $blue;
127
+ }
128
+
129
+ ### Mixins
130
+
131
+ Even more powerful than variables,
132
+ mixins allow you to re-use whole chunks of CSS,
133
+ properties or selectors.
134
+ You can even give them arguments.
135
+
136
+ @mixin table-scaffolding {
137
+ th {
138
+ text-align: center;
139
+ font-weight: bold;
140
+ }
141
+ td, th { padding: 2px; }
142
+ }
143
+
144
+ @mixin left($dist) {
145
+ float: left;
146
+ margin-left: $dist;
147
+ }
148
+
149
+ #data {
150
+ @include left(10px);
151
+ @include table-scaffolding;
152
+ }
153
+
154
+ A comprehensive list of features is available
155
+ in the [Sass reference](http://beta.sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html).
156
+
157
+ ## Executables
158
+
159
+ The Sass gem includes several executables that are useful
160
+ for dealing with Sass from the command line.
161
+
162
+ ### `sass`
163
+
164
+ The `sass` executable transforms a source Sass file into CSS.
165
+ See `sass --help` for further information and options.
166
+
167
+ ### `sass-convert`
168
+
169
+ The `sass-convert` executable converts between CSS, Sass, and SCSS.
170
+ When converting from CSS to Sass or SCSS,
171
+ nesting is applied where appropriate.
172
+ See `sass-convert --help` for further information and options.
173
+
174
+ ## Authors
175
+
176
+ Sass was envisioned by [Hampton Catlin](http://www.hamptoncatlin.com)
177
+ (@hcatlin). However, Hampton doesn't even know his way around the code anymore
178
+ and now occasionally consults on the language issues. Hampton lives in San
179
+ Francisco, California and works as VP of Technology
180
+ at [Moovweb](http://www.moovweb.com/).
181
+
182
+ [Nathan Weizenbaum](http://nex-3.com) is the primary developer and architect of
183
+ Sass. His hard work has kept the project alive by endlessly answering forum
184
+ posts, fixing bugs, refactoring, finding speed improvements, writing
185
+ documentation, implementing new features, and getting Hampton coffee (a fitting
186
+ task for a boy-genius). Nathan lives in Seattle, Washington and works on
187
+ [Dart](http://dartlang.org) application libraries at Google.
188
+
189
+ [Chris Eppstein](http://acts-as-architect.blogspot.com) is a core contributor to
190
+ Sass and the creator of Compass, the first Sass-based framework. Chris focuses
191
+ on making Sass more powerful, easy to use, and on ways to speed its adoption
192
+ through the web development community. Chris lives in San Jose, California with
193
+ his wife and daughter. He is the Software Architect for
194
+ [Caring.com](http://caring.com), a website devoted to the 34 Million caregivers
195
+ whose parents are sick or elderly, that uses Haml and Sass.
196
+
197
+ If you use this software, you must pay Hampton a compliment. And
198
+ buy Nathan some jelly beans. Maybe pet a kitten. Yeah. Pet that kitty.
199
+
200
+ Beyond that, the implementation is licensed under the MIT License.
201
+ Okay, fine, I guess that means compliments aren't __required__.
data/Rakefile ADDED
@@ -0,0 +1,347 @@
1
+ # ----- Utility Functions -----
2
+
3
+ def scope(path)
4
+ File.join(File.dirname(__FILE__), path)
5
+ end
6
+
7
+ # ----- Default: Testing ------
8
+
9
+ task :default => :test
10
+
11
+ require 'rake/testtask'
12
+
13
+ Rake::TestTask.new do |t|
14
+ t.libs << 'test'
15
+ test_files = FileList[scope('test/**/*_test.rb')]
16
+ test_files.exclude(scope('test/rails/*'))
17
+ test_files.exclude(scope('test/plugins/*'))
18
+ t.test_files = test_files
19
+ t.verbose = true
20
+ end
21
+
22
+ # ----- Packaging -----
23
+
24
+ # Don't use Rake::GemPackageTast because we want prerequisites to run
25
+ # before we load the gemspec.
26
+ desc "Build all the packages."
27
+ task :package => [:revision_file, :date_file, :submodules, :permissions] do
28
+ version = get_version
29
+ File.open(scope('VERSION'), 'w') {|f| f.puts(version)}
30
+ load scope('sass.gemspec')
31
+ Gem::Builder.new(SASS_GEMSPEC).build
32
+ sh %{git checkout VERSION}
33
+
34
+ pkg = "#{SASS_GEMSPEC.name}-#{SASS_GEMSPEC.version}"
35
+ mkdir_p "pkg"
36
+ verbose(true) {mv "#{pkg}.gem", "pkg/#{pkg}.gem"}
37
+
38
+ sh %{rm -f pkg/#{pkg}.tar.gz}
39
+ verbose(false) {SASS_GEMSPEC.files.each {|f| sh %{tar rf pkg/#{pkg}.tar #{f}}}}
40
+ sh %{gzip pkg/#{pkg}.tar}
41
+ end
42
+
43
+ task :permissions do
44
+ sh %{chmod -R a+rx bin}
45
+ sh %{chmod -R a+r .}
46
+ require 'shellwords'
47
+ Dir.glob('test/**/*_test.rb') do |file|
48
+ next if file =~ %r{^test/haml/spec/}
49
+ sh %{chmod a+rx #{file}}
50
+ end
51
+ end
52
+
53
+ task :revision_file do
54
+ require scope('lib/sass')
55
+
56
+ release = Rake.application.top_level_tasks.include?('release') || File.exist?(scope('EDGE_GEM_VERSION'))
57
+ if Sass.version[:rev] && !release
58
+ File.open(scope('REVISION'), 'w') { |f| f.puts Sass.version[:rev] }
59
+ elsif release
60
+ File.open(scope('REVISION'), 'w') { |f| f.puts "(release)" }
61
+ else
62
+ File.open(scope('REVISION'), 'w') { |f| f.puts "(unknown)" }
63
+ end
64
+ end
65
+
66
+ task :date_file do
67
+ File.open(scope('VERSION_DATE'), 'w') do |f|
68
+ f.puts Time.now.utc.strftime('%d %B %Y %T %Z')
69
+ end
70
+ end
71
+
72
+ # We also need to get rid of this file after packaging.
73
+ at_exit do
74
+ File.delete(scope('REVISION')) rescue nil
75
+ File.delete(scope('VERSION_DATE')) rescue nil
76
+ end
77
+
78
+ desc "Install Sass as a gem. Use SUDO=1 to install with sudo."
79
+ task :install => [:package] do
80
+ gem = RUBY_PLATFORM =~ /java/ ? 'jgem' : 'gem'
81
+ sh %{#{'sudo ' if ENV["SUDO"]}#{gem} install --no-ri pkg/sass-#{get_version}}
82
+ end
83
+
84
+ desc "Release a new Sass package to Rubyforge."
85
+ task :release => [:check_release, :package] do
86
+ name = File.read(scope("VERSION_NAME")).strip
87
+ version = File.read(scope("VERSION")).strip
88
+ sh %{rubyforge add_release sass sass "#{name} (v#{version})" pkg/sass-#{version}.gem}
89
+ sh %{rubyforge add_file sass sass "#{name} (v#{version})" pkg/sass-#{version}.tar.gz}
90
+ sh %{gem push pkg/sass-#{version}.gem}
91
+ end
92
+
93
+ # Ensures that the VERSION file has been updated for a new release.
94
+ task :check_release do
95
+ version = File.read(scope("VERSION")).strip
96
+ raise "There have been changes since current version (#{version})" if changed_since?(version)
97
+ raise "VERSION_NAME must not be 'Bleeding Edge'" if File.read(scope("VERSION_NAME")) == "Bleeding Edge"
98
+ end
99
+
100
+ # Reads a password from the command line.
101
+ #
102
+ # @param name [String] The prompt to use to read the password
103
+ def read_password(prompt)
104
+ require 'readline'
105
+ system "stty -echo"
106
+ Readline.readline("#{prompt}: ").strip
107
+ ensure
108
+ system "stty echo"
109
+ puts
110
+ end
111
+
112
+ # Returns whether or not the repository, or specific files,
113
+ # has/have changed since a given revision.
114
+ #
115
+ # @param rev [String] The revision to check against
116
+ # @param files [Array<String>] The files to check.
117
+ # If this is empty, checks the entire repository
118
+ def changed_since?(rev, *files)
119
+ IO.popen("git diff --exit-code #{rev} #{files.join(' ')}") {}
120
+ return !$?.success?
121
+ end
122
+
123
+ task :submodules do
124
+ if File.exist?(File.dirname(__FILE__) + "/.git")
125
+ sh %{git submodule sync}
126
+ sh %{git submodule update --init}
127
+ elsif !File.exist?(File.dirname(__FILE__) + "/vendor/listen/lib")
128
+ warn <<WARN
129
+ WARNING: vendor/listen doesn't exist, and this isn't a git repository so
130
+ I can't get it automatically!
131
+ WARN
132
+ end
133
+ end
134
+
135
+ task :release_edge do
136
+ ensure_git_cleanup do
137
+ puts "#{'=' * 50} Running rake release_edge"
138
+
139
+ sh %{git checkout master}
140
+ sh %{git reset --hard origin/master}
141
+ sh %{rake package}
142
+ version = get_version
143
+ sh %{rubyforge add_release sass sass "Bleeding Edge (v#{version})" pkg/sass-#{version}.gem}
144
+ sh %{gem push pkg/sass-#{version}.gem}
145
+ end
146
+ end
147
+
148
+ # Get the version string. If this is being installed from Git,
149
+ # this includes the proper prerelease version.
150
+ def get_version
151
+ written_version = File.read(scope('VERSION').strip)
152
+ return written_version unless File.exist?(scope('.git'))
153
+
154
+ # Get the current master branch version
155
+ version = written_version.split('.')
156
+ version.map! {|n| n =~ /^[0-9]+$/ ? n.to_i : n}
157
+ return written_version unless version.size == 5 && version[3] == "alpha" # prerelease
158
+
159
+ return written_version if (commit_count = `git log --pretty=oneline HEAD ^stable | wc -l`).empty?
160
+ version[4] = commit_count.strip
161
+ version.join('.')
162
+ end
163
+
164
+ task :watch_for_update do
165
+ sh %{ruby extra/update_watch.rb}
166
+ end
167
+
168
+ # ----- Documentation -----
169
+
170
+ task :rdoc do
171
+ puts '=' * 100, <<END, '=' * 100
172
+ Sass uses the YARD documentation system (http://github.com/lsegal/yard).
173
+ Install the yard gem and then run "rake doc".
174
+ END
175
+ end
176
+
177
+ begin
178
+ require 'yard'
179
+
180
+ namespace :doc do
181
+ task :sass do
182
+ require scope('lib/sass')
183
+ Dir[scope("yard/default/**/*.sass")].each do |sass|
184
+ File.open(sass.gsub(/sass$/, 'css'), 'w') do |f|
185
+ f.write(Sass::Engine.new(File.read(sass)).render)
186
+ end
187
+ end
188
+ end
189
+
190
+ desc "List all undocumented methods and classes."
191
+ task :undocumented do
192
+ opts = ENV["YARD_OPTS"] || ""
193
+ ENV["YARD_OPTS"] = opts.dup + <<OPTS
194
+ --list --query "
195
+ object.docstring.blank? &&
196
+ !(object.type == :method && object.is_alias?)"
197
+ OPTS
198
+ Rake::Task['yard'].execute
199
+ end
200
+ end
201
+
202
+ YARD::Rake::YardocTask.new do |t|
203
+ t.files = FileList.new(scope('lib/**/*.rb')) do |list|
204
+ list.exclude('lib/sass/plugin/merb.rb')
205
+ list.exclude('lib/sass/plugin/rails.rb')
206
+ end.to_a
207
+ t.options << '--incremental' if Rake.application.top_level_tasks.include?('redoc')
208
+ t.options += FileList.new(scope('yard/*.rb')).to_a.map {|f| ['-e', f]}.flatten
209
+ files = FileList.new(scope('doc-src/*')).to_a.sort_by {|s| s.size} + %w[MIT-LICENSE VERSION]
210
+ t.options << '--files' << files.join(',')
211
+ t.options << '--template-path' << scope('yard')
212
+ t.options << '--title' << ENV["YARD_TITLE"] if ENV["YARD_TITLE"]
213
+
214
+ t.before = lambda do
215
+ if ENV["YARD_OPTS"]
216
+ require 'shellwords'
217
+ t.options.concat(Shellwords.shellwords(ENV["YARD_OPTS"]))
218
+ end
219
+ end
220
+ end
221
+ Rake::Task['yard'].prerequisites.insert(0, 'doc:sass')
222
+ Rake::Task['yard'].instance_variable_set('@comment', nil)
223
+
224
+ desc "Generate Documentation"
225
+ task :doc => :yard
226
+ task :redoc => :yard
227
+ rescue LoadError
228
+ desc "Generate Documentation"
229
+ task :doc => :rdoc
230
+ task :yard => :rdoc
231
+ end
232
+
233
+ task :pages do
234
+ ensure_git_cleanup do
235
+ puts "#{'=' * 50} Running rake pages"
236
+ sh %{git checkout sass-pages}
237
+ sh %{git reset --hard origin/sass-pages}
238
+
239
+ Dir.chdir("/var/www/sass-pages") do
240
+ sh %{git fetch origin}
241
+
242
+ sh %{git checkout stable}
243
+ sh %{git reset --hard origin/stable}
244
+
245
+ sh %{git checkout sass-pages}
246
+ sh %{git reset --hard origin/sass-pages}
247
+ sh %{rake build --trace}
248
+ sh %{mkdir -p tmp}
249
+ sh %{touch tmp/restart.txt}
250
+ end
251
+ end
252
+ end
253
+
254
+ # ----- Coverage -----
255
+
256
+ begin
257
+ require 'rcov/rcovtask'
258
+
259
+ Rcov::RcovTask.new do |t|
260
+ t.test_files = FileList[scope('test/**/*_test.rb')]
261
+ t.rcov_opts << '-x' << '"^\/"'
262
+ if ENV['NON_NATIVE']
263
+ t.rcov_opts << "--no-rcovrt"
264
+ end
265
+ t.verbose = true
266
+ end
267
+ rescue LoadError; end
268
+
269
+ # ----- Profiling -----
270
+
271
+ begin
272
+ require 'ruby-prof'
273
+
274
+ desc <<END
275
+ Run a profile of sass.
276
+ TIMES=n sets the number of runs. Defaults to 1000.
277
+ FILE=str sets the file to profile. Defaults to 'complex'.
278
+ OUTPUT=str sets the ruby-prof output format.
279
+ Can be Flat, CallInfo, or Graph. Defaults to Flat. Defaults to Flat.
280
+ END
281
+ task :profile do
282
+ times = (ENV['TIMES'] || '1000').to_i
283
+ file = ENV['FILE']
284
+
285
+ require 'lib/sass'
286
+
287
+ file = File.read(scope("test/sass/templates/#{file || 'complex'}.sass"))
288
+ result = RubyProf.profile { times.times { Sass::Engine.new(file).render } }
289
+
290
+ RubyProf.const_get("#{(ENV['OUTPUT'] || 'Flat').capitalize}Printer").new(result).print
291
+ end
292
+ rescue LoadError; end
293
+
294
+ # ----- Handling Updates -----
295
+
296
+ def email_on_error
297
+ yield
298
+ rescue Exception => e
299
+ IO.popen("sendmail nex342@gmail.com", "w") do |sm|
300
+ sm << "From: nex3@nex-3.com\n" <<
301
+ "To: nex342@gmail.com\n" <<
302
+ "Subject: Exception when running rake #{Rake.application.top_level_tasks.join(', ')}\n" <<
303
+ e.message << "\n\n" <<
304
+ e.backtrace.join("\n")
305
+ end
306
+ ensure
307
+ raise e if e
308
+ end
309
+
310
+ def ensure_git_cleanup
311
+ email_on_error {yield}
312
+ ensure
313
+ sh %{git reset --hard HEAD}
314
+ sh %{git clean -xdf}
315
+ sh %{git checkout master}
316
+ end
317
+
318
+ task :handle_update do
319
+ email_on_error do
320
+ unless ENV["REF"] =~ %r{^refs/heads/(master|stable|sass-pages)$}
321
+ puts "#{'=' * 20} Ignoring rake handle_update REF=#{ENV["REF"].inspect}"
322
+ next
323
+ end
324
+ branch = $1
325
+
326
+ puts
327
+ puts
328
+ puts '=' * 150
329
+ puts "Running rake handle_update REF=#{ENV["REF"].inspect}"
330
+
331
+ sh %{git fetch origin}
332
+ sh %{git checkout stable}
333
+ sh %{git reset --hard origin/stable}
334
+ sh %{git checkout master}
335
+ sh %{git reset --hard origin/master}
336
+
337
+ case branch
338
+ when "master"
339
+ sh %{rake release_edge --trace}
340
+ when "stable", "sass-pages"
341
+ sh %{rake pages --trace}
342
+ end
343
+
344
+ puts 'Done running handle_update'
345
+ puts '=' * 150
346
+ end
347
+ end