mvz-dnote 1.7.2 → 1.10.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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