milestoner 10.0.1 → 10.4.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: f763d4ff6a578e19787d6ef72194111861511b4e2ffcf9b97428084d2b62f2bf
4
- data.tar.gz: c744f0223f155282f0a78cf3fba7216fa9e4f7c79d1d7ae0f10428f5e4ba3706
3
+ metadata.gz: 27d5b0fb8d1d2b22dd34a890fca4e1c9e5457517522c19345f60c2fe626805ed
4
+ data.tar.gz: bafe01b14f43e42e2521359b3767aded738c3bc5e937337884ee99fd6fd3f989
5
5
  SHA512:
6
- metadata.gz: 7717804f0e39e6aea2a0d85f915d46805c8cffe1afa70cbf35286619552abefcfe23d43c21dec4a4e6d044796e397857a6621402e9c2b7ea5baab89575ff166d
7
- data.tar.gz: cc6bf186df062fb70cba466f4376a4de2c0b44206fe4c2f48bcf9bf12387619373b1275f2ebbb39cfcb9cd40ed0b62869fa2bb1f7a98eed4a332c17f9df75725
6
+ metadata.gz: e7c0cf919317aac53ebbabc7b6e709258ae4d850c385d1fde6a62ed8114a1205fc59386edd8f3534f0253197898dc594c913e8ae95b6e8b519fff0fa84499cc5
7
+ data.tar.gz: b2538300101f1e0661a4b4ef1c2677ed1a4adf4599467bb6fdfeaa86dd02f88a27182cb7a49c3bb61e1aced9863a0a0c48bc5ea0288922d80a36d76c0db05e56
Binary file
data.tar.gz.sig CHANGED
Binary file
@@ -1,4 +1,4 @@
1
- # Apache License
1
+ = Apache License
2
2
 
3
3
  Version 2.0, January 2004
4
4
 
@@ -6,7 +6,7 @@ http://www.apache.org/licenses
6
6
 
7
7
  TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
8
8
 
9
- ## 1. Definitions
9
+ == 1. Definitions
10
10
 
11
11
  "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by
12
12
  Sections 1 through 9 of this document.
@@ -54,14 +54,14 @@ Contribution."
54
54
  "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a
55
55
  Contribution has been received by Licensor and subsequently incorporated within the Work.
56
56
 
57
- ## 2. Grant of Copyright License
57
+ == 2. Grant of Copyright License
58
58
 
59
59
  Subject to the terms and conditions of this License, each Contributor hereby grants to You a
60
60
  perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to
61
61
  reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and
62
62
  distribute the Work and such Derivative Works in Source or Object form.
63
63
 
64
- ## 3. Grant of Patent License
64
+ == 3. Grant of Patent License
65
65
 
66
66
  Subject to the terms and conditions of this License, each Contributor hereby grants to You a
67
67
  perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this
@@ -74,39 +74,38 @@ a Contribution incorporated within the Work constitutes direct or contributory p
74
74
  then any patent licenses granted to You under this License for that Work shall terminate as of the
75
75
  date such litigation is filed.
76
76
 
77
- ## 4. Redistribution
77
+ == 4. Redistribution
78
78
 
79
79
  You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with
80
80
  or without modifications, and in Source or Object form, provided that You meet the following
81
81
  conditions:
82
82
 
83
- 1. You must give any other recipients of the Work or Derivative Works a copy of this License; and
83
+ . You must give any other recipients of the Work or Derivative Works a copy of this License; and
84
84
 
85
- 2. You must cause any modified files to carry prominent notices stating that You changed the
86
- files; and
85
+ . You must cause any modified files to carry prominent notices stating that You changed the files;
86
+ and
87
87
 
88
- 3. You must retain, in the Source form of any Derivative Works that You distribute, all copyright,
89
- patent, trademark, and attribution notices from the Source form of the Work, excluding those
90
- notices that do not pertain to any part of the Derivative Works; and
88
+ . You must retain, in the Source form of any Derivative Works that You distribute, all copyright,
89
+ patent, trademark, and attribution notices from the Source form of the Work, excluding those
90
+ notices that do not pertain to any part of the Derivative Works; and
91
91
 
92
- 4. If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative
93
- Works that You distribute must include a readable copy of the attribution notices contained
94
- within such NOTICE file, excluding those notices that do not pertain to any part of the
95
- Derivative Works, in at least one of the following places: within a NOTICE text file
96
- distributed as part of the Derivative Works; within the Source form or documentation, if
97
- provided along with the Derivative Works; or, within a display generated by the Derivative
98
- Works, if and wherever such third-party notices normally appear. The contents of the NOTICE
99
- file are for informational purposes only and do not modify the License. You may add Your own
100
- attribution notices within Derivative Works that You distribute, alongside or as an addendum to
101
- the NOTICE text from the Work, provided that such additional attribution notices cannot be
102
- construed as modifying the License.
92
+ . If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works
93
+ that You distribute must include a readable copy of the attribution notices contained within such
94
+ NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in
95
+ at least one of the following places: within a NOTICE text file distributed as part of the
96
+ Derivative Works; within the Source form or documentation, if provided along with the Derivative
97
+ Works; or, within a display generated by the Derivative Works, if and wherever such third-party
98
+ notices normally appear. The contents of the NOTICE file are for informational purposes only and
99
+ do not modify the License. You may add Your own attribution notices within Derivative Works that
100
+ You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such
101
+ additional attribution notices cannot be construed as modifying the License.
103
102
 
104
103
  You may add Your own copyright statement to Your modifications and may provide additional or
105
104
  different license terms and conditions for use, reproduction, or distribution of Your modifications,
106
105
  or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of
107
106
  the Work otherwise complies with the conditions stated in this License.
108
107
 
109
- ## 5. Submission of Contributions
108
+ == 5. Submission of Contributions
110
109
 
111
110
  Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the
112
111
  Work by You to the Licensor shall be under the terms and conditions of this License, without any
@@ -114,13 +113,13 @@ additional terms or conditions. Notwithstanding the above, nothing herein shall
114
113
  the terms of any separate license agreement you may have executed with Licensor regarding such
115
114
  Contributions.
116
115
 
117
- ## 6. Trademarks
116
+ == 6. Trademarks
118
117
 
119
118
  This License does not grant permission to use the trade names, trademarks, service marks, or product
120
119
  names of the Licensor, except as required for reasonable and customary use in describing the origin
121
120
  of the Work and reproducing the content of the NOTICE file.
122
121
 
123
- ## 7. Disclaimer of Warranty
122
+ == 7. Disclaimer of Warranty
124
123
 
125
124
  Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each
126
125
  Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
@@ -129,7 +128,7 @@ TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. Y
129
128
  responsible for determining the appropriateness of using or redistributing the Work and assume any
130
129
  risks associated with Your exercise of permissions under this License.
131
130
 
132
- ## 8. Limitation of Liability
131
+ == 8. Limitation of Liability
133
132
 
134
133
  In no event and under no legal theory, whether in tort (including negligence), contract, or
135
134
  otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or
@@ -139,7 +138,7 @@ License or out of the use or inability to use the Work (including but not limite
139
138
  loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial
140
139
  damages or losses), even if such Contributor has been advised of the possibility of such damages.
141
140
 
142
- ## 9. Accepting Warranty or Additional Liability
141
+ == 9. Accepting Warranty or Additional Liability
143
142
 
144
143
  While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee
145
144
  for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights
@@ -151,11 +150,11 @@ additional liability.
151
150
 
152
151
  END OF TERMS AND CONDITIONS
153
152
 
154
- Copyright 2015 [Alchemists](https://www.alchemists.io).
153
+ Copyright 2015 link:https://www.alchemists.io/team/brooke_kuhlmann[Brooke Kuhlmann].
155
154
 
156
155
  Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in
157
- compliance with the License. You may obtain a [copy](http://www.apache.org/licenses/LICENSE-2.0) of
158
- the License.
156
+ compliance with the License. You may obtain a link:https://www.apache.org/licenses/LICENSE-2.0[copy]
157
+ of the License.
159
158
 
160
159
  Unless required by applicable law or agreed to in writing, software distributed under the License is
161
160
  distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
@@ -0,0 +1,228 @@
1
+ :toc: macro
2
+ :toclevels: 5
3
+ :figure-caption!:
4
+
5
+ = Milestoner
6
+
7
+ [link=http://badge.fury.io/rb/milestoner]
8
+ image::https://badge.fury.io/rb/milestoner.svg[Gem Version]
9
+ [link=https://www.alchemists.io/projects/code_quality]
10
+ image::https://img.shields.io/badge/code_style-alchemists-brightgreen.svg[Alchemists Style Guide]
11
+ [link=https://circleci.com/gh/bkuhlmann/milestoner]
12
+ image::https://circleci.com/gh/bkuhlmann/milestoner.svg?style=svg[Circle CI Status]
13
+
14
+ A command line interface for crafting Git repository milestones (also known as _tags_).
15
+
16
+ toc::[]
17
+
18
+ == Features
19
+
20
+ * Uses link:https://www.alchemists.io/projects/versionaire[Versionaire] for
21
+ link:https://semver.org[Semantic Versioning].
22
+ ** Format: `+<major>.<minor>.<patch>+`.
23
+ ** Example: `+0.1.0+`.
24
+ * Ensures Git commits since last tag (or initialization of repository) are included.
25
+ * Ensures Git commit messages are grouped by prefix, in order defined. For more details, see
26
+ link:https://www.alchemists.io/projects/git-cop/#_commit_subject_prefix[Git Cop Subject Prefix]
27
+ for details. Defaults (can be customized):
28
+ ** Fixed
29
+ ** Added
30
+ ** Updated
31
+ ** Removed
32
+ ** Refactored
33
+ * Ensures Git commit merge messages are excluded.
34
+ * Ensures Git commit messages are alphabetically sorted.
35
+ * Ensures duplicate Git commit messages are removed (if any).
36
+ * Ensures Git commit messages are sanitized by removing extra spaces and `+[ci skip]+` text within
37
+ each Git tag message.
38
+ * Provides optional security for signing Git tags with https://www.gnupg.org[GnuPG] signing key.
39
+
40
+ == Screencasts
41
+
42
+ [link=https://www.alchemists.io/screencasts/milestoner]
43
+ image::https://www.alchemists.io/images/screencasts/milestoner/cover.svg[Screencast,600,240,role=focal_point]
44
+
45
+ == Requirements
46
+
47
+ . A UNIX-based system.
48
+ . https://www.ruby-lang.org[Ruby].
49
+ . https://www.gnupg.org[GnuPG].
50
+
51
+ == Setup
52
+
53
+ To install, run:
54
+
55
+ [source,bash]
56
+ ----
57
+ gem install milestoner
58
+ ----
59
+
60
+ == Usage
61
+
62
+ === Command Line Interface (CLI)
63
+
64
+ From the command line, type: `+milestoner help+`
65
+
66
+ ....
67
+ milestoner -C, [--commits] # Show commits for next milestone.
68
+ milestoner -P, [--publish=VERSION] # Tag and push milestone to remote repository.
69
+ milestoner -c, [--config] # Manage gem configuration.
70
+ milestoner -h, [--help=COMMAND] # Show this message or get help for a command.
71
+ milestoner -p, [--push=VERSION] # Push local tag to remote repository.
72
+ milestoner -t, [--tag=VERSION] # Tag local repository with new version.
73
+ milestoner -v, [--version] # Show gem version.
74
+ ....
75
+
76
+ For config options, type: `+milestoner help --config+`
77
+
78
+ ....
79
+ -e, [--edit], [--no-edit] # Edit gem configuration.
80
+ -i, [--info], [--no-info] # Print gem configuration info.
81
+ ....
82
+
83
+ For tag options, type: `+milestoner help --tag+`
84
+
85
+ ....
86
+ -s, [--sign], [--no-sign] # Sign tag with GPG key.
87
+ ....
88
+
89
+ For publish options, type: `+milestoner help --publish+`
90
+
91
+ ....
92
+ -s, [--sign], [--no-sign] # Sign tag with GPG key.
93
+ ....
94
+
95
+ When using Milestoner, the `+--publish+` command is intended to be the only command necessary for
96
+ publishing a new release as it handles all of the steps necessary for tagging and pushing a new
97
+ milestone. Should individual steps be needed, then the `+--tag+` and `+--push+` options are
98
+ available.
99
+
100
+ === Customization
101
+
102
+ This gem can be configured via a global configuration:
103
+
104
+ ....
105
+ ~/.config/milestoner/configuration.yml
106
+ ....
107
+
108
+ It can also be configured via https://www.alchemists.io/projects/xdg[XDG] environment variables.
109
+
110
+ The default configuration is as follows:
111
+
112
+ [source,yaml]
113
+ ----
114
+ :git_commit_prefixes:
115
+ - Fixed
116
+ - Added
117
+ - Updated
118
+ - Removed
119
+ - Refactored
120
+ :git_tag_sign: false
121
+ ----
122
+
123
+ Feel free to take this default configuration, modify, and save as your own custom
124
+ `+configuration.yml+`.
125
+
126
+ The `+configuration.yml+` file can be configured as follows:
127
+
128
+ * `+git_commit_prefixes+`: Should the default prefixes not be desired, you can define Git commit
129
+ prefixes that match your style. _NOTE: Prefix order is important with the first prefix defined
130
+ taking precedence over the second and so forth._ Special characters are allowed for prefixes but
131
+ should be enclosed in quotes. To disable prefix usage completely, use an empty array. Example:
132
+ `+:git_commit_prefixes: []+`.
133
+ * `+git_tag_sign+`: Defaults to `+false+` but can be enabled by setting to `+true+`. When enabled, a
134
+ Git tag will require GPG signing for enhanced security and include a signed signature as part of the
135
+ Git tag. This is useful for public milestones where the author of a milestone can be verified to
136
+ ensure milestone integrity/security.
137
+
138
+ == Security
139
+
140
+ To securely sign your Git tags, install and configure https://www.gnupg.org[GPG]:
141
+
142
+ [source,bash]
143
+ ----
144
+ brew install gpg
145
+ gpg --gen-key
146
+ ----
147
+
148
+ When creating your GPG key, choose these settings:
149
+
150
+ * Key kind: RSA and RSA (default)
151
+ * Key size: 4096
152
+ * Key validity: 0
153
+ * Real Name: `+<your name>+`
154
+ * Email: `+<your email>+`
155
+ * Passphrase: `+<your passphrase>+`
156
+
157
+ To obtain your key, run the following and take the part after the forward slash:
158
+
159
+ ....
160
+ gpg --list-keys | grep pub
161
+ ....
162
+
163
+ Add your key to your global Git configuration in the `+[user]+` section. Example:
164
+
165
+ ....
166
+ [user]
167
+ signingkey = <your GPG key>
168
+ ....
169
+
170
+ Now, when publishing a new milestone (i.e. `+milestoner --publish <version> --sign+`), signing of
171
+ your Git tag will happen automatically. You will be prompted for the GPG Passphrase each time but
172
+ that is to be expected.
173
+
174
+ == Development
175
+
176
+ To contribute, run:
177
+
178
+ [source,bash]
179
+ ----
180
+ git clone https://github.com/bkuhlmann/milestoner.git
181
+ cd milestoner
182
+ bin/setup
183
+ ----
184
+
185
+ You can also use the IRB console for direct access to all objects:
186
+
187
+ [source,bash]
188
+ ----
189
+ bin/console
190
+ ----
191
+
192
+ == Tests
193
+
194
+ To test, run:
195
+
196
+ [source,bash]
197
+ ----
198
+ bundle exec spec
199
+ ----
200
+
201
+ == Versioning
202
+
203
+ Read link:https://semver.org[Semantic Versioning] for details. Briefly, it means:
204
+
205
+ * Major (X.y.z) - Incremented for any backwards incompatible public API changes.
206
+ * Minor (x.Y.z) - Incremented for new, backwards compatible, public API enhancements/fixes.
207
+ * Patch (x.y.Z) - Incremented for small, backwards compatible, bug fixes.
208
+
209
+ == Code of Conduct
210
+
211
+ Please note that this project is released with a link:CODE_OF_CONDUCT.adoc[CODE OF CONDUCT]. By
212
+ participating in this project you agree to abide by its terms.
213
+
214
+ == Contributions
215
+
216
+ Read link:CONTRIBUTING.adoc[CONTRIBUTING] for details.
217
+
218
+ == License
219
+
220
+ Read link:LICENSE.adoc[LICENSE] for details.
221
+
222
+ == History
223
+
224
+ Read link:CHANGES.adoc[CHANGES] for details.
225
+
226
+ == Credits
227
+
228
+ Engineered by link:https://www.alchemists.io/team/brooke_kuhlmann[Brooke Kuhlmann].
@@ -5,5 +5,5 @@ require "milestoner"
5
5
  require "milestoner/cli"
6
6
  require "milestoner/identity"
7
7
 
8
- Process.setproctitle Milestoner::Identity.version_label
8
+ Process.setproctitle Milestoner::Identity::VERSION_LABEL
9
9
  Milestoner::CLI.start
@@ -9,10 +9,10 @@ module Milestoner
9
9
  class CLI < Thor
10
10
  include Thor::Actions
11
11
 
12
- package_name Identity.version_label
12
+ package_name Identity::VERSION_LABEL
13
13
 
14
14
  def self.configuration
15
- Runcom::Config.new "#{Identity.name}/configuration.yml",
15
+ Runcom::Config.new "#{Identity::NAME}/configuration.yml",
16
16
  defaults: {
17
17
  git_commit_prefixes: %w[Fixed Added Updated Removed Refactored],
18
18
  git_tag_sign: false
@@ -100,7 +100,7 @@ module Milestoner
100
100
  desc "-v, [--version]", "Show gem version."
101
101
  map %w[-v --version] => :version
102
102
  def version
103
- say Identity.version_label
103
+ say Identity::VERSION_LABEL
104
104
  end
105
105
 
106
106
  desc "-h, [--help=COMMAND]", "Show this message or get help for a command."
@@ -29,7 +29,7 @@ module Milestoner
29
29
  end
30
30
 
31
31
  def tag_remote? tag
32
- shell("git ls-remote --tags origin #{tag}").match?(%r(.+tags\/#{tag}\Z))
32
+ shell("git ls-remote --tags origin #{tag}").match?(%r(.+tags/#{tag}\Z))
33
33
  end
34
34
 
35
35
  def remote?
@@ -3,20 +3,9 @@
3
3
  module Milestoner
4
4
  # Gem identity information.
5
5
  module Identity
6
- def self.name
7
- "milestoner"
8
- end
9
-
10
- def self.label
11
- "Milestoner"
12
- end
13
-
14
- def self.version
15
- "10.0.1"
16
- end
17
-
18
- def self.version_label
19
- "#{label} #{version}"
20
- end
6
+ NAME = "milestoner"
7
+ LABEL = "Milestoner"
8
+ VERSION = "10.4.0"
9
+ VERSION_LABEL = "#{LABEL} #{VERSION}"
21
10
  end
22
11
  end
@@ -80,7 +80,7 @@ module Milestoner
80
80
  end
81
81
 
82
82
  def git_message
83
- %(Version #{@version}.\n\n#{commit_list.join "\n"}\n\n)
83
+ %(Version #{@version}\n\n#{commit_list.join "\n"}\n\n)
84
84
  end
85
85
 
86
86
  # :reek:BooleanParameter
@@ -103,7 +103,7 @@ module Milestoner
103
103
  # :reek:BooleanParameter
104
104
  # :reek:TooManyStatements
105
105
  def git_tag sign: false
106
- message_file = Tempfile.new Identity.name
106
+ message_file = Tempfile.new Identity::NAME
107
107
  File.open(message_file, "w") { |file| file.write git_message }
108
108
  status = system "git tag #{git_options message_file, sign: sign}"
109
109
  fail Errors::Git, "Unable to create tag: #{@version}." unless status
metadata CHANGED
@@ -1,18 +1,18 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: milestoner
3
3
  version: !ruby/object:Gem::Version
4
- version: 10.0.1
4
+ version: 10.4.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Brooke Kuhlmann
8
- autorequire:
8
+ autorequire:
9
9
  bindir: bin
10
10
  cert_chain:
11
11
  - |
12
12
  -----BEGIN CERTIFICATE-----
13
- MIIC/jCCAeagAwIBAgIBAjANBgkqhkiG9w0BAQsFADAlMSMwIQYDVQQDDBpicm9v
14
- a2UvREM9YWxjaGVtaXN0cy9EQz1pbzAeFw0xOTAyMTcxNjAxMTFaFw0yMDAyMTcx
15
- NjAxMTFaMCUxIzAhBgNVBAMMGmJyb29rZS9EQz1hbGNoZW1pc3RzL0RDPWlvMIIB
13
+ MIIC/jCCAeagAwIBAgIBAzANBgkqhkiG9w0BAQsFADAlMSMwIQYDVQQDDBpicm9v
14
+ a2UvREM9YWxjaGVtaXN0cy9EQz1pbzAeFw0yMDAzMTUxNDQ1MzJaFw0yMTAzMTUx
15
+ NDQ1MzJaMCUxIzAhBgNVBAMMGmJyb29rZS9EQz1hbGNoZW1pc3RzL0RDPWlvMIIB
16
16
  IjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA6l1qpXTiomH1RfMRloyw7MiE
17
17
  xyVx/x8Yc3EupdH7uhNaTXQGyORN6aOY//1QXXMHIZ9tW74nZLhesWMSUMYy0XhB
18
18
  brs+KkurHnc9FnEJAbG7ebGvl/ncqZt72nQvaxpDxvuCBHgJAz+8i5wl6FhLw+oT
@@ -20,15 +20,15 @@ cert_chain:
20
20
  D5vkU0YlAm1r98BymuJlcQ1qdkVEI1d48ph4kcS0S0nv1RiuyVb6TCAR3Nu3VaVq
21
21
  3fPzZKJLZBx67UvXdbdicWPiUR75elI4PXpLIic3xytaF52ZJYyKZCNZJhNwfQID
22
22
  AQABozkwNzAJBgNVHRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQU0nzow9vc
23
- 2CdikiiE3fJhP/gY4ggwDQYJKoZIhvcNAQELBQADggEBANgfX7kPZkJvsbdWMvbe
24
- DUUYxRTqTUzCDpLd2p3sQvgLMKjTNSKt6CFq/kh+98b6RCgO6DqiVfxvOEq02dvf
25
- ebMN/ylQqan2FgiAs1rpP0/D4C0MlBjoDktsT+2IyLol1KmkDB20ExJ4Sf1GRNdA
26
- hpWOtcgqHtmrc7xzgB6BuyoYufrKKUlCO3ewTM4C375D2qO7hIdKuMOO3CdPMtSk
27
- OrWpbzCL+nbbXqeoqiHgZaUvcyyQrGj5sQRxMTzuMXzzQxtHnuTuKrcz16HMTX/O
28
- dKvURM+1PwDCzC5tvRwjhUJIizau6+MtkFCvJHmaAj1aZL3odcPejHj5Hxt/0CUW
29
- y84=
23
+ 2CdikiiE3fJhP/gY4ggwDQYJKoZIhvcNAQELBQADggEBAIHhAlD3po4sTYqacXaQ
24
+ XI9jIhrfMy//2PgbHWcETtlJPBeNUbbSNBABcllUHKqYsVDlSvSmss034KSWNR8F
25
+ bF1GcloicyvcCC4y6IoW4it0COAcdeaaxkxiBSgKdQFpff9REnDlIKK4uQ9lLxIo
26
+ Y2G5xubiziKZkyfWFuSr67PIjW3Bu673D1JVBArhA1qbgQmYQcy1CkGOjo+iO8Nf
27
+ 7u/QSfBHb+r/bXhKscDgPpnKwbUmvgO2+94zJG9KsrmIydlzYfsD09aXKx0t6Xy4
28
+ 2XV8FRa7/JimI07sPLC13eLY3xd/aYTi85Z782KIA4j0G8XEEWAX0ouBhlXPocZv
29
+ QWc=
30
30
  -----END CERTIFICATE-----
31
- date: 2020-01-02 00:00:00.000000000 Z
31
+ date: 2020-11-14 00:00:00.000000000 Z
32
32
  dependencies:
33
33
  - !ruby/object:Gem::Dependency
34
34
  name: runcom
@@ -36,14 +36,14 @@ dependencies:
36
36
  requirements:
37
37
  - - "~>"
38
38
  - !ruby/object:Gem::Version
39
- version: '6.0'
39
+ version: '6.4'
40
40
  type: :runtime
41
41
  prerelease: false
42
42
  version_requirements: !ruby/object:Gem::Requirement
43
43
  requirements:
44
44
  - - "~>"
45
45
  - !ruby/object:Gem::Version
46
- version: '6.0'
46
+ version: '6.4'
47
47
  - !ruby/object:Gem::Dependency
48
48
  name: thor
49
49
  requirement: !ruby/object:Gem::Requirement
@@ -64,70 +64,56 @@ dependencies:
64
64
  requirements:
65
65
  - - "~>"
66
66
  - !ruby/object:Gem::Version
67
- version: '8.0'
67
+ version: '8.4'
68
68
  type: :runtime
69
69
  prerelease: false
70
70
  version_requirements: !ruby/object:Gem::Requirement
71
71
  requirements:
72
72
  - - "~>"
73
73
  - !ruby/object:Gem::Version
74
- version: '8.0'
74
+ version: '8.4'
75
75
  - !ruby/object:Gem::Dependency
76
76
  name: bundler-audit
77
77
  requirement: !ruby/object:Gem::Requirement
78
78
  requirements:
79
79
  - - "~>"
80
80
  - !ruby/object:Gem::Version
81
- version: '0.6'
81
+ version: '0.7'
82
82
  type: :development
83
83
  prerelease: false
84
84
  version_requirements: !ruby/object:Gem::Requirement
85
85
  requirements:
86
86
  - - "~>"
87
87
  - !ruby/object:Gem::Version
88
- version: '0.6'
88
+ version: '0.7'
89
89
  - !ruby/object:Gem::Dependency
90
- name: climate_control
90
+ name: bundler-leak
91
91
  requirement: !ruby/object:Gem::Requirement
92
92
  requirements:
93
93
  - - "~>"
94
94
  - !ruby/object:Gem::Version
95
- version: '0.1'
95
+ version: '0.2'
96
96
  type: :development
97
97
  prerelease: false
98
98
  version_requirements: !ruby/object:Gem::Requirement
99
99
  requirements:
100
100
  - - "~>"
101
101
  - !ruby/object:Gem::Version
102
- version: '0.1'
102
+ version: '0.2'
103
103
  - !ruby/object:Gem::Dependency
104
- name: gemsmith
105
- requirement: !ruby/object:Gem::Requirement
106
- requirements:
107
- - - "~>"
108
- - !ruby/object:Gem::Version
109
- version: '14.0'
110
- type: :development
111
- prerelease: false
112
- version_requirements: !ruby/object:Gem::Requirement
113
- requirements:
114
- - - "~>"
115
- - !ruby/object:Gem::Version
116
- version: '14.0'
117
- - !ruby/object:Gem::Dependency
118
- name: git-cop
104
+ name: climate_control
119
105
  requirement: !ruby/object:Gem::Requirement
120
106
  requirements:
121
107
  - - "~>"
122
108
  - !ruby/object:Gem::Version
123
- version: '4.0'
109
+ version: '0.1'
124
110
  type: :development
125
111
  prerelease: false
126
112
  version_requirements: !ruby/object:Gem::Requirement
127
113
  requirements:
128
114
  - - "~>"
129
115
  - !ruby/object:Gem::Version
130
- version: '4.0'
116
+ version: '0.1'
131
117
  - !ruby/object:Gem::Dependency
132
118
  name: guard-rspec
133
119
  requirement: !ruby/object:Gem::Requirement
@@ -148,28 +134,28 @@ dependencies:
148
134
  requirements:
149
135
  - - "~>"
150
136
  - !ruby/object:Gem::Version
151
- version: '0.12'
137
+ version: '0.13'
152
138
  type: :development
153
139
  prerelease: false
154
140
  version_requirements: !ruby/object:Gem::Requirement
155
141
  requirements:
156
142
  - - "~>"
157
143
  - !ruby/object:Gem::Version
158
- version: '0.12'
144
+ version: '0.13'
159
145
  - !ruby/object:Gem::Dependency
160
146
  name: pry-byebug
161
147
  requirement: !ruby/object:Gem::Requirement
162
148
  requirements:
163
149
  - - "~>"
164
150
  - !ruby/object:Gem::Version
165
- version: '3.7'
151
+ version: '3.9'
166
152
  type: :development
167
153
  prerelease: false
168
154
  version_requirements: !ruby/object:Gem::Requirement
169
155
  requirements:
170
156
  - - "~>"
171
157
  - !ruby/object:Gem::Version
172
- version: '3.7'
158
+ version: '3.9'
173
159
  - !ruby/object:Gem::Dependency
174
160
  name: rake
175
161
  requirement: !ruby/object:Gem::Requirement
@@ -190,56 +176,56 @@ dependencies:
190
176
  requirements:
191
177
  - - "~>"
192
178
  - !ruby/object:Gem::Version
193
- version: '5.4'
179
+ version: '6.0'
194
180
  type: :development
195
181
  prerelease: false
196
182
  version_requirements: !ruby/object:Gem::Requirement
197
183
  requirements:
198
184
  - - "~>"
199
185
  - !ruby/object:Gem::Version
200
- version: '5.4'
186
+ version: '6.0'
201
187
  - !ruby/object:Gem::Dependency
202
188
  name: rspec
203
189
  requirement: !ruby/object:Gem::Requirement
204
190
  requirements:
205
191
  - - "~>"
206
192
  - !ruby/object:Gem::Version
207
- version: '3.9'
193
+ version: '3.10'
208
194
  type: :development
209
195
  prerelease: false
210
196
  version_requirements: !ruby/object:Gem::Requirement
211
197
  requirements:
212
198
  - - "~>"
213
199
  - !ruby/object:Gem::Version
214
- version: '3.9'
200
+ version: '3.10'
215
201
  - !ruby/object:Gem::Dependency
216
202
  name: rubocop
217
203
  requirement: !ruby/object:Gem::Requirement
218
204
  requirements:
219
205
  - - "~>"
220
206
  - !ruby/object:Gem::Version
221
- version: '0.78'
207
+ version: '1.3'
222
208
  type: :development
223
209
  prerelease: false
224
210
  version_requirements: !ruby/object:Gem::Requirement
225
211
  requirements:
226
212
  - - "~>"
227
213
  - !ruby/object:Gem::Version
228
- version: '0.78'
214
+ version: '1.3'
229
215
  - !ruby/object:Gem::Dependency
230
216
  name: rubocop-performance
231
217
  requirement: !ruby/object:Gem::Requirement
232
218
  requirements:
233
219
  - - "~>"
234
220
  - !ruby/object:Gem::Version
235
- version: '1.5'
221
+ version: '1.8'
236
222
  type: :development
237
223
  prerelease: false
238
224
  version_requirements: !ruby/object:Gem::Requirement
239
225
  requirements:
240
226
  - - "~>"
241
227
  - !ruby/object:Gem::Version
242
- version: '1.5'
228
+ version: '1.8'
243
229
  - !ruby/object:Gem::Dependency
244
230
  name: rubocop-rake
245
231
  requirement: !ruby/object:Gem::Requirement
@@ -260,40 +246,40 @@ dependencies:
260
246
  requirements:
261
247
  - - "~>"
262
248
  - !ruby/object:Gem::Version
263
- version: '1.37'
249
+ version: '2.0'
264
250
  type: :development
265
251
  prerelease: false
266
252
  version_requirements: !ruby/object:Gem::Requirement
267
253
  requirements:
268
254
  - - "~>"
269
255
  - !ruby/object:Gem::Version
270
- version: '1.37'
256
+ version: '2.0'
271
257
  - !ruby/object:Gem::Dependency
272
258
  name: simplecov
273
259
  requirement: !ruby/object:Gem::Requirement
274
260
  requirements:
275
261
  - - "~>"
276
262
  - !ruby/object:Gem::Version
277
- version: '0.17'
263
+ version: '0.19'
278
264
  type: :development
279
265
  prerelease: false
280
266
  version_requirements: !ruby/object:Gem::Requirement
281
267
  requirements:
282
268
  - - "~>"
283
269
  - !ruby/object:Gem::Version
284
- version: '0.17'
285
- description:
270
+ version: '0.19'
271
+ description:
286
272
  email:
287
273
  - brooke@alchemists.io
288
274
  executables:
289
275
  - milestoner
290
276
  extensions: []
291
277
  extra_rdoc_files:
292
- - README.md
293
- - LICENSE.md
278
+ - README.adoc
279
+ - LICENSE.adoc
294
280
  files:
295
- - LICENSE.md
296
- - README.md
281
+ - LICENSE.adoc
282
+ - README.adoc
297
283
  - bin/milestoner
298
284
  - lib/milestoner.rb
299
285
  - lib/milestoner/cli.rb
@@ -306,14 +292,15 @@ files:
306
292
  - lib/milestoner/publisher.rb
307
293
  - lib/milestoner/pusher.rb
308
294
  - lib/milestoner/tagger.rb
309
- homepage: https://github.com/bkuhlmann/milestoner
295
+ homepage: https://www.alchemists.io/projects/milestoner
310
296
  licenses:
311
297
  - Apache-2.0
312
298
  metadata:
313
- source_code_uri: https://github.com/bkuhlmann/milestoner
314
- changelog_uri: https://github.com/bkuhlmann/milestoner/blob/master/CHANGES.md
315
299
  bug_tracker_uri: https://github.com/bkuhlmann/milestoner/issues
316
- post_install_message:
300
+ changelog_uri: https://www.alchemists.io/projects/milestoner/changes.html
301
+ documentation_uri: https://www.alchemists.io/projects/milestoner
302
+ source_code_uri: https://github.com/bkuhlmann/milestoner
303
+ post_install_message:
317
304
  rdoc_options: []
318
305
  require_paths:
319
306
  - lib
@@ -328,8 +315,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
328
315
  - !ruby/object:Gem::Version
329
316
  version: '0'
330
317
  requirements: []
331
- rubygems_version: 3.1.2
332
- signing_key:
318
+ rubygems_version: 3.1.4
319
+ signing_key:
333
320
  specification_version: 4
334
321
  summary: A command line interface for crafting Git repository milestones.
335
322
  test_files: []
metadata.gz.sig CHANGED
Binary file
data/README.md DELETED
@@ -1,204 +0,0 @@
1
- <p align="center">
2
- <img src="milestoner.png" alt="Milestoner Icon"/>
3
- </p>
4
-
5
- # Milestoner
6
-
7
- [![Gem Version](https://badge.fury.io/rb/milestoner.svg)](http://badge.fury.io/rb/milestoner)
8
- [![Code Climate Maintainability](https://api.codeclimate.com/v1/badges/4cf2547433410a9c7150/maintainability)](https://codeclimate.com/github/bkuhlmann/milestoner/maintainability)
9
- [![Code Climate Test Coverage](https://api.codeclimate.com/v1/badges/4cf2547433410a9c7150/test_coverage)](https://codeclimate.com/github/bkuhlmann/milestoner/test_coverage)
10
- [![Circle CI Status](https://circleci.com/gh/bkuhlmann/milestoner.svg?style=svg)](https://circleci.com/gh/bkuhlmann/milestoner)
11
-
12
- A command line interface for crafting Git repository milestones (also known as *tags*).
13
-
14
- <!-- Tocer[start]: Auto-generated, don't remove. -->
15
-
16
- ## Table of Contents
17
-
18
- - [Features](#features)
19
- - [Screencasts](#screencasts)
20
- - [Requirements](#requirements)
21
- - [Setup](#setup)
22
- - [Usage](#usage)
23
- - [Command Line Interface (CLI)](#command-line-interface-cli)
24
- - [Customization](#customization)
25
- - [Security](#security)
26
- - [Tests](#tests)
27
- - [Versioning](#versioning)
28
- - [Code of Conduct](#code-of-conduct)
29
- - [Contributions](#contributions)
30
- - [License](#license)
31
- - [History](#history)
32
- - [Credits](#credits)
33
-
34
- <!-- Tocer[finish]: Auto-generated, don't remove. -->
35
-
36
- ## Features
37
-
38
- - Uses [Versionaire](https://github.com/bkuhlmann/versionaire) for
39
- [Semantic Versioning](https://semver.org).
40
- - Format: `<major>.<minor>.<maintenance>`.
41
- - Example: `0.1.0`.
42
- - Ensures Git commits since last tag (or initialization of repository) are included.
43
- - Ensures Git commit messages are grouped by prefix, in order defined. For more details, see [Git
44
- Cop Subject Prefix](https://github.com/bkuhlmann/git-cop#commit-subject-prefix) for details.
45
- Defaults (can be customized):
46
- - Fixed
47
- - Added
48
- - Updated
49
- - Removed
50
- - Refactored
51
- - Ensures Git commit merge messages are excluded.
52
- - Ensures Git commit messages are alphabetically sorted.
53
- - Ensures duplicate Git commit messages are removed (if any).
54
- - Ensures Git commit messages are sanitized by removing extra spaces and `[ci skip]` text within
55
- each Git tag message.
56
- - Provides optional security for signing Git tags with [GnuPG](https://www.gnupg.org) signing key.
57
-
58
- ## Screencasts
59
-
60
- [![asciicast](https://asciinema.org/a/278645.svg)](https://asciinema.org/a/278645)
61
-
62
- ## Requirements
63
-
64
- 1. A UNIX-based system.
65
- 1. [Ruby 2.7.x](https://www.ruby-lang.org).
66
- 1. [GnuPG](https://www.gnupg.org).
67
-
68
- ## Setup
69
-
70
- Type the following to install:
71
-
72
- gem install milestoner
73
-
74
- ## Usage
75
-
76
- ### Command Line Interface (CLI)
77
-
78
- From the command line, type: `milestoner help`
79
-
80
- milestoner -C, [--commits] # Show commits for next milestone.
81
- milestoner -P, [--publish=VERSION] # Tag and push milestone to remote repository.
82
- milestoner -c, [--config] # Manage gem configuration.
83
- milestoner -h, [--help=COMMAND] # Show this message or get help for a command.
84
- milestoner -p, [--push=VERSION] # Push local tag to remote repository.
85
- milestoner -t, [--tag=VERSION] # Tag local repository with new version.
86
- milestoner -v, [--version] # Show gem version.
87
-
88
- For config options, type: `milestoner help --config`
89
-
90
- -e, [--edit], [--no-edit] # Edit gem configuration.
91
- -i, [--info], [--no-info] # Print gem configuration info.
92
-
93
- For tag options, type: `milestoner help --tag`
94
-
95
- -s, [--sign], [--no-sign] # Sign tag with GPG key.
96
-
97
- For publish options, type: `milestoner help --publish`
98
-
99
- -s, [--sign], [--no-sign] # Sign tag with GPG key.
100
-
101
- When using Milestoner, the `--publish` command is intended to be the only command necessary for
102
- publishing a new release as it handles all of the steps necessary for tagging and pushing a new
103
- milestone. Should individual steps be needed, then the `--tag` and `--push` options are available.
104
-
105
- ### Customization
106
-
107
- This gem can be configured via a global configuration:
108
-
109
- ~/.config/milestoner/configuration.yml
110
-
111
-
112
- It can also be configured via [XDG](https://github.com/bkuhlmann/xdg) environment variables.
113
-
114
- The default configuration is as follows:
115
-
116
- :git_commit_prefixes:
117
- - Fixed
118
- - Added
119
- - Updated
120
- - Removed
121
- - Refactored
122
- :git_tag_sign: false
123
-
124
- Feel free to take this default configuration, modify, and save as your own custom
125
- `configuration.yml`.
126
-
127
- The `configuration.yml` file can be configured as follows:
128
-
129
- - `git_commit_prefixes`: Should the default prefixes not be desired, you can define Git commit
130
- prefixes that match your style. *NOTE: Prefix order is important with the first prefix defined
131
- taking precedence over the second and so forth.* Special characters are allowed for prefixes but
132
- should be enclosed in quotes. To disable prefix usage completely, use an empty array. Example:
133
- `:git_commit_prefixes: []`.
134
- - `git_tag_sign`: Defaults to `false` but can be enabled by setting to `true`. When enabled, a Git
135
- tag will require GPG signing for enhanced security and include a signed signature as part of the
136
- Git tag. This is useful for public milestones where the author of a milestone can be verified to
137
- ensure milestone integrity/security.
138
-
139
- ## Security
140
-
141
- To securely sign your Git tags, install and configure [GPG](https://www.gnupg.org):
142
-
143
- brew install gpg
144
- gpg --gen-key
145
-
146
- When creating your GPG key, choose these settings:
147
-
148
- - Key kind: RSA and RSA (default)
149
- - Key size: 4096
150
- - Key validity: 0
151
- - Real Name: `<your name>`
152
- - Email: `<your email>`
153
- - Passphrase: `<your passphrase>`
154
-
155
- To obtain your key, run the following and take the part after the forward slash:
156
-
157
- gpg --list-keys | grep pub
158
-
159
- Add your key to your global Git configuration in the `[user]` section. Example:
160
-
161
- [user]
162
- signingkey = <your GPG key>
163
-
164
- Now, when publishing a new milestone (i.e. `milestoner --publish <version> --sign`), signing of your
165
- Git tag will happen automatically. You will be prompted for the GPG Passphrase each time but that is
166
- to be expected.
167
-
168
- ## Tests
169
-
170
- To test, run:
171
-
172
- bundle exec spec
173
-
174
- ## Versioning
175
-
176
- Read [Semantic Versioning](https://semver.org) for details. Briefly, it means:
177
-
178
- - Major (X.y.z) - Incremented for any backwards incompatible public API changes.
179
- - Minor (x.Y.z) - Incremented for new, backwards compatible, public API enhancements/fixes.
180
- - Patch (x.y.Z) - Incremented for small, backwards compatible, bug fixes.
181
-
182
- ## Code of Conduct
183
-
184
- Please note that this project is released with a [CODE OF CONDUCT](CODE_OF_CONDUCT.md). By
185
- participating in this project you agree to abide by its terms.
186
-
187
- ## Contributions
188
-
189
- Read [CONTRIBUTING](CONTRIBUTING.md) for details.
190
-
191
- ## License
192
-
193
- Copyright 2015 [Alchemists](https://www.alchemists.io).
194
- Read [LICENSE](LICENSE.md) for details.
195
-
196
- ## History
197
-
198
- Read [CHANGES](CHANGES.md) for details.
199
- Built with [Gemsmith](https://github.com/bkuhlmann/gemsmith).
200
-
201
- ## Credits
202
-
203
- Developed by [Brooke Kuhlmann](https://www.alchemists.io) at
204
- [Alchemists](https://www.alchemists.io).