miriamtech-gocd 0.2.3 → 0.2.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9167059bad42ed3079ee60929fa27b6c74dee291189161e8e408f7903669c6a6
-  data.tar.gz: ae532c28d50f90ea7c67314b7cfeb53481b2a960735f177bbea526f7801937c5
+  metadata.gz: 82b62a9341f4185b558cd884679d276a927590e9bf21441d5d48ba3a76008263
+  data.tar.gz: c65cf31ead5aeb01ac0203e9868e6567df69b276ebab508ecd4cf22cb510f5be
 SHA512:
-  metadata.gz: 8bf5c93d5ecbc16e17e7fa78baa33d760b4426f418345291d0e28629934eea404a04d1c46eaa42bde991d6770dc63730fd53e6c9d97386ba4a537359b09bca70
-  data.tar.gz: 917470546a2343695683a26db8639e0d71ec34435a3c1cd58a60891d8e5b815d2709ecad09deaa4673d7ed7bf21ff1e1a12c3b9bf8a7cce7d719898a227f5e4a
+  metadata.gz: 29cd1f5d5eb989ab00257bbd0723c1467ac37e4bede60cf6d5f44b4333dd993f1cc0aa03ec5db834729426c890cb694065d91abf1c7ec7ad6ce740ed5ff49f0a
+  data.tar.gz: b3f67cbbf2ccafab37e63315bf5d589b55a8d9df92ead65cc53cfb87a4e1ab9028067f61d40fe288ad222ef0a45d849ad2feb1a258307c968a999be22da98dcb

data/.gitignore

@@ -6,4 +6,4 @@
 /pkg/
 /spec/reports/
 /tmp/
-Gemfile.lock
+/vendor/bundle

data/.rubocop.yml

@@ -0,0 +1,70 @@
+require:
+  - rubocop-minitest
+
+AllCops:
+  Exclude:
+    - '**/bin/*'
+    - '**/schema.rb'
+    - 'node_modules/**/*'
+    - 'vendor/bundle/**/*'
+
+Layout/EmptyLineAfterGuardClause:
+  Enabled: false
+
+Layout/MultilineArrayLineBreaks:
+  Enabled: true
+
+Layout/MultilineHashKeyLineBreaks:
+  Enabled: true
+
+Layout/MultilineMethodArgumentLineBreaks:
+  Enabled: true
+
+Lint/AssignmentInCondition:
+  Enabled: false
+
+Lint/UnusedBlockArgument:
+  AutoCorrect: false
+
+Lint/UnusedMethodArgument:
+  AutoCorrect: false
+
+Metrics/AbcSize:
+  Enabled: false
+
+Metrics/CyclomaticComplexity:
+  Enabled: false
+
+Metrics/ClassLength:
+  Exclude:
+    - test/**/*
+
+Metrics/MethodLength:
+  Exclude:
+    - test/**/*
+
+Naming/HeredocDelimiterNaming:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
+
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+Style/HashSyntax:
+  Exclude:
+    - Rakefile
+
+Style/SymbolArray:
+  Exclude:
+    - Rakefile
+
+Style/TrailingCommaInArguments:
+  EnforcedStyleForMultiline: comma
+
+Style/TrailingCommaInArrayLiteral:
+  EnforcedStyleForMultiline: comma
+
+Style/TrailingCommaInHashLiteral:
+  EnforcedStyleForMultiline: comma

data/Gemfile

@@ -1,4 +1,4 @@
-source "https://rubygems.org"
+source 'https://rubygems.org'
 
 # Specify your gem's dependencies in miriamtech-gocd.gemspec
 gemspec

data/Gemfile.lock

@@ -0,0 +1,56 @@
+PATH
+  remote: .
+  specs:
+    miriamtech-gocd (0.2.8)
+      rake (>= 10.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.2)
+    diff-lcs (1.4.4)
+    minitest (5.11.3)
+    parallel (1.20.1)
+    parser (3.0.1.0)
+      ast (~> 2.4.1)
+    rainbow (3.0.0)
+    rake (13.0.3)
+    regexp_parser (2.1.1)
+    rexml (3.2.5)
+    rspec-expectations (3.9.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-mocks (3.9.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-support (3.9.3)
+    rubocop (1.13.0)
+      parallel (~> 1.10)
+      parser (>= 3.0.0.0)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml
+      rubocop-ast (>= 1.2.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 3.0)
+    rubocop-ast (1.4.1)
+      parser (>= 2.7.1.5)
+    rubocop-minitest (0.11.1)
+      rubocop (>= 0.90, < 2.0)
+    ruby-progressbar (1.11.0)
+    unicode-display_width (2.0.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 2.0)
+  minitest (~> 5.0)
+  miriamtech-gocd!
+  rspec-expectations
+  rspec-mocks
+  rubocop
+  rubocop-minitest
+
+BUNDLED WITH
+   2.0.2

data/Rakefile

@@ -1,10 +1,10 @@
-require "bundler/gem_tasks"
-require "rake/testtask"
+require 'bundler/gem_tasks'
+require 'rake/testtask'
 
 Rake::TestTask.new(:test) do |t|
-  t.libs << "test"
-  t.libs << "lib"
-  t.test_files = FileList["test/**/*_test.rb"]
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/**/*_test.rb']
 end
 
 task :default => :test

data/bin/rubocop

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby2.5
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rubocop' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rubocop", "rubocop")

data/lib/miriamtech/gocd.rb

@@ -1,2 +1,2 @@
-require "miriamtech/gocd/version"
-require "miriamtech/gocd/dsl"
+require 'miriamtech/gocd/version'
+require 'miriamtech/gocd/dsl'

data/lib/miriamtech/gocd/artifacts.rb

@@ -1,7 +1,15 @@
 module MiriamTech
   module GoCD
     module DSL
-      def with_artifacts_volume(prefix = project_name, &block)
+      def capture_artifacts(prefix = project_name, workdir:, path:)
+        with_artifacts_volume(prefix) do |volume_name|
+            yield "-v #{volume_name}:#{workdir}/#{path}"
+        ensure
+          copy_artifacts_from_volume(volume_name, local_path: path)
+        end
+      end
+
+      def with_artifacts_volume(prefix = project_name)
         artifacts_volume = sanitized_volume_name("#{prefix}#{build_tag}")
         docker "volume create #{artifacts_volume}"
         yield artifacts_volume
@@ -10,7 +18,7 @@ module MiriamTech
       end
 
       def copy_artifacts_from_volume(volume, local_path:)
-        container_id = `docker create -v #{volume}:/artifacts_volume #{WORKER_IMAGE} cp -a /artifacts_volume /artifacts_tmp`.chomp
+        container_id = `docker create -v #{volume}:/artifacts #{WORKER_IMAGE} cp -a /artifacts /artifacts_tmp`.chomp
         begin
           docker "start -i #{container_id}"
           cd root_path do
@@ -24,7 +32,7 @@ module MiriamTech
       private
 
       def sanitized_volume_name(name)
-        name.gsub(/[^-_\.A-Za-z0-9]/, '_')
+        name.gsub(/[^-_.A-Za-z0-9]/, '_')
       end
     end
   end

data/lib/miriamtech/gocd/docker.rb

@@ -1,8 +1,9 @@
 module MiriamTech
   module GoCD
+    FALSY_ENV_VALUES = (%w[0 f false n no] + ['']).freeze
     module DSL
       def project_name(env = ENV)
-        (env['GO_PIPELINE_NAME'] || File.basename(File.expand_path('.'))).downcase
+        (env['GO_PIPELINE_NAME'] || root_path.basename.to_s).downcase
       end
 
       def build_tag(env = ENV)
@@ -13,8 +14,14 @@ module MiriamTech
         sh "docker #{string}"
       end
 
+      def docker_build_arguments(env = ENV)
+        args = ['--force-rm']
+        no_cache_arg = env['DOCKER_BUILD_NO_CACHE']
+        args << '--no-cache' if no_cache_arg && !FALSY_ENV_VALUES.include?(no_cache_arg)
+        args
+      end
+
       def docker_compose(string)
-        # PIPELINE_NAME = (ENV['GO_PIPELINE_NAME'] || 'ilien').downcase
         cd root_path do
           sh "docker-compose -p #{project_name} -f docker-compose.yml #{string}"
         end
@@ -23,12 +30,13 @@ module MiriamTech
       private
 
       def generate_build_tag(env)
-        if revision = env['GO_PIPELINE_COUNTER']
-          @build_tag =":#{revision}"
+        revision = env['GO_PIPELINE_COUNTER']
+        if revision
+          @build_tag = revision ? ":#{revision}" : ''
         else
-          @build_tag = ""
+          @build_tag = ''
+          ''
         end
-        env['BUILD_TAG'] = @build_tag
       end
     end
   end

data/lib/miriamtech/gocd/dsl.rb

@@ -5,4 +5,10 @@ require_relative 'lambda'
 require_relative 'paths'
 require_relative 'tasks'
 
-self.extend MiriamTech::GoCD::DSL
+# Add our DSL methods to the top level namespace without polluting the Object inheritance tree.
+# This technique comes from `rake`, see e.g.
+# https://github.com/ruby/rake/blob/11973e8d31f29aee2e40d874206c9240956f86ed/lib/rake/dsl_definition.rb#L195
+#
+# rubocop:disable Style/MixinUsage
+extend MiriamTech::GoCD::DSL
+# rubocop:enable Style/MixinUsage

data/lib/miriamtech/gocd/images.rb

@@ -1,7 +1,7 @@
 module MiriamTech
   module GoCD
     module DSL
-      WORKER_IMAGE = 'debian:buster'
+      WORKER_IMAGE = 'debian:buster'.freeze
 
       def pull(image_name)
         docker "pull #{image_name}#{build_tag}"
@@ -17,14 +17,13 @@ module MiriamTech
       end
 
       def cleanup_old_images(image_name, number_to_keep)
-        revision_number = ENV["GO_PIPELINE_COUNTER"].to_i
+        revision_number = ENV['GO_PIPELINE_COUNTER'].to_i
         return unless revision_number > number_to_keep
         images = `docker images --format "{{.Repository}}:{{.Tag}}" #{image_name}`.split(/\s+/)
         images.each do |image|
           next unless image.match(/:(\d+)\z/)
-          if $1.to_i < revision_number - number_to_keep
-            docker "image rm #{image}"
-          end
+          next unless Regexp.last_match(1).to_i < revision_number - number_to_keep
+          docker "image rm #{image}"
         end
       end
     end

data/lib/miriamtech/gocd/paths.rb

@@ -6,12 +6,17 @@ module MiriamTech
       def root_path
         cwd = Pathname.new(File.expand_path('.'))
         path = Pathname.new(cwd)
-        begin
+        loop do
+          break if path.root?
           return path if path.join('Dockerfile').exist?
           path = path.parent
-        end until path.root?
+        end
         cwd
       end
+
+      def compose_file
+        root_path / 'docker-compose.yml'
+      end
     end
   end
 end

data/lib/miriamtech/gocd/tasks.rb

@@ -4,31 +4,43 @@ require 'rake/clean'
 module MiriamTech
   module GoCD
     module DSL
+      # rubocop:disable Style/HashSyntax, Style/SymbolArray, Metrics/MethodLength
+
       def define_gocd_tasks(
         image_name,
-        revisions_to_keep: 10)
+        revisions_to_keep: 10
+      )
 
         task :default => [:test]
         task :full => [:clobber, :build]
 
-        CLEAN.add(root_path + '/test/reports')
-        task :clean do
-          docker_compose "stop"
+        task :environment do
+          ENV['BUILD_TAG'] = build_tag
         end
 
-        task :clobber => :cleanup_old_images do
-          docker_compose "rm -fv"
+        CLEAN.add("#{root_path}/test/reports")
+        task :clean => [:environment]
+        task :clobber => [:environment, :cleanup_old_images]
+
+        if compose_file.exist?
+          task :clean do
+            docker_compose 'stop'
+          end
+
+          task :clobber do
+            docker_compose 'rm -fv'
+          end
         end
 
         task :cleanup_old_images do
           cleanup_old_images(image_name, revisions_to_keep)
         end
 
-        task :build do
-          docker "build --force-rm -t #{image_name}#{build_tag} #{root_path}"
+        task :build => :environment do
+          docker "build #{docker_build_arguments.join(' ')} -t #{image_name}#{build_tag} #{root_path}"
         end
 
-        task :test
+        task :test => :environment
 
         task :push do
           push(image_name)
@@ -39,7 +51,13 @@ module MiriamTech
           pull(image_name)
           push(image_name, 'deployed')
         end
+
+        task :bash do
+          docker("run -it --rm #{image_name} bash")
+        end
       end
+
+      # rubocop:enable Style/HashSyntax, Style/SymbolArray, Metrics/MethodLength
     end
   end
 end

data/lib/miriamtech/gocd/version.rb

@@ -1,5 +1,5 @@
 module MiriamTech
   module GoCD
-    VERSION = "0.2.3"
+    VERSION = '0.2.8'.freeze
   end
 end

data/miriamtech-gocd.gemspec

@@ -1,34 +1,38 @@
-lib = File.expand_path("lib", __dir__)
+lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require "miriamtech/gocd/version"
+require 'miriamtech/gocd/version'
 
 Gem::Specification.new do |spec|
-  spec.name          = "miriamtech-gocd"
+  spec.name          = 'miriamtech-gocd'
   spec.version       = MiriamTech::GoCD::VERSION
-  spec.authors       = ["Ken Treis"]
-  spec.email         = ["ken@miriamtech.com"]
+  spec.authors       = ['Ken Treis']
+  spec.email         = ['ken@miriamtech.com']
 
-  spec.summary       = %q{Utilities for building apps in Docker containers with GoCD}
-  spec.homepage      = "https://www.miriamtech.com"
+  spec.summary       = 'Utilities for building apps in Docker containers with GoCD'
+  spec.homepage      = 'https://www.miriamtech.com'
 
-  spec.metadata["allowed_push_host"] = "https://rubygems.org"
+  spec.metadata['allowed_push_host'] = 'https://rubygems.org'
 
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "https://github.com/miriamtech/gocd"
-  spec.metadata["changelog_uri"] = "https://github.com/miriamtech/gocd/blob/master/CHANGELOG.md"
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/miriamtech/gocd'
+  spec.metadata['changelog_uri'] = 'https://github.com/miriamtech/gocd/blob/master/CHANGELOG.md'
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   end
-  spec.bindir        = "exe"
+  spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
+  spec.require_paths = ['lib']
 
-  spec.add_development_dependency "bundler", "~> 2.0"
-  spec.add_development_dependency "rake", ">= 10.0"
-  spec.add_development_dependency "minitest", "~> 5.0"
+  spec.required_ruby_version = '~> 2.5'
+  spec.add_dependency 'rake', '>= 10.0'
+
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'minitest', '~> 5.0'
   spec.add_development_dependency 'rspec-expectations'
   spec.add_development_dependency 'rspec-mocks'
+  spec.add_development_dependency 'rubocop'
+  spec.add_development_dependency 'rubocop-minitest'
 end

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: miriamtech-gocd
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.2.8
 platform: ruby
 authors:
 - Ken Treis
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-09-17 00:00:00.000000000 Z
+date: 2021-04-21 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '10.0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -25,35 +39,49 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '2.0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rspec-expectations
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: minitest
+  name: rspec-mocks
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: rspec-expectations
+  name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -67,7 +95,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rspec-mocks
+  name: rubocop-minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -88,12 +116,15 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".rubocop.yml"
 - ".travis.yml"
 - CHANGELOG.md
 - Gemfile
+- Gemfile.lock
 - README.md
 - Rakefile
 - bin/console
+- bin/rubocop
 - bin/run_tests.sh
 - bin/setup
 - lib/miriamtech/gocd.rb
@@ -119,9 +150,9 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - "~>"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="