guard-annotate 2.2 → 2.3
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 +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
|