grifork 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 39cd6c990f5c21321b737f9c12c7651ff843a7a2
-  data.tar.gz: 5a02758138e9f35fada790135e896d7bcea1a249
+  metadata.gz: 051978666d0eb719ebe0d1fb7396767f2849b60b
+  data.tar.gz: d1db36aff5d670f124ab13dadfa8288347ed1998
 SHA512:
-  metadata.gz: 5c87db79f590d4356a7e4c6225cd8f546895e0ec3ebcbba02c45bfe6e742006d2726ff523c22a00ff19aa3d747a0416adf576c0b3bdf1ef9c65c8460f2f28c07
-  data.tar.gz: 6dfbb038e924db9aa075c4ea212d15c41d32ec6c4ccbe4143dbcb89488a3b6c185178c69b93a74d659c851965233e0c18e560b0c4a59fc76547fc6d1a503825e
+  metadata.gz: 728ccefbb4558dc6caccd3a8a1504a52ad19fd8627d993046a82003545d0ee812cd66285088b96a858013eac16db4b25257207eadf1d6a94d7fd49b735be692d
+  data.tar.gz: b61507b73b372ba673b1d4eb9a78c85efce6c49d7a4b1534723392ceca9e80b9274c67b926490c044849f91a6753f03dda902b6b1914440a44ce7ae518f1bd57

data/.yardopts

@@ -0,0 +1,4 @@
+--private
+-
+CHANGELOG.md
+LICENSE

data/CHANGELOG.md

@@ -1,3 +1,21 @@
+## 0.4.0 (2016/10/9)
+
+Bug Fix: (#3)
+
+- `Grifork::Executor::Task#run` was not thread-safe
+
+Features: (#3)
+
+- New DSL methods:
+  - `#parallel` as option for [Parallel.map](https://github.com/grosser/parallel)
+  - `#ssh` as options for [Net::SSH](https://github.com/net-ssh/net-ssh)
+  - `#rsync` as options for `rsync` command
+- New CLI option `-n|--dry-run`
+
+Improve: (#3)
+
+- Mode `:grifork` / Not to fork `grifork` task on node with no children
+
 ## 0.3.0 (2016/10/4)
 
 Release as a RubyGem.

data/README.md

@@ -1,3 +1,4 @@
+[![Gem Version](https://badge.fury.io/rb/grifork.svg)](https://badge.fury.io/rb/grifork)
 [![Build Status](https://travis-ci.org/key-amb/grifork.svg?branch=master)](https://travis-ci.org/key-amb/grifork)
 
 # grifork
@@ -63,10 +64,36 @@ bundle
 
 ```sh
 edit Griforkfile
-./bin/grifork [--[f]ile path/to/Griforkfile]
+./bin/grifork [--[f]ile path/to/Griforkfile] [-n|--dry-run]
 ```
 
-See [example](example) directory for sample of Griforkfiles.
+## Griforkfile
+
+**Griforkfile** is DSL file for _grifork_ which configures and defines the tasks
+to be executed by _grifork_.
+
+Here is a small example:
+
+```ruby
+branches 4
+log file: 'grifork.log'
+hosts ['web1.internal', 'web2.internal', 'db1.internal', 'db2.internal', ...]
+
+local do
+  rsync '/path/to/myapp/'
+end
+
+remote do
+  rsync_remote '/path/to/myapp/'
+end
+```
+
+If you run `grifork` with this _Griforkfile_, it just syncs `/path/to/myapp/` in
+localhost to target `hosts` by `rsync` command.
+
+See [example](https://github.com/key-amb/grifork/tree/master/example) directory for more examples of _Griforkfile_.
+
+And refer to [Grifork::DSL](http://www.rubydoc.info/gems/grifork/Grifork/DSL) as API document of _Griforkfile_.
 
 # Authors
 

data/example/Griforkfile.grifork

@@ -1,12 +1,24 @@
+# Example of Grifork DSL for :grifok mode
+# See Grifork::DSL for more informaion about DSL format
+
 # Configuration
 #mode :grifork
 branches 4
 log file: 'tmp/grifork.log', level: 'debug'
 
+# Parallel mode for "parallel"
+#  Defaults to :in_threads
+#parallel :in_processes
+
+# Configure ssh options for #ssh & #grifork
+#  With private key auth:
+ssh user: 'someone', keys: ['path/to/identity_file'], passphrase: 'xxx'
+#  With password auth:
+#ssh user: 'someone', password: 'xxx'
+
 # Setting to exec grifork on remote
 #  Implies to set mode as :grifork
 grifork do
-  user   'someone' # ssh user to exec grifork on remote
   chdir  '/path/to/your-app'
   tmpdir '/path/to/tmpdir'
   exec   '/path/to/grifork'
@@ -15,10 +27,15 @@ end
 # Define hosts as array
 hosts ['web1.internal', 'web2.internal', '192.168.10.1', '192.168.10.2']
 
+# Configure rsync options
+#  Defaults to ['-az', '--delete']
+# Available full Hash options are bellow:
+rsync delete: true, bwlimit: 4096, verbose: false, excludes: [], rsh: nil, dry_run: false
+
 # Define task run on localhost
 local do
   sh :echo, %W(LOCAL: #{src} => #{dst})
-  ssh dst, :mkdir, %W(-p /path/to/dest), user: 'someone'
+  ssh dst, :mkdir, %W(-p /path/to/dest)
   rsync '/path/to/src/', '/path/to/dest/'
 end
 
@@ -27,7 +44,7 @@ end
 #  different from "remote" task in :standalone mode
 remote do
   sh :echo, %W(REMOTE: #{src} => #{dst})
-  ssh dst, :mkdir, %W(-p /path/to/dest), user: 'someone'
+  ssh dst, :mkdir, %W(-p /path/to/dest)
   rsync '/path/to/src/', '/path/to/dest/'
 end
 

data/example/Griforkfile.standalone

@@ -1,15 +1,32 @@
-# Configuration
+# Example of Grifork DSL for :standalone mode
+# See Grifork::DSL for more informaion about DSL format
+
 #mode :standalone # Default mode
 branches 4
 log file: 'tmp/grifork.log', level: 'debug'
 
+# Parallel mode for "parallel"
+#  Defaults to :in_threads
+#parallel :in_processes
+
 # Define hosts as array
 hosts ['web1.internal', 'web2.internal', '192.168.10.1', '192.168.10.2']
 
+# Configure ssh options for #ssh
+#  With private key auth:
+ssh user: 'someone', keys: ['path/to/identity_file'], passphrase: 'xxx'
+#  With password auth:
+#ssh user: 'someone', password: 'xxx'
+
+# Configure rsync options
+#  Defaults to ['-az', '--delete']
+# Available full Hash options are bellow:
+rsync delete: true, bwlimit: 4096, verbose: false, excludes: [], rsh: nil, dry_run: false
+
 # Define task run on localhost
 local do
   sh :echo, %W(LOCAL: #{src} => #{dst})
-  ssh dst, :mkdir, %W(-p /path/to/dest), user: 'someone'
+  ssh dst, :mkdir, %W(-p /path/to/dest)
   rsync '/path/to/src/', '/path/to/dest/'
 end
 
@@ -17,6 +34,6 @@ end
 remote do
   sh :echo, %W(REMOTE: #{src} => #{dst})
   ssh dst, :mkdir, %W(-p /path/to/dest)
-  rsync_remote '/path/to/src/', '/path/to/dest/', user: 'someone'
+  rsync_remote '/path/to/src/', '/path/to/dest/'
 end
 

data/lib/grifork/cli.rb

@@ -4,6 +4,7 @@ class Grifork::CLI
       opt.on('-f', '--file Griforkfile') { |f| @taskfile      = f }
       opt.on('-o', '--override-by FILE') { |f| @override_file = f }
       opt.on('-r', '--on-remote')        { @on_remote = true }
+      opt.on('-n', '--dry-run')          { @dry_run   = true }
       opt.on('-v', '--version')          { @version   = true }
       opt.parse!(argv)
     end
@@ -12,11 +13,17 @@ class Grifork::CLI
       exit
     end
 
-    config = load_taskfiles.freeze
+    config = load_taskfiles
+    if @dry_run
+      config.dry_run = true
+    end
+    config.freeze
     Grifork.configure!(config)
+    logger = Grifork.logger
 
     graph = Grifork::Graph.new(config.hosts)
 
+    logger.info("START | mode: #{config.mode}")
     if @on_remote
       puts "Start on remote. Hosts: #{config.hosts}"
     end
@@ -31,6 +38,7 @@ class Grifork::CLI
       raise "Unexpected mode! #{config.mode}"
     end
 
+    logger.info("END | mode: #{config.mode}")
     if @on_remote
       puts "End on remote."
     end

data/lib/grifork/config.rb

@@ -1,6 +1,6 @@
 class Grifork::Config
   attr_reader   :branches, :hosts, :log, :local_task, :remote_task, :grifork
-  attr_accessor :griforkfile
+  attr_accessor :griforkfile, :dry_run
 
   def initialize(args)
     args.each do |key, val|
@@ -12,6 +12,31 @@ class Grifork::Config
     @mode || :standalone
   end
 
+  def parallel
+    @parallel || :in_threads
+  end
+
+  def dry_run?
+    @dry_run ? true : false
+  end
+
+  def ssh
+    @ssh || SSH.new
+  end
+
+  # Build +rsync+ command-line options from +@rsync+ and +@ssh+ objects
+  # @return [Array<String>] +rsync+ command options
+  # @see Rsync
+  # @see SSH
+  def rsync_opts
+    @rsync ||= Rsync.new
+    opts = @rsync.options
+    if opts.grep(/^(-e|--rsh)$/).size.zero?
+      opts.concat(['--rsh', ssh.command_for_rsync])
+    end
+    opts
+  end
+
   class Log
     attr :file, :level
 
@@ -21,6 +46,56 @@ class Grifork::Config
     end
   end
 
+  class SSH
+    attr :options
+    def initialize(opts = {})
+      @options = opts
+    end
+
+    # Build +ssh+ command with options
+    # @return [String] +ssh+ command with options
+    def command_for_rsync
+      args = []
+      args << "-l #{@options[:user]}" if @options[:user]
+      args << "-p #{@options[:port]}" if @options[:port]
+      if @options[:keys]
+        @options[:keys].each { |key| args << "-i #{key}" }
+      end
+      "ssh #{args.join(' ')}"
+    end
+  end
+
+  class Rsync
+    def initialize(args = %w(-az --delete))
+      case args
+      when Array
+        @options = args
+      when Hash
+        @delete   = args[:delete]   || true
+        @verbose  = args[:verbose]  || false
+        @bwlimit  = args[:bwlimit]  || nil
+        @excludes = args[:excludes] || []
+        @rsh      = args[:rsh]      || nil
+        @dry_run  = args[:dry_run]  || false
+      end
+    end
+
+    def options
+      @options ||= -> {
+        opts = []
+        opts << ( @verbose ? '-avz' : '-az' )
+        opts << '--dry-run'             if @dry_run
+        opts << '--delete'              if @delete
+        opts.concat(['--rsh', @rsh])    if @rsh
+        opts << "--bwlimit=#{@bwlimit}" if @bwlimit
+        if @excludes.size > 0
+          @excludes.each { |ex| opts << "--exclude=#{ex}" }
+        end
+        opts
+      }.call
+    end
+  end
+
   class Grifork
     attr :dir, :cmd, :login
 

data/lib/grifork/dsl.rb

@@ -1,10 +1,14 @@
+# DSL parser for *Griforkfile*
+#
+# _Griforkfile_ is interpreted in instance context by an object of this Class.
 class Grifork::DSL
   attr :config
 
   class LoadError < StandardError; end
 
   # Load DSL file to object
-  # @param path [String]
+  # @return [Grifork::DSL]
+  # @param path [String] path of DSL file
   # @param on_remote [Boolean] whether process is invoked by remote host in :grifork mode or not
   def self.load_file(path, on_remote: false)
     content = File.binread(path)
@@ -18,6 +22,8 @@ class Grifork::DSL
     @on_remote = on_remote
   end
 
+  # Creates {Grifork::Config} object from holding properties
+  # @return [Grifork::Config]
   def to_config
     Grifork::Config.new(@config)
   end
@@ -30,6 +36,8 @@ class Grifork::DSL
     @config.merge!(other.config)
   end
 
+  # Grifork mode: How it works
+  # @param m [Symbol] +:standalone+ or +:grifork+. Defaults to +:standalone+
   def mode(m)
     unless Grifork::MODES.has_key?(m)
       raise LoadError, "Undefined mode! #{m}"
@@ -37,6 +45,9 @@ class Grifork::DSL
     config_set(:mode, m)
   end
 
+  # Configure grifork settings for +:grifork+ mode
+  # @param &command [Proc]
+  # @see Grifork::Config::Grifork.initialize
   def grifork(&command)
     if @config[:mode] == :standalone
       raise LoadError, "Can't configure grifork in standalone mode"
@@ -45,23 +56,74 @@ class Grifork::DSL
     config_set(:grifork, Grifork::Config::Grifork.new(&command))
   end
 
+  # Branches number for tree of host nodes
   def branches(num)
     config_set(:branches, num)
   end
 
+  # Configure logging
+  # @param args [Hash]
+  # @see Grifork::Config::Log.initialize
   def log(args)
     config_set(:log, Grifork::Config::Log.new(args))
   end
 
+  # Forking method to exec tasks in parallel.
+  # @param how [:Symbol] +:in_threads+ or +:in_processes+. Defaults to +:in_threads+
+  # @see https://github.com/grosser/parallel
+  def parallel(how)
+    unless %i(in_threads in_processes).include?(how)
+      raise LoadError, "Invalid parallel mode! #{how.inspect} / must be :in_threads or :in_processes"
+    end
+    config_set(:parallel, how)
+  end
+
+  # Host list as targets of tasks
+  # @param hosts [Array<String>] List of resolvable hostnames
   def hosts(list)
     config_set(:hosts, list)
   end
 
+  # Configure net-ssh options
+  # @params props [Hash] Options for Net::SSH
+  # @example
+  #   # Password authentication
+  #   ssh user: 'someone', password: 'xxx'
+  #   # Private key authentication
+  #   ssh user: 'someone', keys: ['path/to/priv_key'], passphrase: 'xxx'
+  # @see https://github.com/net-ssh/net-ssh
+  def ssh(props)
+    invalid_options = props.keys - Net::SSH::VALID_OPTIONS
+    if invalid_options.size > 0
+      raise LoadError, "#{invalid_options} are invalid for Net::SSH!"
+    end
+    config_set(:ssh, Grifork::Config::SSH.new(props))
+  end
+
+  # Configure rsync command options
+  # @params props [Array, Hash] rsync option parameters
+  # @example
+  #   # Available full Hash options are bellow
+  #   rsync delete: true, bwlimit: 4096, verbose: false, excludes: %w(.git* .svn*), rsh: nil, dry_run: false
+  #   # This is the same with above by Array format:
+  #   rsync %w(-az --delete --bwlimit=4096 --exclude=.git* --exclude=.svn*)
+  #   # You can set more options by Array format:
+  #   rsync %w(-azKc -e=rsh --delete --bwlimit=4096 --exclude-from=path/to/rsync.excludes)
+  def rsync(props)
+    config_set(:rsync, Grifork::Config::Rsync.new(props))
+  end
+
+  # Define tasks to execute at localhost
+  # @param &task [Proc] Codes to be executed by an object of {Grifork::Executor::Task}
   def local(&task)
     return if @on_remote
     config_set(:local_task, Grifork::Executor::Task.new(:local, &task))
   end
 
+  # Define tasks to execute at remote host
+  # @param &task [Proc] Codes to be executed by an object of {Grifork::Executor::Task}
+  # @note In +:standalone+ mode, the task is executed at localhost actually.
+  #  In +:grifork+ mode, it is executed at remote hosts via +grifork+ command on remote hosts
   def remote(&task)
     if @on_remote
       config_set(:local_task, Grifork::Executor::Task.new(:local, &task))

data/lib/grifork/executor/grifork.rb

@@ -1,26 +1,28 @@
 class Grifork::Executor::Grifork
   include Grifork::Executable
-  attr :config
 
-  # @param cfg [Grifork::Config::Grifork] configured by DSL#grifork
-  def initialize(cfg)
-    @config = cfg
+  # Run grifork command on remote node.
+  #
+  # 1. Create +Griforkfile+ and copy it to remote
+  # 2. Login remote host by +ssh+ and execute +grifork+ command
+  def run(node)
+    c = config.grifork
+    ssh node.host, %(test -d "#{c.workdir}" || mkdir -p "#{c.workdir}")
+    rsync(node.host, config.griforkfile, "#{c.workdir}/Griforkfile")
+    prepare_grifork_hosts_file_on_remote(node)
+    ssh node.host, %(cd #{c.dir} && #{c.cmd} --file #{c.workdir}/Griforkfile --override-by #{c.workdir}/Griforkfile.hosts --on-remote)
   end
 
-  # Run grifork command on remote node:
-  #  1. Create Griforkfile and copy it to remote
-  #  2. ssh remote host and exec grifork
-  def run(node)
-    c = config
-    ssh node.host, %(test -d "#{c.workdir}" || mkdir -p "#{c.workdir}"), user: c.login
-    sh :rsync, ['-avzc', Grifork.config.griforkfile, "#{node.host}:#{c.workdir}/Griforkfile"]
+  private
+
+  def prepare_grifork_hosts_file_on_remote(node)
+    c = config.grifork
     hostsfile = Tempfile.create('Griforkfile.hosts')
     hostsfile.write(<<-EOS)
       hosts #{node.all_descendant_nodes.map(&:host)}
     EOS
     hostsfile.flush
-    sh :rsync, ['-avzc', hostsfile.path, "#{node.host}:#{c.workdir}/Griforkfile.hosts"]
+    rsync(node.host, hostsfile.path, "#{c.workdir}/Griforkfile.hosts")
     hostsfile.close
-    ssh node.host, %(cd #{c.dir} && #{c.cmd} --file #{c.workdir}/Griforkfile --override-by #{c.workdir}/Griforkfile.hosts --on-remote), [], user: c.login
   end
 end

data/lib/grifork/executor/task.rb

@@ -1,15 +1,40 @@
 class Grifork::Executor::Task
   include Grifork::Executable
-  attr :src, :dst
 
+  # Initialize with task
+  # @param &task [Proc] task to execute
   def initialize(type, &task)
     @type = type
     @task = task
   end
 
+  # Run the task
+  # @param src [String] Source hostname
+  # @param dst [String] Target hostname
   def run(src, dst)
-    @src = src
-    @dst = dst
+    Thread.current[:src] = src
+    Thread.current[:dst] = dst
     instance_eval(&@task)
   end
+
+  private
+
+  def src
+    Thread.current[:src]
+  end
+
+  def dst
+    Thread.current[:dst]
+  end
+
+  # Wrapper for {Grifork::Executable#rsync}
+  def rsync(from, to = nil)
+    super(dst, from, to)
+  end
+
+  # Wrapper for {Grifork::Executable#rsync_remote}
+  # @note This is for +remote+ task on +:standalone+ mode
+  def rsync_remote(from, to = nil)
+    super(src, dst, from, to)
+  end
 end

data/lib/grifork/graph.rb

@@ -30,7 +30,7 @@ class Grifork::Graph
   # Launch local and remote tasks through whole graph
   def launch_tasks
     # level = 1
-    Parallel.map(root.children, in_threads: root.children.size) do |node|
+    Parallel.map(root.children, config.parallel => root.children.size) do |node|
       logger.info("Run locally. localhost => #{node.host}")
       config.local_task.run(root.host, node.host)
     end
@@ -44,10 +44,14 @@ class Grifork::Graph
       logger.debug("#{root} Reached leaf. Nothing to do.")
       return
     end
-    Parallel.map(root.children, in_processes: root.children.size) do |child|
+    Parallel.map(root.children, config.parallel => root.children.size) do |child|
       logger.info("Run locally. localhost => #{child.host}")
       config.local_task.run(root.host, child.host)
-      Grifork::Executor::Grifork.new(config.grifork).run(child)
+      if child.children.size.zero?
+        logger.debug("#{child} Reached leaf. Nothing to do.")
+        next
+      end
+      Grifork::Executor::Grifork.new.run(child)
     end
   end
 
@@ -82,7 +86,7 @@ class Grifork::Graph
       return
     end
 
-    Parallel.map(families, in_threads: families.size) do |family|
+    Parallel.map(families, config.parallel => families.size) do |family|
       parent = family[0]
       child  = family[1]
       logger.info("Run remote [#{parent.level}]. #{parent.host} => #{child.host}")

data/lib/grifork/mixin/executable.rb

@@ -1,11 +1,20 @@
 module Grifork::Executable
+  include Grifork::Configured
   include Grifork::Loggable
 
   class CommandFailure < StandardError; end
   class SSHCommandFailure < StandardError; end
 
+  # Execute shell command at localhost
+  # @param cmd  [String] command
+  # @param args [Array]  arguments
   def sh(cmd, args = [])
-    logger.info("#sh start - #{cmd} #{args}")
+    if config.dry_run?
+      logger.info("[Dry-run] #sh | #{cmd} #{args}")
+      return
+    else
+      logger.info("#sh | #{cmd} #{args}")
+    end
     stat = Open3.popen3(cmd.to_s, *args) do |stdin, stdout, stderr, wait_thr|
       stdin.close
       stdout.each { |l| logger.info("#sh [out] #{l.chomp}") }
@@ -18,16 +27,23 @@ module Grifork::Executable
     end
   end
 
-  def ssh(host, cmd, args = [], user: nil)
+  # Execute +ssh+ with command to execute at remote host
+  # @param host [String] hostname
+  # @param cmd  [String] command
+  # @param args [Array]  arguments
+  def ssh(host, cmd, args = [])
     command = "#{cmd} #{args.shelljoin}"
-    logger.info("#ssh start - to: #{host}, command: #{cmd} #{args}")
-    ssh_args = [host]
-    ssh_args << user if user
-    Net::SSH.start(*ssh_args) do |ssh|
+    if config.dry_run?
+      logger.info("[Dry-run] #ssh @#{host} #{config.ssh.options} | #{cmd} #{args}")
+      return
+    else
+      logger.info("#ssh @#{host} #{config.ssh.options} | #{cmd} #{args}")
+    end
+    Net::SSH.start(host, nil, config.ssh.options) do |ssh|
       channel = ssh.open_channel do |ch|
         ch.exec(command) do |ch, success|
           unless success
-            raise SSHCommandFailure, "Failed to exec ssh command! on: #{host} command: #{cmd} #{args}"
+            raise SSHCommandFailure, "Failed to exec ssh command! - #{user}@#{host} | #{cmd} #{args}"
           end
 
           ch.on_data do |c, d|
@@ -43,17 +59,26 @@ module Grifork::Executable
     end
   end
 
-  def rsync(from, to = nil)
+  # Shorthand for +rsync+ command.
+  # Sync contents to target host
+  # @param host [String] Target hostname
+  # @param from [String] Path to source file or directory
+  # @param to   [String] Path to destination at remote host.
+  #  If you omit this param, it will be the same with +from+ param
+  def rsync(host, from, to = nil)
     to ||= from
-    sh :rsync, [*rsync_opts, from, "#{dst}:#{to}"]
+    sh :rsync, [*config.rsync_opts, from, "#{host}:#{to}"]
   end
 
-  def rsync_remote(from, to = nil, user: nil)
+  # Shorthand for +rsync+ command run by +ssh+ to source host
+  # Sync contents from source host to target host
+  # @param src  [String] Source hostname to login by +ssh+
+  # @param dst  [String] Target hostname
+  # @param from [String] Path to source file or directory
+  # @param to   [String] Path to destination at remote host.
+  #  If you omit this param, it will be the same with +from+ param
+  def rsync_remote(src, dst, from, to = nil)
     to ||= from
-    ssh src, :rsync, [*rsync_opts, from, "#{dst}:#{to}"], user: user
-  end
-
-  def rsync_opts
-    %w(-avzc --delete)
+    ssh src, :rsync, [*config.rsync_opts, from, "#{dst}:#{to}"]
   end
 end

data/lib/grifork/version.rb

@@ -1,3 +1,3 @@
 class Grifork
-  VERSION = '0.3.0'
+  VERSION = '0.4.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: grifork
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - key-amb
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-10-03 00:00:00.000000000 Z
+date: 2016-10-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: net-ssh
@@ -119,6 +119,7 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".travis.yml"
+- ".yardopts"
 - CHANGELOG.md
 - Gemfile
 - LICENSE