guard-annotate 2.2 → 2.3
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/LICENSE +1 -1
- data/{README.rdoc → README.md} +67 -13
- data/lib/guard/annotate.rb +16 -3
- data/lib/guard/annotate/version.rb +1 -1
- metadata +6 -7
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 36bebacaf5025571496eced14c294ab7c2add09d
|
4
|
+
data.tar.gz: 356a67a27ecb62c48df1832b9628e45efcadfdbf
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: dc680e273a866a222fa56b9ff0039badf8034c180d47e6489451d0c05f76a75d1f5154e29f5187e9e4dfe703fe5e5d3883db6862c00cde6ef608530639dc54cc
|
7
|
+
data.tar.gz: 4028ddeece91c375e7da189ee02856996019292006a740ea6e042efe734443c462864c01d9c30958e157bd7faf99baf73f05a9ff3c45b570c203a47be2ad632c
|
data/LICENSE
CHANGED
data/{README.rdoc → README.md}
RENAMED
@@ -1,17 +1,24 @@
|
|
1
|
-
|
1
|
+
---
|
2
|
+
|
3
|
+
**NOTE: guard-annotate is currently looking for new maintainers. While I am still trying to accept and stay on top of new Pull Requests, I no longer personally actively use this guard plugin. If you are interested in becoming a maintainer, please contact me via email at cpjolicoeur@gmail.com**
|
4
|
+
|
5
|
+
---
|
6
|
+
|
7
|
+
# Guard::Annotate
|
2
8
|
|
3
9
|
Annotate guard runs the annotate gem when needed
|
4
10
|
|
5
11
|
- Compatible with Annotate 2.4.x
|
6
|
-
- Tested on Ruby 1.
|
12
|
+
- Tested on Ruby 1.9.x, 2.0.x, 2.1.x, 2.2.x
|
7
13
|
|
8
|
-
|
14
|
+
## Install
|
9
15
|
|
10
16
|
Install the gem:
|
11
17
|
|
12
18
|
gem install guard-annotate
|
13
19
|
|
14
20
|
Add the gem to your Gemfile:
|
21
|
+
|
15
22
|
gem 'guard-annotate'
|
16
23
|
|
17
24
|
Add guard definitions to your Guardfile by running:
|
@@ -19,13 +26,13 @@ Add guard definitions to your Guardfile by running:
|
|
19
26
|
guard init annotate
|
20
27
|
|
21
28
|
|
22
|
-
|
29
|
+
## Usage
|
23
30
|
|
24
|
-
Please read the
|
31
|
+
Please read the [Guard usage docs][1]
|
25
32
|
|
26
|
-
|
33
|
+
## Guardfile
|
27
34
|
|
28
|
-
|
35
|
+
### Standard Ruby on Rails project
|
29
36
|
|
30
37
|
guard 'annotate' do
|
31
38
|
watch( 'db/schema.rb' )
|
@@ -35,13 +42,17 @@ Please read the {Guard usage docs}[https://github.com/guard/guard#readme]
|
|
35
42
|
end
|
36
43
|
|
37
44
|
|
38
|
-
|
45
|
+
## Options
|
46
|
+
|
47
|
+
### Desktop notifications
|
39
48
|
|
40
49
|
You can disable desktop notifications with (default is notifications are enabled):
|
41
50
|
|
42
51
|
guard 'annotate', :notify => false do
|
43
52
|
...
|
44
53
|
end
|
54
|
+
|
55
|
+
### Placement
|
45
56
|
|
46
57
|
You can customize the placement of the annotations with (default is 'before'):
|
47
58
|
|
@@ -49,17 +60,39 @@ You can customize the placement of the annotations with (default is 'before'):
|
|
49
60
|
...
|
50
61
|
end
|
51
62
|
|
63
|
+
### Routes
|
64
|
+
|
52
65
|
You can choose to also annotate your routes file with true, false or 'before'/'after' (default is false):
|
53
66
|
|
54
67
|
guard 'annotate', :routes => 'before|after' do
|
55
68
|
...
|
56
69
|
end
|
70
|
+
|
71
|
+
### Tests Annotation
|
57
72
|
|
58
73
|
You can annotate your tests and fixtures files with (default is false):
|
59
74
|
|
60
75
|
guard 'annotate', :tests => true do
|
61
76
|
...
|
62
77
|
end
|
78
|
+
|
79
|
+
### Factory Exclusion
|
80
|
+
|
81
|
+
You can exclude annotations in factory files with (default is true):
|
82
|
+
|
83
|
+
guard 'annotate', :factories => false do
|
84
|
+
...
|
85
|
+
end
|
86
|
+
|
87
|
+
### Serializers
|
88
|
+
|
89
|
+
You can exclude annotations in serializers with (default is true):
|
90
|
+
|
91
|
+
guard 'annotate', :serializers => false do
|
92
|
+
...
|
93
|
+
end
|
94
|
+
|
95
|
+
### Run at start
|
63
96
|
|
64
97
|
You can disable run at start with (default is true):
|
65
98
|
|
@@ -67,35 +100,56 @@ You can disable run at start with (default is true):
|
|
67
100
|
...
|
68
101
|
end
|
69
102
|
|
103
|
+
### Indexes
|
104
|
+
|
70
105
|
You can annotate indexes on your models with (default is false):
|
71
106
|
|
72
107
|
guard 'annotate', :show_indexes => true do
|
73
108
|
...
|
74
109
|
end
|
75
110
|
|
111
|
+
### Simple Indexes
|
112
|
+
|
76
113
|
You can add simple indexes to the column information (default is false):
|
77
114
|
|
78
115
|
guard 'annotate', :simple_indexes => true do
|
79
116
|
...
|
80
117
|
end
|
81
118
|
|
119
|
+
|
120
|
+
### Foreign Keys
|
121
|
+
|
122
|
+
You can show foreign keys (default is false):
|
123
|
+
|
124
|
+
guard 'annotate', :show_foreign_keys => true do
|
125
|
+
...
|
126
|
+
end
|
127
|
+
|
128
|
+
### Migration version number
|
82
129
|
You can show migration version number in the annotation (default is false):
|
83
130
|
|
84
131
|
guard 'annotate', :show_migration => true do
|
85
132
|
...
|
86
133
|
end
|
87
134
|
|
135
|
+
### Annotation Format
|
136
|
+
|
88
137
|
You can annotate in three different formats: :bare, :rdoc and :markdown (default is :bare):
|
89
138
|
|
90
139
|
guard 'annotate', :format => :rdoc do
|
91
140
|
...
|
92
141
|
end
|
93
142
|
|
94
|
-
|
143
|
+
## Development
|
144
|
+
|
145
|
+
- Source hosed at [GitHub][2]
|
146
|
+
- Issue/Bug/Question/Feature requests via [GitHub Issues][3]
|
95
147
|
|
96
|
-
|
97
|
-
- Issue/Bug/Question/Feature requests via {GitHub Issues}[http://github.com/cpjolicoeur/guard-annotate/issues]
|
148
|
+
## Authors
|
98
149
|
|
99
|
-
|
150
|
+
[Craig P Jolicoeur][4]
|
100
151
|
|
101
|
-
|
152
|
+
[1]: https://github.com/guard/guard#readme]
|
153
|
+
[2]: https://github.com/guard/guard-annotate
|
154
|
+
[3]: http://github.com/guard/guard-annotate/issues
|
155
|
+
[4]: https://github.com/cpjolicoeur
|
data/lib/guard/annotate.rb
CHANGED
@@ -13,11 +13,14 @@ module Guard
|
|
13
13
|
options[:notify] = true if options[:notify].nil?
|
14
14
|
options[:position] = 'before' if options[:position].nil?
|
15
15
|
options[:tests] = false if options[:tests].nil?
|
16
|
+
options[:factories] = true if options[:factories].nil?
|
17
|
+
options[:serializers] = true if options[:serializers].nil?
|
16
18
|
options[:sort] = false if options[:sort].nil?
|
17
19
|
options[:routes] = false if options[:routes].nil?
|
18
20
|
options[:run_at_start] = true if options[:run_at_start].nil?
|
19
21
|
options[:show_indexes] = false if options[:show_indexes].nil?
|
20
22
|
options[:simple_indexes] = false if options[:simple_indexes].nil?
|
23
|
+
options[:show_foreign_keys] = false if options[:show_foreign_keys].nil?
|
21
24
|
options[:show_migration] = false if options[:show_migration].nil?
|
22
25
|
options[:format] = nil if options[:format].nil? or not [:bare, :markdown, :rdoc].include? options[:format].to_sym
|
23
26
|
end
|
@@ -57,8 +60,13 @@ module Guard
|
|
57
60
|
options[:routes]
|
58
61
|
end
|
59
62
|
|
60
|
-
def
|
61
|
-
|
63
|
+
def annotate_excludes
|
64
|
+
excludes = []
|
65
|
+
excludes << 'tests' << 'fixtures' unless options[:tests]
|
66
|
+
excludes << 'factories' unless options[:factories]
|
67
|
+
excludes << 'serializers' unless options[:serializers]
|
68
|
+
|
69
|
+
excludes.empty? ? '' : "--exclude #{excludes.join(',')}"
|
62
70
|
end
|
63
71
|
|
64
72
|
def annotate_sort_columns?
|
@@ -84,17 +92,22 @@ module Guard
|
|
84
92
|
def show_migration?
|
85
93
|
options[:show_migration]
|
86
94
|
end
|
95
|
+
|
96
|
+
def show_foreign_keys?
|
97
|
+
options[:show_foreign_keys]
|
98
|
+
end
|
87
99
|
|
88
100
|
def run_annotate
|
89
101
|
Compat::UI.info 'Running annotate', :reset => true
|
90
102
|
started_at = Time.now
|
91
103
|
annotate_models_options, annotate_options = '', ''
|
92
104
|
|
93
|
-
annotate_models_command = "bundle exec annotate #{
|
105
|
+
annotate_models_command = "bundle exec annotate #{annotate_excludes} -p #{annotation_position}"
|
94
106
|
annotate_models_options += ' --sort' if annotate_sort_columns?
|
95
107
|
annotate_models_options += ' --show-indexes' if show_indexes?
|
96
108
|
annotate_models_options += ' --simple-indexes' if simple_indexes?
|
97
109
|
annotate_models_options += ' --show-migration' if show_migration?
|
110
|
+
annotate_models_options += ' --show-foreign-keys' if show_foreign_keys?
|
98
111
|
annotate_options += " --format=#{annotate_format}" if annotate_format?
|
99
112
|
|
100
113
|
annotate_models_command += annotate_models_options + annotate_options
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: guard-annotate
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: '2.
|
4
|
+
version: '2.3'
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Craig P Jolicoeur
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2015-
|
11
|
+
date: 2015-12-02 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: guard-compat
|
@@ -72,7 +72,7 @@ extensions: []
|
|
72
72
|
extra_rdoc_files: []
|
73
73
|
files:
|
74
74
|
- LICENSE
|
75
|
-
- README.
|
75
|
+
- README.md
|
76
76
|
- lib/guard/annotate.rb
|
77
77
|
- lib/guard/annotate/notifier.rb
|
78
78
|
- lib/guard/annotate/templates/Guardfile
|
@@ -84,11 +84,10 @@ metadata: {}
|
|
84
84
|
post_install_message: |-
|
85
85
|
** guard-annotate is looking for maintainers. While I am still trying
|
86
86
|
to accept and stay on top of new Pull Requests, I no longer personally actively use this guard
|
87
|
-
plugin. If you are interested in becoming a maintainer please contact me via
|
88
|
-
https://github.com/guard/guard-annotate. **
|
87
|
+
plugin. If you are interested in becoming a maintainer please contact me via email at cpjolicoeur@gmail.com. **
|
89
88
|
rdoc_options:
|
90
89
|
- "--charset=UTF-8"
|
91
|
-
- "--main=README.
|
90
|
+
- "--main=README.md"
|
92
91
|
- "--exclude='(lib|test|spec)|(Gem|Guard|Rake)file'"
|
93
92
|
require_paths:
|
94
93
|
- lib
|
@@ -104,7 +103,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
104
103
|
version: '0'
|
105
104
|
requirements: []
|
106
105
|
rubyforge_project: guard-annotate
|
107
|
-
rubygems_version: 2.
|
106
|
+
rubygems_version: 2.4.5.1
|
108
107
|
signing_key:
|
109
108
|
specification_version: 4
|
110
109
|
summary: Guard gem for annotate
|