sass 3.1.21 → 3.2.0.alpha.3

Sign up to get free protection for your applications and to get access to all the features.
Files changed (180) hide show
  1. data/README.md +5 -4
  2. data/REVISION +1 -1
  3. data/Rakefile +6 -15
  4. data/VERSION +1 -1
  5. data/VERSION_NAME +1 -1
  6. data/lib/sass.rb +0 -1
  7. data/lib/sass/cache_stores/base.rb +1 -3
  8. data/lib/sass/cache_stores/filesystem.rb +0 -3
  9. data/lib/sass/css.rb +49 -145
  10. data/lib/sass/engine.rb +23 -47
  11. data/lib/sass/environment.rb +5 -30
  12. data/lib/sass/exec.rb +7 -30
  13. data/lib/sass/importers/base.rb +1 -2
  14. data/lib/sass/importers/filesystem.rb +13 -18
  15. data/lib/sass/less.rb +1 -1
  16. data/lib/sass/plugin.rb +8 -4
  17. data/lib/sass/plugin/compiler.rb +67 -93
  18. data/lib/sass/plugin/configuration.rb +2 -0
  19. data/lib/sass/plugin/staleness_checker.rb +4 -14
  20. data/lib/sass/repl.rb +3 -2
  21. data/lib/sass/script.rb +1 -0
  22. data/lib/sass/script/color.rb +9 -4
  23. data/lib/sass/script/funcall.rb +3 -16
  24. data/lib/sass/script/functions.rb +55 -98
  25. data/lib/sass/script/interpolation.rb +0 -9
  26. data/lib/sass/script/lexer.rb +4 -2
  27. data/lib/sass/script/list.rb +0 -8
  28. data/lib/sass/script/literal.rb +20 -5
  29. data/lib/sass/script/node.rb +0 -8
  30. data/lib/sass/script/number.rb +11 -35
  31. data/lib/sass/script/operation.rb +0 -16
  32. data/lib/sass/script/parser.rb +5 -12
  33. data/lib/sass/script/string_interpolation.rb +0 -9
  34. data/lib/sass/script/unary_operation.rb +0 -7
  35. data/lib/sass/script/variable.rb +1 -5
  36. data/lib/sass/scss/parser.rb +54 -191
  37. data/lib/sass/scss/rx.rb +3 -15
  38. data/lib/sass/scss/static_parser.rb +3 -3
  39. data/lib/sass/selector.rb +3 -15
  40. data/lib/sass/selector/abstract_sequence.rb +2 -11
  41. data/lib/sass/selector/comma_sequence.rb +3 -8
  42. data/lib/sass/selector/sequence.rb +11 -74
  43. data/lib/sass/selector/simple.rb +1 -7
  44. data/lib/sass/selector/simple_sequence.rb +8 -28
  45. data/lib/sass/shared.rb +5 -3
  46. data/lib/sass/tree/comment_node.rb +12 -25
  47. data/lib/sass/tree/debug_node.rb +1 -1
  48. data/lib/sass/tree/directive_node.rb +0 -5
  49. data/lib/sass/tree/each_node.rb +1 -1
  50. data/lib/sass/tree/extend_node.rb +1 -1
  51. data/lib/sass/tree/for_node.rb +2 -2
  52. data/lib/sass/tree/function_node.rb +1 -1
  53. data/lib/sass/tree/if_node.rb +14 -1
  54. data/lib/sass/tree/media_node.rb +4 -4
  55. data/lib/sass/tree/mixin_def_node.rb +1 -1
  56. data/lib/sass/tree/mixin_node.rb +2 -2
  57. data/lib/sass/tree/node.rb +26 -10
  58. data/lib/sass/tree/return_node.rb +1 -1
  59. data/lib/sass/tree/root_node.rb +1 -1
  60. data/lib/sass/tree/rule_node.rb +11 -9
  61. data/lib/sass/tree/variable_node.rb +1 -1
  62. data/lib/sass/tree/visitors/base.rb +1 -1
  63. data/lib/sass/tree/visitors/check_nesting.rb +36 -29
  64. data/lib/sass/tree/visitors/convert.rb +9 -16
  65. data/lib/sass/tree/visitors/cssize.rb +9 -40
  66. data/lib/sass/tree/visitors/perform.rb +23 -79
  67. data/lib/sass/tree/visitors/to_css.rb +21 -23
  68. data/lib/sass/tree/warn_node.rb +1 -1
  69. data/lib/sass/tree/while_node.rb +1 -1
  70. data/lib/sass/util.rb +9 -147
  71. data/lib/sass/version.rb +0 -14
  72. data/test/sass/cache_test.rb +0 -15
  73. data/test/sass/conversion_test.rb +8 -50
  74. data/test/sass/css2sass_test.rb +0 -33
  75. data/test/sass/engine_test.rb +32 -283
  76. data/test/sass/extend_test.rb +0 -315
  77. data/test/sass/functions_test.rb +23 -60
  78. data/test/sass/importer_test.rb +0 -110
  79. data/test/sass/more_results/more_import.css +2 -2
  80. data/test/sass/plugin_test.rb +13 -40
  81. data/test/sass/results/import.css +2 -2
  82. data/test/sass/results/import_charset.css +0 -1
  83. data/test/sass/results/import_charset_1_8.css +0 -1
  84. data/test/sass/results/import_charset_ibm866.css +0 -1
  85. data/test/sass/results/scss_import.css +2 -2
  86. data/test/sass/results/units.css +1 -1
  87. data/test/sass/script_conversion_test.rb +0 -2
  88. data/test/sass/script_test.rb +4 -28
  89. data/test/sass/scss/css_test.rb +1 -79
  90. data/test/sass/scss/scss_test.rb +16 -96
  91. data/test/sass/templates/import_charset.sass +0 -2
  92. data/test/sass/templates/import_charset_1_8.sass +0 -2
  93. data/test/sass/templates/import_charset_ibm866.sass +0 -2
  94. data/test/sass/test_helper.rb +1 -1
  95. data/test/sass/util_test.rb +0 -28
  96. data/test/test_helper.rb +0 -2
  97. data/vendor/{listen → fssm}/LICENSE +1 -1
  98. data/vendor/fssm/README.markdown +55 -0
  99. data/vendor/fssm/Rakefile +59 -0
  100. data/vendor/fssm/VERSION.yml +5 -0
  101. data/vendor/fssm/example.rb +9 -0
  102. data/vendor/fssm/fssm.gemspec +77 -0
  103. data/vendor/fssm/lib/fssm.rb +33 -0
  104. data/vendor/fssm/lib/fssm/backends/fsevents.rb +36 -0
  105. data/vendor/fssm/lib/fssm/backends/inotify.rb +26 -0
  106. data/vendor/fssm/lib/fssm/backends/polling.rb +25 -0
  107. data/vendor/fssm/lib/fssm/backends/rubycocoa/fsevents.rb +131 -0
  108. data/vendor/fssm/lib/fssm/monitor.rb +26 -0
  109. data/vendor/fssm/lib/fssm/path.rb +91 -0
  110. data/vendor/fssm/lib/fssm/pathname.rb +502 -0
  111. data/vendor/fssm/lib/fssm/state/directory.rb +57 -0
  112. data/vendor/fssm/lib/fssm/state/file.rb +24 -0
  113. data/vendor/fssm/lib/fssm/support.rb +63 -0
  114. data/vendor/fssm/lib/fssm/tree.rb +176 -0
  115. data/vendor/fssm/profile/prof-cache.rb +40 -0
  116. data/vendor/fssm/profile/prof-fssm-pathname.html +1231 -0
  117. data/vendor/fssm/profile/prof-pathname.rb +68 -0
  118. data/vendor/fssm/profile/prof-plain-pathname.html +988 -0
  119. data/vendor/fssm/profile/prof.html +2379 -0
  120. data/vendor/fssm/spec/path_spec.rb +75 -0
  121. data/vendor/fssm/spec/root/duck/quack.txt +0 -0
  122. data/vendor/fssm/spec/root/file.css +0 -0
  123. data/vendor/fssm/spec/root/file.rb +0 -0
  124. data/vendor/fssm/spec/root/file.yml +0 -0
  125. data/vendor/fssm/spec/root/moo/cow.txt +0 -0
  126. data/vendor/fssm/spec/spec_helper.rb +14 -0
  127. metadata +246 -281
  128. data/VERSION_DATE +0 -1
  129. data/lib/sass/logger.rb +0 -15
  130. data/lib/sass/logger/base.rb +0 -32
  131. data/lib/sass/logger/log_level.rb +0 -49
  132. data/lib/sass/tree/visitors/deep_copy.rb +0 -87
  133. data/lib/sass/tree/visitors/extend.rb +0 -42
  134. data/lib/sass/tree/visitors/set_options.rb +0 -97
  135. data/lib/sass/util/multibyte_string_scanner.rb +0 -134
  136. data/test/Gemfile +0 -4
  137. data/test/Gemfile.lock +0 -19
  138. data/test/sass/fixtures/test_staleness_check_across_importers.css +0 -1
  139. data/test/sass/fixtures/test_staleness_check_across_importers.scss +0 -1
  140. data/test/sass/logger_test.rb +0 -58
  141. data/test/sass/templates/_double_import_loop2.sass +0 -1
  142. data/test/sass/templates/bork5.sass +0 -3
  143. data/test/sass/templates/double_import_loop1.sass +0 -1
  144. data/test/sass/templates/nested_bork5.sass +0 -2
  145. data/test/sass/templates/single_import_loop.sass +0 -1
  146. data/test/sass/util/multibyte_string_scanner_test.rb +0 -147
  147. data/vendor/listen/CHANGELOG.md +0 -147
  148. data/vendor/listen/Gemfile +0 -23
  149. data/vendor/listen/Guardfile +0 -8
  150. data/vendor/listen/README.md +0 -312
  151. data/vendor/listen/Rakefile +0 -47
  152. data/vendor/listen/Vagrantfile +0 -96
  153. data/vendor/listen/lib/listen.rb +0 -38
  154. data/vendor/listen/lib/listen/adapter.rb +0 -167
  155. data/vendor/listen/lib/listen/adapters/darwin.rb +0 -84
  156. data/vendor/listen/lib/listen/adapters/linux.rb +0 -110
  157. data/vendor/listen/lib/listen/adapters/polling.rb +0 -66
  158. data/vendor/listen/lib/listen/adapters/windows.rb +0 -81
  159. data/vendor/listen/lib/listen/directory_record.rb +0 -318
  160. data/vendor/listen/lib/listen/listener.rb +0 -203
  161. data/vendor/listen/lib/listen/multi_listener.rb +0 -121
  162. data/vendor/listen/lib/listen/turnstile.rb +0 -28
  163. data/vendor/listen/lib/listen/version.rb +0 -3
  164. data/vendor/listen/listen.gemspec +0 -26
  165. data/vendor/listen/spec/listen/adapter_spec.rb +0 -142
  166. data/vendor/listen/spec/listen/adapters/darwin_spec.rb +0 -31
  167. data/vendor/listen/spec/listen/adapters/linux_spec.rb +0 -41
  168. data/vendor/listen/spec/listen/adapters/polling_spec.rb +0 -68
  169. data/vendor/listen/spec/listen/adapters/windows_spec.rb +0 -24
  170. data/vendor/listen/spec/listen/directory_record_spec.rb +0 -1138
  171. data/vendor/listen/spec/listen/listener_spec.rb +0 -155
  172. data/vendor/listen/spec/listen/multi_listener_spec.rb +0 -156
  173. data/vendor/listen/spec/listen/turnstile_spec.rb +0 -56
  174. data/vendor/listen/spec/listen_spec.rb +0 -73
  175. data/vendor/listen/spec/spec_helper.rb +0 -18
  176. data/vendor/listen/spec/support/adapter_helper.rb +0 -716
  177. data/vendor/listen/spec/support/directory_record_helper.rb +0 -55
  178. data/vendor/listen/spec/support/fixtures_helper.rb +0 -29
  179. data/vendor/listen/spec/support/listeners_helper.rb +0 -144
  180. data/vendor/listen/spec/support/platform_helper.rb +0 -11
@@ -1,4 +0,0 @@
1
- source :gemcutter
2
-
3
- gem 'rake'
4
- gem 'less', '< 2.0.0'
@@ -1,19 +0,0 @@
1
- GEM
2
- remote: http://rubygems.org/
3
- specs:
4
- less (1.2.21)
5
- mutter (>= 0.4.2)
6
- treetop (>= 1.4.2)
7
- mutter (0.5.3)
8
- polyglot (0.3.2)
9
- rake (0.9.2)
10
- treetop (1.4.10)
11
- polyglot
12
- polyglot (>= 0.3.1)
13
-
14
- PLATFORMS
15
- ruby
16
-
17
- DEPENDENCIES
18
- less (< 2.0.0)
19
- rake
@@ -1 +0,0 @@
1
- .pear { color: green; }
@@ -1,58 +0,0 @@
1
- #!/usr/bin/env ruby
2
- require File.dirname(__FILE__) + '/../test_helper'
3
- require 'pathname'
4
-
5
- class LoggerTest < Test::Unit::TestCase
6
-
7
- class InterceptedLogger < Sass::Logger::Base
8
-
9
- attr_accessor :messages
10
-
11
- def initialize(*args)
12
- super
13
- self.messages = []
14
- end
15
-
16
- def reset!
17
- self.messages = []
18
- end
19
-
20
- def _log(*args)
21
- messages << [args]
22
- end
23
-
24
- end
25
-
26
- def test_global_sass_logger_instance_exists
27
- assert Sass.logger.respond_to?(:warn)
28
- end
29
-
30
- def test_log_level_orders
31
- logged_levels = {
32
- :trace => [ [], [:trace, :debug, :info, :warn, :error]],
33
- :debug => [ [:trace], [:debug, :info, :warn, :error]],
34
- :info => [ [:trace, :debug], [:info, :warn, :error]],
35
- :warn => [ [:trace, :debug, :info], [:warn, :error]],
36
- :error => [ [:trace, :debug, :info, :warn], [:error]]
37
- }
38
- logged_levels.each do |level, (should_not_be_logged, should_be_logged)|
39
- logger = Sass::Logger::Base.new(level)
40
- should_not_be_logged.each do |should_level|
41
- assert !logger.logging_level?(should_level)
42
- end
43
- should_be_logged.each do |should_level|
44
- assert logger.logging_level?(should_level)
45
- end
46
- end
47
- end
48
-
49
- def test_logging_can_be_disabled
50
- logger = InterceptedLogger.new
51
- logger.error("message #1")
52
- assert_equal 1, logger.messages.size
53
- logger.reset!
54
- logger.disabled = true
55
- logger.error("message #2")
56
- assert_equal 0, logger.messages.size
57
- end
58
- end
@@ -1 +0,0 @@
1
- @import "double_import_loop1"
@@ -1,3 +0,0 @@
1
- foo
2
- @function bar($a)
3
- @return $a
@@ -1 +0,0 @@
1
- @import "double_import_loop2"
@@ -1,2 +0,0 @@
1
-
2
- @import bork5
@@ -1 +0,0 @@
1
- @import "single_import_loop"
@@ -1,147 +0,0 @@
1
- #!/usr/bin/env ruby
2
- # -*- coding: utf-8 -*-
3
- require File.dirname(__FILE__) + '/../../test_helper'
4
-
5
- unless Sass::Util.ruby1_8?
6
- class MultibyteStringScannerTest < Test::Unit::TestCase
7
- def setup
8
- @scanner = Sass::Util::MultibyteStringScanner.new("cölorfül")
9
- end
10
-
11
- def test_initial
12
- assert_scanner_state 0, 0, nil, nil
13
- end
14
-
15
- def test_check
16
- assert_equal 'cö', @scanner.check(/../)
17
- assert_scanner_state 0, 0, 2, 3
18
- assert_equal 0, @scanner.pos
19
- assert_equal 0, @scanner.pos
20
- assert_equal 2, @scanner.matched_size
21
- assert_equal 3, @scanner.byte_matched_size
22
- end
23
-
24
- def test_check_until
25
- assert_equal 'cölorfü', @scanner.check_until(/f./)
26
- assert_scanner_state 0, 0, 2, 3
27
- end
28
-
29
- def test_getch
30
- assert_equal 'c', @scanner.getch
31
- assert_equal 'ö', @scanner.getch
32
- assert_scanner_state 2, 3, 1, 2
33
- end
34
-
35
- def test_match?
36
- assert_equal 2, @scanner.match?(/../)
37
- assert_scanner_state 0, 0, 2, 3
38
- end
39
-
40
- def test_peek
41
- assert_equal 'cö', @scanner.peek(2)
42
- assert_scanner_state 0, 0, nil, nil
43
- end
44
-
45
- def test_rest_size
46
- assert_equal 'cö', @scanner.scan(/../)
47
- assert_equal 6, @scanner.rest_size
48
- end
49
-
50
- def test_scan
51
- assert_equal 'cö', @scanner.scan(/../)
52
- assert_scanner_state 2, 3, 2, 3
53
- end
54
-
55
- def test_scan_until
56
- assert_equal 'cölorfü', @scanner.scan_until(/f./)
57
- assert_scanner_state 7, 9, 2, 3
58
- end
59
-
60
- def test_skip
61
- assert_equal 2, @scanner.skip(/../)
62
- assert_scanner_state 2, 3, 2, 3
63
- end
64
-
65
- def test_skip_until
66
- assert_equal 7, @scanner.skip_until(/f./)
67
- assert_scanner_state 7, 9, 2, 3
68
- end
69
-
70
- def test_set_pos
71
- @scanner.pos = 7
72
- assert_scanner_state 7, 9, nil, nil
73
- @scanner.pos = 6
74
- assert_scanner_state 6, 7, nil, nil
75
- @scanner.pos = 1
76
- assert_scanner_state 1, 1, nil, nil
77
- end
78
-
79
- def test_reset
80
- @scanner.scan(/../)
81
- @scanner.reset
82
- assert_scanner_state 0, 0, nil, nil
83
- end
84
-
85
- def test_scan_full
86
- assert_equal 'cö', @scanner.scan_full(/../, true, true)
87
- assert_scanner_state 2, 3, 2, 3
88
-
89
- @scanner.reset
90
- assert_equal 'cö', @scanner.scan_full(/../, false, true)
91
- assert_scanner_state 0, 0, 2, 3
92
-
93
- @scanner.reset
94
- assert_nil @scanner.scan_full(/../, true, false)
95
- assert_scanner_state 2, 3, 2, 3
96
-
97
- @scanner.reset
98
- assert_nil @scanner.scan_full(/../, false, false)
99
- assert_scanner_state 0, 0, 2, 3
100
- end
101
-
102
- def test_search_full
103
- assert_equal 'cölorfü', @scanner.search_full(/f./, true, true)
104
- assert_scanner_state 7, 9, 2, 3
105
-
106
- @scanner.reset
107
- assert_equal 'cölorfü', @scanner.search_full(/f./, false, true)
108
- assert_scanner_state 0, 0, 2, 3
109
-
110
- @scanner.reset
111
- assert_nil @scanner.search_full(/f./, true, false)
112
- assert_scanner_state 7, 9, 2, 3
113
-
114
- @scanner.reset
115
- assert_nil @scanner.search_full(/f./, false, false)
116
- assert_scanner_state 0, 0, 2, 3
117
- end
118
-
119
- def test_set_string
120
- @scanner.scan(/../)
121
- @scanner.string = 'föóbâr'
122
- assert_scanner_state 0, 0, nil, nil
123
- end
124
-
125
- def test_terminate
126
- @scanner.scan(/../)
127
- @scanner.terminate
128
- assert_scanner_state 8, 10, nil, nil
129
- end
130
-
131
- def test_unscan
132
- @scanner.scan(/../)
133
- @scanner.scan_until(/f./)
134
- @scanner.unscan
135
- assert_scanner_state 2, 3, nil, nil
136
- end
137
-
138
- private
139
-
140
- def assert_scanner_state(pos, byte_pos, matched_size, byte_matched_size)
141
- assert_equal pos, @scanner.pos, 'pos'
142
- assert_equal byte_pos, @scanner.byte_pos, 'byte_pos'
143
- assert_equal matched_size, @scanner.matched_size, 'matched_size'
144
- assert_equal byte_matched_size, @scanner.byte_matched_size, 'byte_matched_size'
145
- end
146
- end
147
- end
@@ -1,147 +0,0 @@
1
- ## 0.4.7 - June 27, 2012
2
-
3
- ### Bug fixes
4
-
5
- - Increase latency to 0.25, to avoid useless polling fallback. (fixed by [@thibaudgg][])
6
- - Change watched inotify events, to avoid duplication callback. (fixed by [@thibaudgg][])
7
- - [#41](https://github.com/guard/listen/issues/41) Use lstat instead of stat when calculating mtime. (fixed by [@ebroder][])
8
-
9
- ## 0.4.6 - June 20, 2012
10
-
11
- ### Bug fix
12
-
13
- - [#39](https://github.com/guard/listen/issues/39) Fix digest race condition. (fixed by [@dkubb][])
14
-
15
- ## 0.4.5 - June 13, 2012
16
-
17
- ### Bug fix
18
-
19
- - [#39](https://github.com/guard/listen/issues/39) Rescue Errno::ENOENT when path inserted doesn't exist. (reported by [@textgoeshere][], fixed by [@thibaudgg][] and [@rymai][])
20
-
21
- ## 0.4.4 - June 8, 2012
22
-
23
- ### Bug fixes
24
-
25
- - ~~[#39](https://github.com/guard/listen/issues/39) Non-existing path insertion bug. (reported by [@textgoeshere][], fixed by [@thibaudgg][])~~
26
- - Fix relative path for directories containing special characters. (reported by [@napcs][], fixed by [@netzpirat][])
27
-
28
- ## 0.4.3 - June 6, 2012
29
-
30
- ### Bug fixes
31
-
32
- - [#24](https://github.com/guard/listen/issues/24) Fail gracefully when the inotify limit is not enough for Listen to function. (reported by [@daemonza][], fixed by [@Maher4Ever][])
33
- - [#32](https://github.com/guard/listen/issues/32) Fix a crash when trying to calculate the checksum of unreadable files. (reported by [@nex3][], fixed by [@Maher4Ever][])
34
-
35
- ### Improvements
36
-
37
- - Add `#relative_paths` method to listeners. ([@Maher4Ever][])
38
- - Add `#started?` query-method to adapters. ([@Maher4Ever][])
39
- - Dynamically detect the mtime precision used on a system. ([@Maher4Ever][] with help from [@nex3][])
40
-
41
- ## 0.4.2 - May 1, 2012
42
-
43
- ### Bug fixes
44
-
45
- - [#21](https://github.com/guard/listen/issues/21) Issues when listening to changes in relative paths. (reported by [@akerbos][], fixed by [@Maher4Ever][])
46
- - [#27](https://github.com/guard/listen/issues/27) Wrong reports for files modifications. (reported by [@cobychapple][], fixed by [@Maher4Ever][])
47
- - Fix segmentation fault when profiling on Windows. ([@Maher4Ever][])
48
- - Fix redundant watchers on Windows. ([@Maher4Ever][])
49
-
50
- ### Improvements
51
-
52
- - [#17](https://github.com/guard/listen/issues/17) Use regexp-patterns with the `ignore` method instead of supplying paths. (reported by [@fny][], added by [@Maher4Ever][])
53
- - Speed improvement when listening to changes in directories with ignored paths. ([@Maher4Ever][])
54
- - Added `.rbx` and `.svn` to ignored directories. ([@Maher4Ever][])
55
-
56
- ## 0.4.1 - April 15, 2012
57
-
58
- ### Bug fix
59
-
60
- - [#18](https://github.com/guard/listen/issues/18) Listener crashes when removing directories with nested paths. (reported by [@daemonza][], fixed by [@Maher4Ever][])
61
-
62
- ## 0.4.0 - April 9, 2012
63
-
64
- ### New features
65
-
66
- - Add `wait_for_callback` method to all adapters. ([@Maher4Ever][])
67
- - Add `Listen::MultiListener` class to listen to multiple directories at once. ([@Maher4Ever][])
68
- - Allow passing multiple directories to the `Listen.to` method. ([@Maher4Ever][])
69
- - Add `blocking` option to `Listen#start` which can be used to disable blocking the current thread upon starting. ([@Maher4Ever][])
70
- - Use absolute-paths in callbacks by default instead of relative-paths. ([@Maher4Ever][])
71
- - Add `relative_paths` option to `Listen::Listener` to retain the old functionality. ([@Maher4Ever][])
72
-
73
- ### Improvements
74
-
75
- - Encapsulate thread spawning in the linux-adapter. ([@Maher4Ever][])
76
- - Encapsulate thread spawning in the darwin-adapter. ([@Maher4Ever][] with [@scottdavis][] help)
77
- - Encapsulate thread spawning in the windows-adapter. ([@Maher4Ever][])
78
- - Fix linux-adapter bug where Listen would report file-modification events on the parent-directory. ([@Maher4Ever][])
79
-
80
- ### Change
81
-
82
- - Remove `wait_until_listening` as adapters doesn't need to run inside threads anymore ([@Maher4Ever][])
83
-
84
- ## 0.3.3 - March 6, 2012
85
-
86
- ### Improvement
87
-
88
- - Improve pause/unpause. ([@thibaudgg][])
89
-
90
- ## 0.3.2 - March 4, 2012
91
-
92
- ### New feature
93
-
94
- - Add pause/unpause listener's methods. ([@thibaudgg][])
95
-
96
- ## 0.3.1 - February 22, 2012
97
-
98
- ### Bug fix
99
-
100
- - [#9](https://github.com/guard/listen/issues/9) Ignore doesn't seem to work. (reported by [@markiz][], fixed by [@thibaudgg][])
101
-
102
- ## 0.3.0 - February 21, 2012
103
-
104
- ### New features
105
-
106
- - Add automatic fallback to polling if system adapter doesn't work (like a DropBox folder). ([@thibaudgg][])
107
- - Add latency and force_polling options. ([@Maher4Ever][])
108
-
109
- ## 0.2.0 - February 13, 2012
110
-
111
- ### New features
112
-
113
- - Add checksum comparaison support for detecting consecutive file modifications made during the same second. ([@thibaudgg][])
114
- - Add rb-fchange support. ([@thibaudgg][])
115
- - Add rb-inotify support. ([@thibaudgg][] with [@Maher4Ever][] help)
116
- - Add rb-fsevent support. ([@thibaudgg][])
117
- - Add non-recursive diff with multiple directories support. ([@thibaudgg][])
118
- - Ignore .DS_Store by default. ([@thibaudgg][])
119
-
120
- ## 0.1.0 - January 28, 2012
121
-
122
- - First version with only a polling adapter and basic features set (ignore & filter). ([@thibaudgg][])
123
-
124
- <!--- The following link definition list is generated by PimpMyChangelog --->
125
- [#9]: https://github.com/guard/listen/issues/9
126
- [#17]: https://github.com/guard/listen/issues/17
127
- [#18]: https://github.com/guard/listen/issues/18
128
- [#21]: https://github.com/guard/listen/issues/21
129
- [#24]: https://github.com/guard/listen/issues/24
130
- [#27]: https://github.com/guard/listen/issues/27
131
- [#32]: https://github.com/guard/listen/issues/32
132
- [#39]: https://github.com/guard/listen/issues/39
133
- [@Maher4Ever]: https://github.com/Maher4Ever
134
- [@dkubb]: https://github.com/dkubb
135
- [@ebroder]: https://github.com/ebroder
136
- [@akerbos]: https://github.com/akerbos
137
- [@cobychapple]: https://github.com/cobychapple
138
- [@daemonza]: https://github.com/daemonza
139
- [@fny]: https://github.com/fny
140
- [@markiz]: https://github.com/markiz
141
- [@napcs]: https://github.com/napcs
142
- [@netzpirat]: https://github.com/netzpirat
143
- [@nex3]: https://github.com/nex3
144
- [@rymai]: https://github.com/rymai
145
- [@scottdavis]: https://github.com/scottdavis
146
- [@textgoeshere]: https://github.com/textgoeshere
147
- [@thibaudgg]: https://github.com/thibaudgg
@@ -1,23 +0,0 @@
1
- source :rubygems
2
-
3
- gemspec
4
-
5
- gem 'rake'
6
-
7
- group :development do
8
- platform :ruby do
9
- gem 'coolline'
10
- end
11
-
12
- gem 'guard'
13
- gem 'guard-rspec'
14
- gem 'yard'
15
- gem 'redcarpet'
16
- gem 'pry'
17
-
18
- gem 'vagrant'
19
- end
20
-
21
- group :test do
22
- gem 'rspec'
23
- end
@@ -1,8 +0,0 @@
1
- guard :rspec, :all_on_start => false, :all_after_pass => false, :cli => '--fail-fast --format doc' do
2
- watch(%r{^spec/.+_spec\.rb$})
3
- watch(%r{^lib/(.+)\.rb$}) { |m| "spec/#{m[1]}_spec.rb" }
4
- watch('spec/support/adapter_helper.rb') { "spec/listen/adapters" }
5
- watch('spec/support/listener_helper.rb') { "spec/listen/listener_spec.rb" }
6
- watch('spec/support/fixtures_helper.rb') { "spec" }
7
- watch('spec/spec_helper.rb') { "spec" }
8
- end
@@ -1,312 +0,0 @@
1
- # Listen [![Build Status](https://secure.travis-ci.org/guard/listen.png?branch=master)](http://travis-ci.org/guard/listen)
2
-
3
- The Listen gem listens to file modifications and notifies you about the changes.
4
-
5
- ## Features
6
-
7
- * Works everywhere!
8
- * Supports watching multiple directories from a single listener.
9
- * OS-specific adapters for Mac OS X 10.6+, Linux and Windows.
10
- * Automatic fallback to polling if OS-specific adapter doesn't work.
11
- * Detects files modification, addidation and removal.
12
- * Checksum comparaison for modifications made under the same second.
13
- * Allows supplying regexp-patterns to ignore and filter paths for better results.
14
- * Tested on all Ruby environments via [travis-ci](http://travis-ci.org/guard/listen).
15
-
16
- ## Install
17
-
18
- ``` bash
19
- gem install listen
20
- ```
21
-
22
- ## Usage
23
-
24
- There are **two ways** to use Listen:
25
-
26
- 1. Call `Listen.to` with either a single directory or multiple directories, then define the `change` callback in a block.
27
- 2. Create a `listener` object and use it in an (ARel style) chainable way.
28
-
29
- Feel free to give your feeback via [Listen issues](https://github.com/guard/listen/issues)
30
-
31
- ### Block API
32
-
33
- ``` ruby
34
- # Listen to a single directory.
35
- Listen.to('dir/path/to/listen', :filter => /\.rb$/, :ignore => %r{ignored/path/}) do |modified, added, removed|
36
- # ...
37
- end
38
-
39
- # Listen to multiple directories.
40
- Listen.to('dir/to/awesome_app', 'dir/to/other_app', :filter => /\.rb$/, :latency => 0.1) do |modified, added, removed|
41
- # ...
42
- end
43
- ```
44
-
45
- ### "Object" API
46
-
47
- ``` ruby
48
- listener = Listen.to('dir/path/to/listen')
49
- listener = listener.ignore(%r{^ignored/path/})
50
- listener = listener.filter(/\.rb$/)
51
- listener = listener.latency(0.5)
52
- listener = listener.force_polling(true)
53
- listener = listener.polling_fallback_message(false)
54
- listener = listener.change(&callback)
55
- listener.start # blocks execution!
56
- ```
57
-
58
- ### Chainable
59
-
60
- ``` ruby
61
- Listen.to('dir/path/to/listen')
62
- .ignore(%r{^ignored/path/})
63
- .filter(/\.rb$/)
64
- .latency(0.5)
65
- .force_polling(true)
66
- .polling_fallback_message('custom message')
67
- .change(&callback)
68
- .start # blocks execution!
69
- ```
70
-
71
- ### Pause/Unpause
72
-
73
- Listener can also easily be paused/unpaused:
74
-
75
- ``` ruby
76
- listener = Listen.to('dir/path/to/listen')
77
- listener.start(false) # non-blocking mode
78
- listener.pause # stop listening to changes
79
- listener.paused? # => true
80
- listener.unpause
81
- listener.stop
82
- ```
83
-
84
- ## Listening to changes on multiple directories
85
-
86
- The Listen gem provides the `MultiListener` class to watch multiple directories and
87
- handle their changes from a single listener:
88
-
89
- ```ruby
90
- listener = Listen::MultiListener.new('app/css', 'app/js')
91
- listener.latency(0.5)
92
-
93
- # Configure the listener to your needs...
94
-
95
- listener.start # blocks execution!
96
- ````
97
-
98
- For an easier access, the `Listen.to` method can also be used to create a multi-listener:
99
-
100
- ``` ruby
101
- listener = Listen.to('app/css', 'app/js')
102
- .ignore(%r{^vendor/}) # both js/vendor and css/vendor will be ignored
103
- .change(&assets_callback)
104
-
105
- listener.start # blocks execution!
106
- ```
107
-
108
- ## Changes callback
109
-
110
- Changes to the listened-to directories gets reported back to the user in a callback.
111
- The registered callback gets invoked, when there are changes, with **three** parameters:
112
- `modified_paths`, `added_paths` and `removed_paths` in that particular order.
113
-
114
- You can register a callback in two ways. The first way is by passing a block when calling
115
- the `Listen.to` method or when initializing a listener object:
116
-
117
- ```ruby
118
- Listen.to('path/to/app') do |modified, added, removed|
119
- # This block will be called when there are changes.
120
- end
121
-
122
- # or ...
123
-
124
- listener = Listen::Listener.new('path/to/app') do |modified, added, removed|
125
- # This block will be called when there are changes.
126
- end
127
-
128
- ```
129
-
130
- The second way to register a callback is be calling the `change` method on any
131
- listener passing it a block:
132
-
133
- ```ruby
134
- # Create a callback
135
- callback = Proc.new do |modified, added, removed|
136
- # This proc will be called when there are changes.
137
- end
138
-
139
- listener = Listen.to('dir')
140
- listener.change(&callback) # convert the callback to a block and register it
141
-
142
- listener.start # blocks execution
143
- ```
144
-
145
- ### Paths in callbacks
146
-
147
- Listeners invoke callbacks passing them absolute paths by default:
148
-
149
- ```ruby
150
- # Assume someone changes the 'style.css' file in '/home/user/app/css' after creating
151
- # the listener.
152
- Listen.to('/home/user/app/css') do |modified, added, removed|
153
- modified.inspect # => ['/home/user/app/css/style.css']
154
- end
155
- ```
156
-
157
- #### Relative paths in callbacks
158
-
159
- When creating a listener for a **single** path (more specifically a `Listen::Listener` instance),
160
- you can pass `:relative_paths => true` as an option to get relative paths in
161
- your callback:
162
-
163
- ```ruby
164
- # Assume someone changes the 'style.css' file in '/home/user/app/css' after creating
165
- # the listener.
166
- Listen.to('/home/user/app/css', :relative_paths => true) do |modified, added, removed|
167
- modified.inspect # => ['style.css']
168
- end
169
- ```
170
-
171
- Passing the `:relative_paths => true` option won't work when listeneing to multiple
172
- directories:
173
-
174
- ```ruby
175
- # Assume someone changes the 'style.css' file in '/home/user/app/css' after creating
176
- # the listener.
177
- Listen.to('/home/user/app/css', '/home/user/app/js', :relative_paths => true) do |modified, added, removed|
178
- modified.inspect # => ['/home/user/app/css/style.css']
179
- end
180
- ```
181
-
182
- ## Options
183
-
184
- These options can be set through `Listen.to` params or via methods (see the "Object" API)
185
-
186
- ```ruby
187
- :filter => /\.rb$/, /\.coffee$/ # Filter files to listen to via a regexps list.
188
- # default: none
189
-
190
- :ignore => %r{app/CMake/}, /\.pid$/ # Ignore a list of paths (root directory or sub-dir)
191
- # default: See DEFAULT_IGNORED_DIRECTORIES and DEFAULT_IGNORED_EXTENSIONS in Listen::DirectoryRecord
192
-
193
- :latency => 0.5 # Set the delay (**in seconds**) between checking for changes
194
- # default: 0.25 sec (1.0 sec for polling)
195
-
196
- :relative_paths => true # Enable the use of relative paths in the callback.
197
- # default: false
198
-
199
- :force_polling => true # Force the use of the polling adapter
200
- # default: none
201
-
202
- :polling_fallback_message => 'custom message' # Set a custom polling fallback message (or disable it with `false`)
203
- # default: "WARNING: Listen fallen back to polling, learn more at https://github.com/guard/listen#fallback."
204
- ```
205
-
206
- ### The patterns for filtering and ignoring paths
207
-
208
- Just like the unix convention of beginning absolute paths with the
209
- directory-separator (forward slash `/` in unix) and with no prefix for relative paths,
210
- Listen doesn't prefix relative paths (to the watched directory) with a directory-separator.
211
-
212
- Therefore make sure _NOT_ to prefix your regexp-patterns for filtering or ignoring paths
213
- with a directory-separator, otherwise they won't work as expected.
214
-
215
- As an example: to ignore the `build` directory in a C-project, use `%r{build/}`
216
- and not `%r{/build/}`.
217
-
218
- ### Non-blocking listening to changes
219
-
220
- Starting a listener blocks the current thread by default. That means any code after the
221
- `start` call won't be run until the listener is stopped (which needs to be done from another thread).
222
-
223
- For advanced usage there is an option to disable this behavior and have the listener start working
224
- in the background without blocking. To enable non-blocking listening the `start` method of
225
- the listener (be it `Listener` or `MultiListener`) needs to be called with `false` as a parameter.
226
-
227
- Here is an example of using a listener in the non-blocking mode:
228
-
229
- ```ruby
230
- listener = Listen.to('dir/path/to/listen')
231
- listener.start(false) # doesn't block execution
232
-
233
- # Code here will run immediately after starting the listener
234
-
235
- ```
236
-
237
- **note**: Using the `Listen.to` helper-method with a callback-block will always
238
- block execution. See the "Block API" section for an example.
239
-
240
- ## Listen adapters
241
-
242
- The Listen gem has a set of adapters to notify it when there are changes.
243
- There are 3 OS-specific adapters to support Mac, Linux and Windows. These adapters are fast
244
- as they use some system-calls to implement the notifying function.
245
-
246
- There is also a polling adapter which is a cross-platform adapter and it will
247
- work on any system. This adapter is unfortunately slower than the rest of the adapters.
248
-
249
- The Listen gem will choose the best and working adapter for your machine automatically. If you
250
- want to force the use of the polling adapter, either use the `:force_polling` option
251
- while initializing the listener or call the `force_polling` method on your listener
252
- before starting it.
253
-
254
- <a name="fallback"/>
255
- ## Polling fallback
256
-
257
- When a OS-specific adapter doesn't work the Listen gem automatically falls back to the polling adapter.
258
- Here are some things you could try to avoid the polling fallback:
259
-
260
- * [Update your Dropbox client](http://www.dropbox.com/downloading) (if used).
261
- * Increase latency. (Please [open an issue](https://github.com/guard/listen/issues/new) if you think that default is too low.)
262
- * Move or rename the listened folder.
263
- * Update/reboot your OS.
264
-
265
- If your application keeps using the polling-adapter and you can't figure out why, feel free to [open an issue](https://github.com/guard/listen/issues/new) (and be sure to give all the details).
266
-
267
- ## Development [![Dependency Status](https://gemnasium.com/guard/listen.png?branch=master)](https://gemnasium.com/guard/listen)
268
-
269
- * Documentation hosted at [RubyDoc](http://rubydoc.info/github/guard/listen/master/frames).
270
- * Source hosted at [GitHub](https://github.com/guard/listen).
271
-
272
- Pull requests are very welcome! Please try to follow these simple rules if applicable:
273
-
274
- * Please create a topic branch for every separate change you make.
275
- * Make sure your patches are well tested. All specs run with `rake spec:portability` must pass.
276
- * Update the [Yard](http://yardoc.org/) documentation.
277
- * Update the README.
278
- * Update the CHANGELOG for noteworthy changes.
279
- * Please **do not change** the version number.
280
-
281
- For questions please join us in our [Google group](http://groups.google.com/group/guard-dev) or on
282
- `#guard` (irc.freenode.net).
283
-
284
- ## Acknowledgment
285
-
286
- * [Michael Kessler (netzpirat)][] for having written the [initial specs](https://github.com/guard/listen/commit/1e457b13b1bb8a25d2240428ce5ed488bafbed1f).
287
- * [Travis Tilley (ttilley)][] for this awesome work on [fssm][] & [rb-fsevent][].
288
- * [Nathan Weizenbaum (nex3)][] for [rb-inotify][], a thorough inotify wrapper.
289
- * [stereobooster][] for [rb-fchange][], windows support wouldn't exist without him.
290
- * [Yehuda Katz (wycats)][] for [vigilo][], that has been a great source of inspiration.
291
-
292
- ## Authors
293
-
294
- * [Thibaud Guillaume-Gentil][] ([@thibaudgg](http://twitter.com/thibaudgg))
295
- * [Maher Sallam][] ([@mahersalam](http://twitter.com/mahersalam))
296
-
297
- ## Contributors
298
-
299
- [https://github.com/guard/listen/contributors](https://github.com/guard/listen/contributors)
300
-
301
- [Thibaud Guillaume-Gentil]: https://github.com/thibaudgg
302
- [Maher Sallam]: https://github.com/Maher4Ever
303
- [Michael Kessler (netzpirat)]: https://github.com/netzpirat
304
- [Travis Tilley (ttilley)]: https://github.com/ttilley
305
- [fssm]: https://github.com/ttilley/fssm
306
- [rb-fsevent]: https://github.com/thibaudgg/rb-fsevent
307
- [Nathan Weizenbaum (nex3)]: https://github.com/nex3
308
- [rb-inotify]: https://github.com/nex3/rb-inotify
309
- [stereobooster]: https://github.com/stereobooster
310
- [rb-fchange]: https://github.com/stereobooster/rb-fchange
311
- [Yehuda Katz (wycats)]: https://github.com/wycats
312
- [vigilo]: https://github.com/wycats/vigilo