mvz-dnote 1.7.2 → 1.10.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +5 -5
- data/HISTORY.rdoc +18 -0
- data/README.md +116 -0
- data/bin/dnote +10 -1
- data/lib/dnote/core_ext.rb +11 -67
- data/lib/dnote/format.rb +59 -83
- data/lib/dnote/note.rb +25 -49
- data/lib/dnote/notes.rb +83 -210
- data/lib/dnote/notes_collection.rb +73 -0
- data/lib/dnote/options.rb +125 -0
- data/lib/dnote/rake/dnotetask.rb +55 -57
- data/lib/dnote/session.rb +49 -152
- data/lib/dnote/version.rb +3 -15
- data/lib/dnote.rb +4 -2
- metadata +128 -26
- data/README.rdoc +0 -113
- data/lib/dnote.yml +0 -1
- data/try/sample.bas +0 -7
- data/try/sample.js +0 -11
- data/try/sample.rb +0 -11
metadata
CHANGED
@@ -1,15 +1,15 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: mvz-dnote
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 1.
|
4
|
+
version: 1.10.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Thomas Sawyer
|
8
8
|
- Matijs van Zuijlen
|
9
|
-
autorequire:
|
9
|
+
autorequire:
|
10
10
|
bindir: bin
|
11
11
|
cert_chain: []
|
12
|
-
date:
|
12
|
+
date: 2022-04-10 00:00:00.000000000 Z
|
13
13
|
dependencies:
|
14
14
|
- !ruby/object:Gem::Dependency
|
15
15
|
name: aruba
|
@@ -17,42 +17,70 @@ dependencies:
|
|
17
17
|
requirements:
|
18
18
|
- - "~>"
|
19
19
|
- !ruby/object:Gem::Version
|
20
|
-
version: 0
|
20
|
+
version: '2.0'
|
21
21
|
type: :development
|
22
22
|
prerelease: false
|
23
23
|
version_requirements: !ruby/object:Gem::Requirement
|
24
24
|
requirements:
|
25
25
|
- - "~>"
|
26
26
|
- !ruby/object:Gem::Version
|
27
|
-
version: 0
|
27
|
+
version: '2.0'
|
28
28
|
- !ruby/object:Gem::Dependency
|
29
29
|
name: cucumber
|
30
30
|
requirement: !ruby/object:Gem::Requirement
|
31
31
|
requirements:
|
32
32
|
- - "~>"
|
33
33
|
- !ruby/object:Gem::Version
|
34
|
-
version: '
|
34
|
+
version: '7.0'
|
35
35
|
type: :development
|
36
36
|
prerelease: false
|
37
37
|
version_requirements: !ruby/object:Gem::Requirement
|
38
38
|
requirements:
|
39
39
|
- - "~>"
|
40
40
|
- !ruby/object:Gem::Version
|
41
|
-
version: '
|
41
|
+
version: '7.0'
|
42
|
+
- !ruby/object:Gem::Dependency
|
43
|
+
name: pry
|
44
|
+
requirement: !ruby/object:Gem::Requirement
|
45
|
+
requirements:
|
46
|
+
- - "~>"
|
47
|
+
- !ruby/object:Gem::Version
|
48
|
+
version: 0.14.0
|
49
|
+
type: :development
|
50
|
+
prerelease: false
|
51
|
+
version_requirements: !ruby/object:Gem::Requirement
|
52
|
+
requirements:
|
53
|
+
- - "~>"
|
54
|
+
- !ruby/object:Gem::Version
|
55
|
+
version: 0.14.0
|
42
56
|
- !ruby/object:Gem::Dependency
|
43
57
|
name: rake
|
44
58
|
requirement: !ruby/object:Gem::Requirement
|
45
59
|
requirements:
|
46
60
|
- - "~>"
|
47
61
|
- !ruby/object:Gem::Version
|
48
|
-
version: '
|
62
|
+
version: '13.0'
|
49
63
|
type: :development
|
50
64
|
prerelease: false
|
51
65
|
version_requirements: !ruby/object:Gem::Requirement
|
52
66
|
requirements:
|
53
67
|
- - "~>"
|
54
68
|
- !ruby/object:Gem::Version
|
55
|
-
version: '
|
69
|
+
version: '13.0'
|
70
|
+
- !ruby/object:Gem::Dependency
|
71
|
+
name: rake-manifest
|
72
|
+
requirement: !ruby/object:Gem::Requirement
|
73
|
+
requirements:
|
74
|
+
- - "~>"
|
75
|
+
- !ruby/object:Gem::Version
|
76
|
+
version: 0.2.0
|
77
|
+
type: :development
|
78
|
+
prerelease: false
|
79
|
+
version_requirements: !ruby/object:Gem::Requirement
|
80
|
+
requirements:
|
81
|
+
- - "~>"
|
82
|
+
- !ruby/object:Gem::Version
|
83
|
+
version: 0.2.0
|
56
84
|
- !ruby/object:Gem::Dependency
|
57
85
|
name: rspec
|
58
86
|
requirement: !ruby/object:Gem::Requirement
|
@@ -67,9 +95,79 @@ dependencies:
|
|
67
95
|
- - "~>"
|
68
96
|
- !ruby/object:Gem::Version
|
69
97
|
version: '3.5'
|
70
|
-
|
71
|
-
|
72
|
-
|
98
|
+
- !ruby/object:Gem::Dependency
|
99
|
+
name: rubocop
|
100
|
+
requirement: !ruby/object:Gem::Requirement
|
101
|
+
requirements:
|
102
|
+
- - "~>"
|
103
|
+
- !ruby/object:Gem::Version
|
104
|
+
version: '1.26'
|
105
|
+
type: :development
|
106
|
+
prerelease: false
|
107
|
+
version_requirements: !ruby/object:Gem::Requirement
|
108
|
+
requirements:
|
109
|
+
- - "~>"
|
110
|
+
- !ruby/object:Gem::Version
|
111
|
+
version: '1.26'
|
112
|
+
- !ruby/object:Gem::Dependency
|
113
|
+
name: rubocop-packaging
|
114
|
+
requirement: !ruby/object:Gem::Requirement
|
115
|
+
requirements:
|
116
|
+
- - "~>"
|
117
|
+
- !ruby/object:Gem::Version
|
118
|
+
version: 0.5.0
|
119
|
+
type: :development
|
120
|
+
prerelease: false
|
121
|
+
version_requirements: !ruby/object:Gem::Requirement
|
122
|
+
requirements:
|
123
|
+
- - "~>"
|
124
|
+
- !ruby/object:Gem::Version
|
125
|
+
version: 0.5.0
|
126
|
+
- !ruby/object:Gem::Dependency
|
127
|
+
name: rubocop-performance
|
128
|
+
requirement: !ruby/object:Gem::Requirement
|
129
|
+
requirements:
|
130
|
+
- - "~>"
|
131
|
+
- !ruby/object:Gem::Version
|
132
|
+
version: '1.13'
|
133
|
+
type: :development
|
134
|
+
prerelease: false
|
135
|
+
version_requirements: !ruby/object:Gem::Requirement
|
136
|
+
requirements:
|
137
|
+
- - "~>"
|
138
|
+
- !ruby/object:Gem::Version
|
139
|
+
version: '1.13'
|
140
|
+
- !ruby/object:Gem::Dependency
|
141
|
+
name: rubocop-rspec
|
142
|
+
requirement: !ruby/object:Gem::Requirement
|
143
|
+
requirements:
|
144
|
+
- - "~>"
|
145
|
+
- !ruby/object:Gem::Version
|
146
|
+
version: '2.9'
|
147
|
+
type: :development
|
148
|
+
prerelease: false
|
149
|
+
version_requirements: !ruby/object:Gem::Requirement
|
150
|
+
requirements:
|
151
|
+
- - "~>"
|
152
|
+
- !ruby/object:Gem::Version
|
153
|
+
version: '2.9'
|
154
|
+
- !ruby/object:Gem::Dependency
|
155
|
+
name: simplecov
|
156
|
+
requirement: !ruby/object:Gem::Requirement
|
157
|
+
requirements:
|
158
|
+
- - "~>"
|
159
|
+
- !ruby/object:Gem::Version
|
160
|
+
version: 0.21.0
|
161
|
+
type: :development
|
162
|
+
prerelease: false
|
163
|
+
version_requirements: !ruby/object:Gem::Requirement
|
164
|
+
requirements:
|
165
|
+
- - "~>"
|
166
|
+
- !ruby/object:Gem::Version
|
167
|
+
version: 0.21.0
|
168
|
+
description: |
|
169
|
+
DNote makes it easy to extract developer's notes from source code,
|
170
|
+
and supports almost any language.
|
73
171
|
email:
|
74
172
|
- matijs@matijs.net
|
75
173
|
executables:
|
@@ -77,19 +175,20 @@ executables:
|
|
77
175
|
extensions: []
|
78
176
|
extra_rdoc_files:
|
79
177
|
- HISTORY.rdoc
|
80
|
-
- README.
|
178
|
+
- README.md
|
81
179
|
- COPYING.rdoc
|
82
180
|
files:
|
83
181
|
- COPYING.rdoc
|
84
182
|
- HISTORY.rdoc
|
85
|
-
- README.
|
183
|
+
- README.md
|
86
184
|
- bin/dnote
|
87
185
|
- lib/dnote.rb
|
88
|
-
- lib/dnote.yml
|
89
186
|
- lib/dnote/core_ext.rb
|
90
187
|
- lib/dnote/format.rb
|
91
188
|
- lib/dnote/note.rb
|
92
189
|
- lib/dnote/notes.rb
|
190
|
+
- lib/dnote/notes_collection.rb
|
191
|
+
- lib/dnote/options.rb
|
93
192
|
- lib/dnote/rake/dnotetask.rb
|
94
193
|
- lib/dnote/session.rb
|
95
194
|
- lib/dnote/templates/html.erb
|
@@ -129,30 +228,33 @@ files:
|
|
129
228
|
- lib/dnote/templates/yaml/label.erb
|
130
229
|
- lib/dnote/templates/yaml/list.erb
|
131
230
|
- lib/dnote/version.rb
|
132
|
-
- try/sample.bas
|
133
|
-
- try/sample.js
|
134
|
-
- try/sample.rb
|
135
231
|
homepage: https://github.com/mvz/dnote
|
136
|
-
licenses:
|
137
|
-
|
138
|
-
|
139
|
-
|
232
|
+
licenses:
|
233
|
+
- BSD-2-Clause
|
234
|
+
metadata:
|
235
|
+
homepage_uri: https://github.com/mvz/dnote
|
236
|
+
source_code_uri: https://github.com/mvz/dnote
|
237
|
+
changelog_uri: https://github.com/mvz/dnote/blob/master/HISTORY.rdoc
|
238
|
+
rubygems_mfa_required: 'true'
|
239
|
+
post_install_message:
|
240
|
+
rdoc_options:
|
241
|
+
- "--main"
|
242
|
+
- README.md
|
140
243
|
require_paths:
|
141
244
|
- lib
|
142
245
|
required_ruby_version: !ruby/object:Gem::Requirement
|
143
246
|
requirements:
|
144
247
|
- - ">="
|
145
248
|
- !ruby/object:Gem::Version
|
146
|
-
version:
|
249
|
+
version: 2.6.0
|
147
250
|
required_rubygems_version: !ruby/object:Gem::Requirement
|
148
251
|
requirements:
|
149
252
|
- - ">="
|
150
253
|
- !ruby/object:Gem::Version
|
151
254
|
version: '0'
|
152
255
|
requirements: []
|
153
|
-
|
154
|
-
|
155
|
-
signing_key:
|
256
|
+
rubygems_version: 3.3.7
|
257
|
+
signing_key:
|
156
258
|
specification_version: 4
|
157
259
|
summary: Extract developer's notes from source code.
|
158
260
|
test_files: []
|
data/README.rdoc
DELETED
@@ -1,113 +0,0 @@
|
|
1
|
-
= DNote
|
2
|
-
|
3
|
-
* {Homepage}[http://rubyworks.github.com/dnote]
|
4
|
-
* {Mailing List}[http://googlegroups.com/group/rubyworks-mailinglist]
|
5
|
-
* {Source Code}[http://github.com/rubyworks/dnote]
|
6
|
-
|
7
|
-
|
8
|
-
== DESCRIPTION
|
9
|
-
|
10
|
-
Extract development notes from source code and generate some nice
|
11
|
-
output formats for them.
|
12
|
-
|
13
|
-
|
14
|
-
== SYNOPSIS
|
15
|
-
|
16
|
-
=== Note Structure
|
17
|
-
|
18
|
-
DNote scans for the common note patterns used by developers of many languages in the form of an
|
19
|
-
all-caps labels followed by a colon. To be more specific, for DNote to recognize a note,
|
20
|
-
it needs to follow this simple set of rules:
|
21
|
-
|
22
|
-
1) Notes start with an all-caps label punctuated with a colon, followed by the note's text.
|
23
|
-
|
24
|
-
# LABEL: description ...
|
25
|
-
|
26
|
-
2) Any note that requires more than one line must remain flush to the left
|
27
|
-
margin (the margin is set by the first line). This is done because RDoc will mistake
|
28
|
-
the note for a <code>pre</code> block if it is indented.
|
29
|
-
|
30
|
-
# LABEL: description ...
|
31
|
-
# continue ...
|
32
|
-
|
33
|
-
3) An alternative to the previous limitation is to indent the whole note, making it
|
34
|
-
a <tt><pre></tt> block when rendered by RDoc. Then the text layout is free-form.
|
35
|
-
|
36
|
-
# This is a description of something...
|
37
|
-
#
|
38
|
-
# LABEL: description ...
|
39
|
-
# continue ...
|
40
|
-
|
41
|
-
That's all there is to it, if I can convince the developers of RDoc to recognize labels,
|
42
|
-
we may eventually be able to relax the flush rule too, which would be very nice.
|
43
|
-
|
44
|
-
There is also a command-line option, <code>--no-colon</code>, which deactives the need for
|
45
|
-
a colon after the note label. However this often produces false positives, so it's use is
|
46
|
-
discouraged.
|
47
|
-
|
48
|
-
|
49
|
-
=== Generating Notes
|
50
|
-
|
51
|
-
As you can see the commandline interface is pretty straight-forward.
|
52
|
-
|
53
|
-
USAGE:
|
54
|
-
|
55
|
-
dnote [OPTIONS] path1 [path2 ...]
|
56
|
-
|
57
|
-
OUTPUT FORMAT: (choose one)
|
58
|
-
-f, --format NAME select a format [text]
|
59
|
-
-c, --custom FILE use a custom ERB template
|
60
|
-
--file shortcut for text/file format
|
61
|
-
--list shortcut for text/list format
|
62
|
-
|
63
|
-
OTHER OPTIONS:
|
64
|
-
-l, --label LABEL labels to collect
|
65
|
-
--[no-]colon match labels with/without colon suffix
|
66
|
-
-m, --marker MARK alternative remark marker
|
67
|
-
-u --url TEMPLATE url template for line entries (for HTML)
|
68
|
-
-x, --exclude PATH exclude file or directory
|
69
|
-
-i, --ignore NAME ignore based on any part of the pathname
|
70
|
-
-t, --title TITLE title to use in header
|
71
|
-
-o, --output PATH name of file or directory
|
72
|
-
-n, --dryrun do not actually write to disk
|
73
|
-
--debug debug mode
|
74
|
-
|
75
|
-
COMMAND OPTIONS:
|
76
|
-
-T, --templates list available format templates
|
77
|
-
-h, --help show this help information
|
78
|
-
|
79
|
-
The default path is <tt>**/*.rb</tt> and the default format is <tt>-f rdoc</tt>.
|
80
|
-
Here is an example of DNote's current notes in RDoc format:
|
81
|
-
|
82
|
-
= Development Notes
|
83
|
-
|
84
|
-
== TODO
|
85
|
-
|
86
|
-
=== file://lib/dnote/notes.rb
|
87
|
-
|
88
|
-
* TODO: Add ability to read header notes. They often
|
89
|
-
have a outline format, rather then the single line. (19)
|
90
|
-
* TODO: Need good CSS file. (22)
|
91
|
-
* TODO: Need XSL? (24)
|
92
|
-
|
93
|
-
=== file://plug/syckle/services/dnote.rb
|
94
|
-
|
95
|
-
* TODO: Should this service be part of the +site+ cycle? (18)
|
96
|
-
|
97
|
-
(4 TODOs)
|
98
|
-
|
99
|
-
|
100
|
-
== INSTALLATION
|
101
|
-
|
102
|
-
The usual RubyGem's command will do the trick.
|
103
|
-
|
104
|
-
$ sudo gem install dnote
|
105
|
-
|
106
|
-
|
107
|
-
== COPYRIGHT
|
108
|
-
|
109
|
-
Copyright (c) 2006 Thomas Sawyer, Rubyworks
|
110
|
-
|
111
|
-
DNote is distributable in accordance with the terms of the *FreeBSD* license.
|
112
|
-
|
113
|
-
See COPYING.rdoc for details.
|
data/lib/dnote.yml
DELETED
@@ -1 +0,0 @@
|
|
1
|
-
lib/../.ruby
|
data/try/sample.bas
DELETED
data/try/sample.js
DELETED