backup_repos 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 6718eef43c2b948695d80440e1a4c7b15955ca32
-  data.tar.gz: ca33ce8930116dfb54d3430d0d596182be3b2def
+SHA256:
+  metadata.gz: ee0ccc53eb5f8097ad961b8a142016a2ba038760375c45ee3a6517cd7e7bca41
+  data.tar.gz: 112d547c552f67c56e336057e0b662b117f345328959f97f45c372497ca628a7
 SHA512:
-  metadata.gz: 37a37b63a83797f0a1c4a4ce2de64abc0e9cc2a6bc4df349d572f0b706b3d263522611ce24f516e5c0eb7aae77ca579ebaa3cb5bc47fcedcbf29ecb348f8228e
-  data.tar.gz: 440710ae8c2a1900b3f781dc8a9855f5754908a9ac72f193390ef7344b75f5a10f569e2eb642a33b550b098dceeba6f86942e03fbe38fe205faa1c5708400fa4
+  metadata.gz: 70a85ecf3341f550b9c934869070ad2b5ef942b721d058921e4a17c51544fc66bce235cdbebd6a75f7540ff720f58855dab34f478705b02655d3a8c4d04c6667
+  data.tar.gz: 344842a33943f702aa3c111e5bf3f14353486df1a8e9cf78274d6bbf88e17b5a52abbd46b312131c874d0f73923463020d8bfde69e4e932a758f576a849d436d

data/.github/workflows/test.yml

@@ -0,0 +1,22 @@
+name: Test
+
+on: [push]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v1
+    - name: Set up Ruby 2.6
+      uses: actions/setup-ruby@v1
+      with:
+        ruby-version: 2.6.x
+    - name: Build and test with Rake
+      env:
+        CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+      run: |
+        gem install bundler
+        bundle install --jobs 4 --retry 3
+        bundle exec rspec

data/.rubocop.yml

@@ -1,5 +1,5 @@
-Rails:
-  Enabled: false
+AllCops:
+  TargetRubyVersion: 2.6
 
 Style/Documentation:
   Enabled: false
@@ -18,4 +18,4 @@ Style/MultilineMethodCallIndentation:
 
 Style/CaseIndentation:
   Enabled: true
-  IndentWhenRelativeTo: end
+  EnforcedStyle: end

data/Gemfile

@@ -1,14 +1,19 @@
+# frozen_string_literal: true
+
 source 'https://rubygems.org'
 
 # Specify your gem's dependencies in backup_repos.gemspec
 gemspec
 
+group :development do
+  gem 'rubocop', '~> 0.77'
+end
+
 group :development, :test do
   gem 'pry'
 end
 
 group :test do
-  gem 'codeclimate-test-reporter'
-  gem 'coveralls'
+  gem 'codecov', require: false
   gem 'simplecov', require: false
 end

data/{LICENSE.md → LICENSE}

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2016 Justas Palumickas
+Copyright (c) 2019 Justas Palumickas
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -1,11 +1,7 @@
 # Backup Repos
 
 [![Gem Version](https://img.shields.io/gem/v/backup_repos.svg?style=flat-square)][rubygems]
-[![Gitter](https://img.shields.io/gitter/room/jpalumickas/jpalumickas.svg?style=flat-square)][gitter]
-[![Build Status](https://img.shields.io/travis/jpalumickas/backup-repos.svg?style=flat-square)][travis]
-[![Dependency Status](https://img.shields.io/gemnasium/jpalumickas/backup-repos.svg?style=flat-square)][gemnasium]
-[![Coverage Status](https://img.shields.io/coveralls/jpalumickas/backup-repos.svg?branch=master&style=flat-square)][coveralls]
-[![Code Climate](https://img.shields.io/codeclimate/github/jpalumickas/backup-repos.svg?style=flat-square)][codeclimate]
+[![Coverage Status](https://img.shields.io/codecov/c/github/jpalumickas/backup-repos?style=flat-square)][codecov]
 
 
 Backup your GitHub, BitBucket and GitLab repositories to specified directory.
@@ -34,7 +30,7 @@ Backup all your providers:
 $ backup-repos backup
 ```
 
-Or specify one:
+Or specify one provider:
 
 ```shell
 $ backup-repos backup github
@@ -52,14 +48,10 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 Bug reports and pull requests are welcome on GitHub at https://github.com/jpalumickas/backup-repos.
 
 ## Copyright
-Copyright (c) 2017 Justas Palumickas.
+Copyright (c) 2019 Justas Palumickas.
 See [LICENSE][] for details.
 
 [rubygems]: https://rubygems.org/gems/backup_repos
-[travis]: http://travis-ci.org/jpalumickas/backup-repos
-[gemnasium]: https://gemnasium.com/jpalumickas/backup-repos
-[coveralls]: https://coveralls.io/r/jpalumickas/backup-repos
-[codeclimate]: https://codeclimate.com/github/jpalumickas/backup-repos
-[gitter]: https://gitter.im/jpalumickas/backup-repos
+[codecov]: https://codecov.io/gh/jpalumickas/backup-repos
 
 [license]: LICENSE.md

data/Rakefile

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
 

data/backup_repos.gemspec

@@ -1,5 +1,6 @@
-# coding: utf-8
-lib = File.expand_path('../lib', __FILE__)
+# frozen_string_literal: true
+
+lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'backup_repos/version'
 
@@ -20,14 +21,17 @@ Gem::Specification.new do |spec|
   spec.executables   = ['backup-repos']
   spec.require_paths = ['lib']
 
+  spec.required_ruby_version = '>= 2.4.0'
+
   spec.add_dependency 'bitbucket_rest_api', '~> 0.1.7'
   spec.add_dependency 'colorize', '~> 0.8.1'
   spec.add_dependency 'commander', '~> 4.4'
-  spec.add_dependency 'gitlab', '~> 3.7'
-  spec.add_dependency 'hashie', '~> 3.5'
-  spec.add_dependency 'octokit', '~> 4.6'
+  spec.add_dependency 'gitlab', '~> 4.12'
+  spec.add_dependency 'hashie', '~> 4.0'
+  spec.add_dependency 'highline', '~> 2.0'
+  spec.add_dependency 'octokit', '~> 4.14'
 
-  spec.add_development_dependency 'bundler', '~> 1.11'
-  spec.add_development_dependency 'rake', '~> 10.0'
-  spec.add_development_dependency 'rspec', '~> 3.5'
+  spec.add_development_dependency 'bundler', '~> 2.0'
+  spec.add_development_dependency 'rake', '~> 12.0'
+  spec.add_development_dependency 'rspec', '~> 3.8'
 end

data/bin/backup-repos

@@ -1,6 +1,7 @@
 #!/usr/bin/env ruby
-# encoding: utf-8
+# frozen_string_literal: true
 
+require 'bundler/setup'
 require 'backup_repos'
 
 BackupRepos::Commander.new.run

data/bin/console

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
 require 'bundler/setup'
 require 'backup_repos'

data/lib/backup_repos.rb

@@ -1,8 +1,11 @@
+# frozen_string_literal: true
+
 require 'colorize'
 
 require 'core_ext/object'
 require 'core_ext/string'
 
+require 'backup_repos/mash'
 require 'backup_repos/commander'
 require 'backup_repos/config'
 require 'backup_repos/shell'

data/lib/backup_repos/backup.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require_relative 'performers/base_git'
 require_relative 'backup_github'
 require_relative 'backup_bitbucket'
@@ -22,16 +24,22 @@ module BackupRepos
 
     def process_github
       return unless valid?
+      return unless BackupRepos.config.github_access_token
+
       BackupGithub.new.process
     end
 
     def process_bitbucket
       return unless valid?
+      return unless BackupRepos.config.bitbucket
+
       BackupBitbucket.new.process
     end
 
     def process_gitlab
       return unless valid?
+      return unless BackupRepos.config.gitlab
+
       BackupGitlab.new.process
     end
 
@@ -54,6 +62,7 @@ module BackupRepos
       end
 
       return if File.exist?(backup_root)
+
       errors << 'Backup directory does not exists.'
     end
 

data/lib/backup_repos/backup_bitbucket.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'bitbucket_rest_api'
 
 require_relative 'performers/bitbucket_git_repository'
@@ -19,8 +21,8 @@ module BackupRepos
 
     def ask_credentials
       cli = HighLine.new
-      @username = cli.ask('BitBucket Username: ')
-      @password = cli.ask('BitBucket Password:  ') { |q| q.echo = false }
+      @username = BackupRepos.config.dig('bitbucket', 'username') || cli.ask('BitBucket Username: ')
+      @password = BackupRepos.config.dig('bitbucket', 'password') || cli.ask('BitBucket Password:  ') { |q| q.echo = false }
     end
 
     def process_git_repositories

data/lib/backup_repos/backup_github.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'octokit'
 
 require_relative 'performers/github_repository'
@@ -9,7 +11,7 @@ module BackupRepos
     def process
       process_repositories
       process_wiki
-      process_gist
+      process_gist if backup_gist?
     end
 
     def repos
@@ -49,12 +51,22 @@ module BackupRepos
     end
 
     def exclude_repo?(repo)
+      allow_list = BackupRepos.config.only_list
+      return !repo_exists?(allow_list, repo) if allow_list.present?
+
       return false if exclude_repos.blank?
 
+      repo_exists?(exclude_repos, repo)
+    end
+
+    def repo_exists?(list, repo)
       repo_owner = repo.owner.login.to_s.downcase
       full_name = repo.full_name.to_s.downcase
+      list.include?(repo_owner) || list.include?(full_name)
+    end
 
-      exclude_repos.include?(repo_owner) || exclude_repos.include?(full_name)
+    def backup_gist?
+      BackupRepos.config.only_list.blank?
     end
   end
 end

data/lib/backup_repos/backup_gitlab.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module BackupRepos
   class BackupGitlab
     def process

data/lib/backup_repos/backup_gitlab_endpoint.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'gitlab'
 require 'uri'
 
@@ -5,10 +7,12 @@ require_relative 'performers/gitlab_repository'
 
 module BackupRepos
   class BackupGitlabEndpoint
+    DEFAULT_ENDPOINT = 'https://gitlab.com/api/v4'
+
     attr_reader :endpoint, :private_token
 
     def initialize(settings)
-      @endpoint = settings.endpoint
+      @endpoint = settings.endpoint || DEFAULT_ENDPOINT
       @private_token = settings.private_token
     end
 
@@ -17,7 +21,7 @@ module BackupRepos
     end
 
     def repos
-      @repos ||= client.projects.auto_paginate
+      @repos ||= client.projects(membership: true).auto_paginate
     end
 
     def client

data/lib/backup_repos/cli/setup.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module BackupRepos
   module CLI
     class Setup
@@ -33,6 +35,10 @@ module BackupRepos
         if cli.agree '* Are you want to backup BitBucket repositories?'
           configure_bitbucket
         end
+
+        if cli.agree '* Are you want to backup GitLab repositories?'
+          configure_gitlab
+        end
       end
 
       def configure_backup_directory
@@ -78,6 +84,26 @@ module BackupRepos
         end
       end
 
+      def configure_gitlab
+        @config[:gitlab] ||= []
+
+        cli.say '  GitLab Endpoint. Use this for self-hosted GitLab or press Enter to skip.'
+        endpoint = cli.ask '    Endpoint: '
+        cli.say '  What is your GitLab private token?'
+        private_token = cli.ask '    Private Token: '
+        exclude_repositories = cli.ask(
+          '   Exclude repositories or organizations (separate by space):  ', Array
+        )
+
+        config = {}
+        config[:endpoint] = endpoint if endpoint.present?
+        config[:private_token] = private_token if private_token.present?
+
+        config[:exclude] = exclude_repositories if exclude_repositories.present?
+
+        @config[:gitlab] << config
+      end
+
       def configure_bitbucket
         cli.say '  What is your BitBucket credentials?'
         username = ask('    Username:  ')

data/lib/backup_repos/commander.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'commander'
 
 require_relative 'cli/setup'
@@ -15,13 +17,15 @@ module BackupRepos
         c.syntax = 'backup-repos backup'
         c.description = 'Backup your repositories.'
 
-        c.option '--backup_root DIR', String, 'Backup destination directory'
+        c.option '--config-path PATH', String, 'Path to configuration file'
+        c.option '--backup-root DIR', String, 'Backup destination directory'
         c.option '--debug', String, 'Show debug information'
+        c.option '--only LIST', String, 'Only backup specified repos or orgs. Separate by comma.'
 
         c.action do |args, options|
           BackupRepos.config_options = options
 
-          if args[0] && %w(github bitbucket gitlab).include?(args[0].downcase)
+          if args[0] && %w[github bitbucket gitlab].include?(args[0].downcase)
             BackupRepos::Backup.new.send("process_#{args[0]}")
           else
             BackupRepos::Backup.new.process

data/lib/backup_repos/config.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'yaml'
 require 'hashie/mash'
 
@@ -5,7 +7,7 @@ module BackupRepos
   class Config
     attr_reader :options
 
-    def initialize(options = Hashie::Mash.new({}))
+    def initialize(options = BackupRepos::Mash.new({}))
       @options = options
     end
 
@@ -17,6 +19,7 @@ module BackupRepos
 
     def backup_root
       return if backup_root_dir.blank?
+
       File.expand_path(backup_root_dir)
     end
 
@@ -25,10 +28,18 @@ module BackupRepos
       options.github_access_token || config_token
     end
 
+    def only_list
+      return if options.only.blank?
+
+      options.only.split(',').map(&:strip)
+    end
+
     # ===
 
     def method_missing(name, *_args)
-      options.send(name) || config[name.to_s] || super
+      return options.send(name) if options.respond_to?(name)
+
+      config[name.to_s]
     end
 
     def respond_to_missing?(name, include_private = false)
@@ -36,17 +47,24 @@ module BackupRepos
     end
 
     def config_file
-      File.join(Dir.home, '.backup-repos')
+      return File.join(Dir.home, '.backup-repos') if options.config_path.blank?
+
+      File.expand_path(options.config_path)
+    end
+
+    def dig(*args)
+      config.dig(*args)
     end
 
     private
 
     def config
-      @config ||= Hashie::Mash.new(file_config)
+      @config ||= BackupRepos::Mash.new(file_config)
     end
 
     def file_config
       return {} unless File.exist?(config_file)
+
       @file_config ||= (YAML.load_file(config_file) || {})
     end
 

data/lib/backup_repos/mash.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'hashie/mash'
+
+module BackupRepos
+  class Mash < Hashie::Mash
+    disable_warnings
+  end
+end

data/lib/backup_repos/performers/base_git.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module BackupRepos
   module Performers
     class BaseGit

data/lib/backup_repos/performers/bitbucket_git_repository.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module BackupRepos
   module Performers
     class BitbucketGitRepository < BaseGit

data/lib/backup_repos/performers/bitbucket_git_wiki.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module BackupRepos
   module Performers
     class BitbucketGitWiki < BitbucketGitRepository

data/lib/backup_repos/performers/github_gist.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module BackupRepos
   module Performers
     class GithubGist < BaseGit

data/lib/backup_repos/performers/github_repository.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module BackupRepos
   module Performers
     class GithubRepository < BaseGit

data/lib/backup_repos/performers/github_wiki.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module BackupRepos
   module Performers
     class GithubWiki < BaseGit

data/lib/backup_repos/performers/gitlab_repository.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module BackupRepos
   module Performers
     class GitlabRepository < BaseGit

data/lib/backup_repos/shell.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module BackupRepos
   class Shell
     def initialize(opts = {})
@@ -16,7 +18,7 @@ module BackupRepos
     end
 
     def execute_command(command)
-      output = IO.popen(command, 'r', err: [:child, :out]) do |io|
+      output = IO.popen(command, 'r', err: %i[child out]) do |io|
         output = io.read
         log_output(output)
         output

data/lib/backup_repos/version.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module BackupRepos
-  VERSION = '0.3.0'.freeze
+  VERSION = '0.4.0'
 end

data/lib/core_ext/object.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 class Object
   def blank?
     respond_to?(:empty?) ? !!empty? : !self

data/lib/core_ext/string.rb

@@ -1,5 +1,7 @@
+# frozen_string_literal: true
+
 class String
-  BLANK_RE = /\A[[:space:]]*\z/
+  BLANK_RE = /\A[[:space:]]*\z/.freeze
 
   def blank?
     BLANK_RE.match(self)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: backup_repos
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Justas Palumickas
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-02-27 00:00:00.000000000 Z
+date: 2019-11-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bitbucket_rest_api
@@ -58,84 +58,98 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.7'
+        version: '4.12'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.7'
+        version: '4.12'
 - !ruby/object:Gem::Dependency
   name: hashie
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.5'
+        version: '4.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.5'
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: highline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: octokit
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.6'
+        version: '4.14'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '4.6'
+        version: '4.14'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.11'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.11'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '12.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '12.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.5'
+        version: '3.8'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.5'
+        version: '3.8'
 description: Backup your GitHub, BitBucket, GitLab repositories to specified directory.
 email:
 - jpalumickas@gmail.com
@@ -144,14 +158,13 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- ".codeclimate.yml"
+- ".github/workflows/test.yml"
 - ".gitignore"
 - ".hound.yml"
 - ".rspec"
 - ".rubocop.yml"
-- ".travis.yml"
 - Gemfile
-- LICENSE.md
+- LICENSE
 - README.md
 - Rakefile
 - backup_repos.gemspec
@@ -167,6 +180,7 @@ files:
 - lib/backup_repos/cli/setup.rb
 - lib/backup_repos/commander.rb
 - lib/backup_repos/config.rb
+- lib/backup_repos/mash.rb
 - lib/backup_repos/performers/base_git.rb
 - lib/backup_repos/performers/bitbucket_git_repository.rb
 - lib/backup_repos/performers/bitbucket_git_wiki.rb
@@ -189,15 +203,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.4.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.8
+rubygems_version: 3.0.6
 signing_key: 
 specification_version: 4
 summary: Backup your repositories

data/.codeclimate.yml

@@ -1,22 +0,0 @@
-engines:
-  duplication:
-    enabled: true
-    config:
-      languages:
-      - ruby
-  fixme:
-    enabled: true
-  rubocop:
-    enabled: true
-    exclude_fingerprints:
-    - 580ec239bc6e53e62cd63ce219b812e6
-    - 39dfc9669aec43e3e76abb09d3b5fcc1
-    - 016d5b320f02cb900b27631f3c7c0a20
-    checks:
-      Rubocop/Rails/Output:
-        enabled: false
-ratings:
-  paths:
-  - "**.rb"
-exclude_paths:
-- spec/

data/.travis.yml

@@ -1,11 +0,0 @@
-language: ruby
-rvm:
-  - 2.2.3
-before_install: gem install bundler -v 1.11.2
-notifications:
-  webhooks:
-    urls:
-      - https://webhooks.gitter.im/e/42b88a12ac0d365e7709
-    on_success: change  # options: [always|never|change] default: always
-    on_failure: always  # options: [always|never|change] default: always
-    on_start: never     # options: [always|never|change] default: always