lazydoc 0.3.0 → 0.3.1
Sign up to get free protection for your applications and to get access to all the features.
- data/History +6 -0
- data/lib/lazydoc.rb +2 -5
- data/lib/lazydoc/comment.rb +5 -5
- data/lib/lazydoc/document.rb +9 -0
- data/lib/lazydoc/utils.rb +6 -3
- metadata +4 -2
data/History
ADDED
data/lib/lazydoc.rb
CHANGED
@@ -24,14 +24,11 @@ module Lazydoc
|
|
24
24
|
lazydoc = registry.find {|doc| doc.source_file == source_file }
|
25
25
|
|
26
26
|
unless lazydoc
|
27
|
-
lazydoc = Document.new(source_file
|
27
|
+
lazydoc = Document.new(source_file)
|
28
28
|
registry << lazydoc
|
29
29
|
end
|
30
30
|
|
31
|
-
|
32
|
-
raise ArgumentError, "inconsistent default_const_name specified for #{source_file}: #{lazydoc.default_const_name.inspect} != #{default_const_name.inspect}"
|
33
|
-
end
|
34
|
-
|
31
|
+
lazydoc.default_const_name = default_const_name
|
35
32
|
lazydoc
|
36
33
|
end
|
37
34
|
|
data/lib/lazydoc/comment.rb
CHANGED
@@ -221,14 +221,14 @@ module Lazydoc
|
|
221
221
|
# As shown in the examples, the dynamically determined line_number
|
222
222
|
# overwrites the Regexp or Proc.
|
223
223
|
def parse_up(str, lines=nil, skip_subject=true)
|
224
|
-
parse(str, lines) do |n,
|
224
|
+
parse(str, lines) do |n, comment_lines|
|
225
225
|
# remove whitespace lines
|
226
226
|
n -= 1 if skip_subject
|
227
|
-
n -= 1 while n >=0 &&
|
227
|
+
n -= 1 while n >=0 && comment_lines[n].strip.empty?
|
228
228
|
|
229
229
|
# put together the comment
|
230
230
|
while n >= 0
|
231
|
-
line =
|
231
|
+
line = comment_lines[n]
|
232
232
|
break if block_given? && yield(line)
|
233
233
|
break unless prepend(line)
|
234
234
|
n -= 1
|
@@ -260,12 +260,12 @@ module Lazydoc
|
|
260
260
|
# c.comment # => "documentation for section two"
|
261
261
|
#
|
262
262
|
def parse_down(str, lines=nil, skip_subject=true)
|
263
|
-
parse(str, lines) do |n,
|
263
|
+
parse(str, lines) do |n, comment_lines|
|
264
264
|
# skip the subject line
|
265
265
|
n += 1 if skip_subject
|
266
266
|
|
267
267
|
# put together the comment
|
268
|
-
while line =
|
268
|
+
while line = comment_lines[n]
|
269
269
|
break if block_given? && yield(line)
|
270
270
|
break unless append(line)
|
271
271
|
n += 1
|
data/lib/lazydoc/document.rb
CHANGED
@@ -146,6 +146,15 @@ module Lazydoc
|
|
146
146
|
@source_file = source_file == nil ? nil : File.expand_path(source_file)
|
147
147
|
end
|
148
148
|
|
149
|
+
# Sets the default_const_name. Raises an error if default_const_name is
|
150
|
+
# already set to a different value.
|
151
|
+
def default_const_name=(input)
|
152
|
+
@default_const_name = case @default_const_name
|
153
|
+
when nil, input then input
|
154
|
+
else raise ArgumentError, "default_const_name cannot be overridden #{source_file}: #{@default_const_name.inspect} != #{input.inspect}"
|
155
|
+
end
|
156
|
+
end
|
157
|
+
|
149
158
|
# Registers the specified line number to self. Register may take an
|
150
159
|
# integer or a regexp for dynamic evaluation. See Comment#resolve for
|
151
160
|
# more details.
|
data/lib/lazydoc/utils.rb
CHANGED
@@ -85,7 +85,8 @@ module Lazydoc
|
|
85
85
|
args = []
|
86
86
|
brakets = braces = parens = 0
|
87
87
|
start = scanner.pos
|
88
|
-
broke =
|
88
|
+
broke = false
|
89
|
+
while scanner.skip(/.*?['"#,\(\)\{\}\[\]]/)
|
89
90
|
pos = scanner.pos - 1
|
90
91
|
|
91
92
|
case str[pos]
|
@@ -97,13 +98,15 @@ module Lazydoc
|
|
97
98
|
args << str[start, pos-start].strip
|
98
99
|
start = pos + 1
|
99
100
|
|
100
|
-
when ?# then break
|
101
|
+
when ?# then broke = true; break # break on a comment
|
101
102
|
when ?' then skip_quote(scanner, /'/) # parse over quoted strings
|
102
103
|
when ?" then skip_quote(scanner, /"/) # parse over double-quoted string
|
103
104
|
|
104
105
|
when ?( then parens += 1 # for brakets, braces, and parenthesis
|
105
106
|
when ?) # simply track the nesting EXCEPT for
|
106
|
-
|
107
|
+
if parens == 0 # RPAREN. If the closing parenthesis
|
108
|
+
broke = true; break
|
109
|
+
end
|
107
110
|
parens -= 1 # is found, break.
|
108
111
|
when ?[ then braces += 1
|
109
112
|
when ?] then braces -= 1
|
metadata
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: lazydoc
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.3.
|
4
|
+
version: 0.3.1
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Simon Chiang
|
@@ -9,7 +9,7 @@ autorequire:
|
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
11
|
|
12
|
-
date:
|
12
|
+
date: 2009-02-17 00:00:00 -07:00
|
13
13
|
default_executable:
|
14
14
|
dependencies: []
|
15
15
|
|
@@ -22,6 +22,7 @@ extensions: []
|
|
22
22
|
extra_rdoc_files:
|
23
23
|
- README
|
24
24
|
- MIT-LICENSE
|
25
|
+
- History
|
25
26
|
files:
|
26
27
|
- lib/lazydoc.rb
|
27
28
|
- lib/lazydoc/arguments.rb
|
@@ -34,6 +35,7 @@ files:
|
|
34
35
|
- lib/lazydoc/utils.rb
|
35
36
|
- README
|
36
37
|
- MIT-LICENSE
|
38
|
+
- History
|
37
39
|
has_rdoc: true
|
38
40
|
homepage: http://tap.rubyforge.org/lazydoc
|
39
41
|
post_install_message:
|