buildar 3.0.0.1 → 3.0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: d66f1821b6fed8ae765cb0863bcc94d2e1d26e4f
-  data.tar.gz: 9abd4f6724a248baf196221945d443f630aa32b7
+SHA256:
+  metadata.gz: 833e11b9319991ccfebdaa2e20555b9fb4f2fdfa6bc40210897ed98282c67f40
+  data.tar.gz: 5527c38a72f392b139a1fa3a8cd865f541e642be6bf5feca512f593229d94d14
 SHA512:
-  metadata.gz: 7b675e519283d5a47c67a87e8709961f590febc2e64dad02e4406fc3ef29413cc99ecf57e8fb09b08cc9f84b9b4579fe9ffa880fd29cec0c695c287340fbe20e
-  data.tar.gz: 4ffdd5035cbf607a5b719e6c8f551575a5c9cf09da3892d48c0a92bcfb4e6d4c8ef5f5e6c12d90debde397b0bd5765342c7af60528c26a2e65cabae8824977bb
+  metadata.gz: ec66531a9d2ac8e5d0b9af9bbf8f1f3b27817c8c84af8210c049ed67f500313908cd3326555a146b8e193ddc145527a132de0062c1889cf2ffd16701573ef2be
+  data.tar.gz: bb1b780d9c9245cc7a5ccafb9802e539ef5e5c045e35e6463c631be477239ddd1f22c25b33ca267a710d687060842d07112c979993f1aa0c34b2b7ec8a11932a

data/README.md

@@ -2,8 +2,8 @@
 [![Dependency Status](https://gemnasium.com/rickhull/buildar.svg)](https://gemnasium.com/rickhull/buildar)
 [![Security Status](https://hakiri.io/github/rickhull/buildar/master.svg)](https://hakiri.io/github/rickhull/buildar/master/shield)
 
-Buildar
-=======
+# Buildar
+
 Buildar provides a set of rake tasks to help automate releasing your gem:
 * Versioning
 * Building / Packaging
@@ -11,45 +11,49 @@ Buildar provides a set of rake tasks to help automate releasing your gem:
 
 With a set of options to integrate with your current project.
 
-Rake tasks
-----------
-Core
-*     `release` - `build` `publish` `tag`
-*       `build` - `pre_build` gem build a pkg/.gem
-* `gem_package` - `pre_build` Gem::PackageTask builds a pkg/.gem
-*     `publish` - `built` gem push
-*     `buildar` - config check
-
-Aux
-*   `pre_build` - invoke `test` and `bump:build` conditionally
-*       `built` - `build` conditionally
-*     `install` - `built` gem install .gem
-* `install_new` - `build` install built .gem
-*     `version` - show the current project version
-
-With git integration
-*     `tag` - `message` git tag current version, push to origin
-* `message` - capture a message from ENV['message'] or prompt STDIN
-
-With version file integration
-* `bump:build` - increment the 4th version number (1.2.3.4 -> 1.2.3.5)
-* `bump:patch` - increment the 3rd version number (1.2.3.4 -> 1.2.4.0)
-* `bump:minor` - increment the 2nd version number (1.2.3.4 -> 1.3.0.0)
-* `bump:major` - increment the 1st version number (1.2.3.4 -> 2.0.0.0)
-* `release:patch` - `bump:patch` `release`
-* `release:minor` - `bump:minor` `release`
-* `release:major` - `bump:major` `release`
+## Rake tasks
+
+### Core
+
+* **`release`**     - *`build`*, *`publish`*, *`tag`*
+* **`build`**       - *`prebuild`*, `gem build`
+* **`gem_package`** - *`pre_build`*, build with `Gem::PackageTask`
+* **`publish`**     - *`built`*, `gem push`
+* **`buildar`**     - config check
+
+### Aux
+
+* **`pre_build`** - invoke *`test`* and *`bump:build`* conditionally
+* **`built`**     - invoke *`build`* conditionally
+* **`install`**   - *`built`*, `gem install`
+* **`install_new`** - *`build`*, `gem install`
+* **`version`**     - show the current project version
+
+### With git integration
+
+* **`tag`**     - *`message`*, `git tag` current version, `git push` to origin
+* **`message`** - capture a message from `ENV['message']` or prompt STDIN
+
+### With version file integration
+
+* **`bump:build`** - increment the 4th version number (1.2.3.4 -> 1.2.3.5)
+* **`bump:patch`** - increment the 3rd version number (1.2.3.4 -> 1.2.4.0)
+* **`bump:minor`** - increment the 2nd version number (1.2.3.4 -> 1.3.0.0)
+* **`bump:major`** - increment the 1st version number (1.2.3.4 -> 2.0.0.0)
+* **`release:patch`** - *`bump:patch`*, *`release`*
+* **`release:minor`** - *`bump:minor`*, *`release`*
+* **`release:major`** - *`bump:major`*, *`release`*
 
 [Just show me the tasks](https://github.com/rickhull/buildar/blob/master/lib/buildar.rb#L73)
 
-Install
--------
+## Install
+
 ```shell
 $ gem install buildar     # sudo as necessary
 ```
 
-Usage
------
+## Usage
+
 Edit your Rakefile.  Add to the top:
 
 ```ruby
@@ -60,10 +64,15 @@ Buildar.new do |b|
 end
 ```
 
-That is basically the minimal Rakefile needed for Buildar to operate, assuming you have a valid gemspec file named `example.gemspec`.
+That is basically the minimal Rakefile needed for Buildar to operate, assuming
+you have a valid gemspec file named `example.gemspec`.
+
+
+Let's try a Buildar task, **`release`**:
 
 ```
 $ rake release
+
 gem build example.gemspec
 WARNING:  no email specified
 Successfully built RubyGem
@@ -76,8 +85,8 @@ Pushing gem to https://rubygems.org...
 Successfully registered gem: example (1.2.3)
 ```
 
-Without a gemspec file
-----------------------
+### Without a gemspec file
+
 ```ruby
 Buildar.new do |b|
   b.gemspec.name = 'example'
@@ -92,24 +101,30 @@ end
 
 From [examples/no_gemspec_file.rb](https://github.com/rickhull/buildar/blob/master/examples/no_gemspec_file.rb)
 
-Dogfood
--------
+### Dogfood
+
 Here is Buildar's [Rakefile](https://github.com/rickhull/buildar/blob/master/Rakefile):
 
 ```ruby
-require 'buildar'
+begin
+  require 'buildar'
 
-Buildar.new do |b|
-  b.gemspec_file = 'buildar.gemspec'
-  b.version_file = 'VERSION'
-  b.use_git      = true
+  Buildar.new do |b|
+    b.gemspec_file = 'buildar.gemspec'
+    b.version_file = 'VERSION'
+    b.use_git      = true
+  end
+
+rescue LoadError => e
+  warn "buildar failed to load: #{e}"
 end
 ```
 
-With `b.version_file` and `b.use_git`
+Let's try **`release:patch`**, this time with `b.version_file` and `b.use_git`:
 
 ```
 $ rake release:patch message="added version task; demonstrating Usage"
+
 bumping 2.0.0.9 to 2.0.1.0
 git commit VERSION -m "Buildar version:bump_patch to 2.0.1.0"
 [master 5df1ff8] Buildar version:bump_patch to 2.0.1.0
@@ -134,28 +149,39 @@ To https://github.com/rickhull/buildar.git
 * [new tag]         v2.0.1.1 -> v2.0.1.1
 ```
 
-Use a VERSION file
-------------------
+### Use a VERSION file
+
 * Buildar can manage your version numbers with `b.version_file`
-* The version only matters in the context of a release.  For internal development, git SHAs vastly outclass version numbers.
-* "The right version number" for the next release is a function of the current release version and the magnitude (or breakiness) of the change
+* The version only matters in the context of a release.  For internal
+  development, git SHAs vastly outclass version numbers.
+* "The right version number" for the next release is a function of the current
+  release version and the magnitude (or breakiness) of the change
 * http://guides.rubygems.org/patterns/#semantic-versioning
 * http://semver.org/
 * Automate everything
 
 The [VERSION](https://github.com/rickhull/buildar/blob/master/VERSION) file at your project root should look something like
+
 ```
 1.2.3.4
 ```
 
-Buildar will be able to `bump:major` `bump:minor` `bump:patch` and `bump:build`.  This helps with a repeatable, identifiable builds: `build` invokes `bump:build` etc.
+Buildar will be able to **`bump:major`**, **`bump:minor`**, **`bump:patch`**,
+and **`bump:build`**.  This helps with a repeatable, identifiable builds:
+**`build`** invokes **`bump:build`** etc.
 
-Every build bumps the build number.  Since the build operates off of your potentially dirty working copy, and not some commit SHA, there is no guarantee that things haven't changed between builds, even if "nothing is supposed to have changed".  This guarantees that you can't have 2 builds floating around with the same version number but different contents.
+Every build bumps the build number.  Since the build operates off of your
+potentially dirty working copy, and not some commit SHA, there is no guarantee
+that things haven't changed between builds, even if "nothing is supposed to
+have changed".  This guarantees that you can't have 2 builds floating around
+with the same version number but different contents.
 
-Typically you'll want to let Buildar manage the build number, and you manage the major, minor, and patch numbers with:
-* `release:major` - `bump:major`
-* `release:minor` - `bump:minor`
-* `release:patch` - `bump:patch`
+Typically you'll want to let Buildar manage the build number, and you manage
+the major, minor, and patch numbers with:
+
+* **`release:major`** - *`bump:major`*
+* **`release:minor`** - *`bump:minor`*
+* **`release:patch`** - *`bump:patch`*
 
 To make your app or lib aware of its version via this file, simply:
 
@@ -165,15 +191,16 @@ To make your app or lib aware of its version via this file, simply:
 module Foo
   def self.version
     file = File.expand_path('../../VERSION', __FILE__)
-	File.read(file).chomp
+    File.read(file).chomp
   end
 end
 ```
 
-`b.version_file` defaults to nil, so if you don't set it, you'll have to keep your gemspec's version attribute updated.
+`b.version_file` defaults to nil, so if you don't set it, you'll have to keep
+your gemspec's version attribute updated.
+
+### Gemspec file tricks
 
-Gemspec file tricks
--------------------
 With
 ```ruby
 Buildar.new do |b|
@@ -181,18 +208,18 @@ Buildar.new do |b|
   b.version_file = 'VERSION'
 ```
 
-You'll need to keep your gemspec file in synch with the version_file.  Here's [how Buildar does it](https://github.com/rickhull/buildar/blob/master/buildar.gemspec):
+You'll need to keep your gemspec file in synch with `b.version_file`.
+Here's [how Buildar does it](https://github.com/rickhull/buildar/blob/master/buildar.gemspec):
+
 ```ruby
 # Gem::Specification.new do |s|
   # ...
-  # dynamic setup
-  this_dir = File.expand_path('..', __FILE__)
-  version_file = File.join(this_dir, 'VERSION')
-  manifest_file = File.join(this_dir, 'MANIFEST.txt')
-
-  # dynamic assignments
-  s.version  = File.read(version_file).chomp
-  s.files = File.readlines(manifest_file).map { |f| f.chomp }
+  s.version  = File.read(File.join(__dir__, 'VERSION')).chomp
+  s.files =
+    File.readlines(File.join(__dir__, 'MANIFEST.txt')).map { |f| f.chomp }
 ```
 
-I also like to maintain a [MANIFEST.txt](https://github.com/rickhull/buildar/blob/master/MANIFEST.txt) -- the canonical list of files belonging to the project -- outside of the gemspec.
+Buildar maintains a
+[MANIFEST.txt](https://github.com/rickhull/buildar/blob/master/MANIFEST.txt)
+-- the canonical list of files belonging to the project --
+outside of the gemspec.

data/Rakefile

@@ -1,3 +1,11 @@
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.test_files = FileList['test/**/*.rb']
+end
+
+task default: :test
+
 begin
   require 'buildar'
 
@@ -10,15 +18,3 @@ begin
 rescue LoadError => e
   warn "buildar failed to load: #{e}"
 end
-
-begin
-  require 'rake/testtask'
-
-  Rake::TestTask.new do |t|
-    t.test_files = FileList['test/**/*.rb']
-  end
-
-  task default: :test
-rescue Exception => e
-  warn "rake/testtask error: #{e}"
-end

data/VERSION

@@ -1 +1 @@
-3.0.0.1
+3.0.2.1

data/buildar.gemspec

@@ -5,10 +5,9 @@ Gem::Specification.new do |s|
   s.author   = 'Rick Hull'
   s.homepage = 'https://github.com/rickhull/buildar'
   s.license  = 'MIT'
-  s.has_rdoc = true
   s.description = 'Buildar helps automate the release process with versioning, building, packaging, and publishing.  Optional git integration.'
 
-  s.required_ruby_version = "~> 2"
+  s.required_ruby_version = ">= 2"
 
   # dynamic assignments
   s.version  = File.read(File.join(__dir__, 'VERSION')).chomp

data/lib/buildar.rb

@@ -4,8 +4,7 @@ require 'rake/tasklib'
 
 class Buildar < Rake::TaskLib
   def self.version
-    file = File.expand_path('../../VERSION', __FILE__)
-    File.read(file).chomp
+    File.read(File.join(__dir__, '..', 'VERSION')).chomp
   end
 
   # e.g. bump(:minor, '1.2.3') #=> '1.3.0'
@@ -160,7 +159,7 @@ EOF
 
     # desc "used internally; make sure we have .gem for the current version"
     task :built do
-      Rake::Task[:build].invoke unless File.exists? self.gem_file
+      Rake::Task[:build].invoke unless File.exist? self.gem_file
     end
 
     desc "publish the current version to rubygems.org"

metadata

@@ -1,18 +1,18 @@
 --- !ruby/object:Gem::Specification
 name: buildar
 version: !ruby/object:Gem::Version
-  version: 3.0.0.1
+  version: 3.0.2.1
 platform: ruby
 authors:
 - Rick Hull
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2017-09-27 00:00:00.000000000 Z
+date: 1980-01-01 00:00:00.000000000 Z
 dependencies: []
 description: Buildar helps automate the release process with versioning, building,
   packaging, and publishing.  Optional git integration.
-email: 
+email:
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -27,13 +27,13 @@ homepage: https://github.com/rickhull/buildar
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - "~>"
+  - - ">="
     - !ruby/object:Gem::Version
       version: '2'
 required_rubygems_version: !ruby/object:Gem::Requirement
@@ -42,9 +42,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.8
-signing_key: 
+rubygems_version: 3.4.4
+signing_key:
 specification_version: 4
 summary: Buildar adds rake tasks to assist with gem publishing
 test_files: []