vagrant-rsync-blitz 2.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4d888bee8e4c30a23583d156de1e3cb3a59937428a25cb3a719b95796a65f67d
+  data.tar.gz: 6861ee4e30b00aacec05ac5238433925c687f49bcfa26d94c1c39214637c2139
+SHA512:
+  metadata.gz: 31014b6743114f9fb94e89355a189da76f3c471ea0c75a0f396f10f926c6e6be66ea0e0a6519dad2cae8034a5e6acdfbdb59da56d1fc738f2ab13e7f14329ed2
+  data.tar.gz: 296c1acec090dda0cf4a17418853f3cd90ed9d4296220328fdecdcf7ab317bd2a4564238e2d70df84c76df8bf16e930767da20edbf2188fc6b8910cfb9f45b3a

data/.gitignore

@@ -0,0 +1,20 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.swp
+*.swo
+example/files/*
+example/vagrant/.vagrant

data/.ruby-version

@@ -0,0 +1 @@
+2.6.2

data/CHANGELOG.md

@@ -0,0 +1,101 @@
+# Blitz
+
+## 2.0.0 (Dec 01, 2020)
+
+Hard fork and rename to `vagrant-rsync-blitz`
+
+- Rename configuration properties
+- Make default values less intrusive
+
+## 1.0.1 (Dec 01, 2020)
+
+This release adds compatibility with Vagrant 2.2.10+.
+
+FEATURES:
+
+- Add compatibility with Vagrant 2.2.10+
+
+# Gatling
+
+## 1.0.0 (June 02, 2020)
+
+This release adds compatibility with Vagrant 2.2.5+.
+
+Small parts of the example Vagrantfile and the Gemfile and Gemspec have also been cleaned up.
+
+FEATURES:
+
+- Add compatibility with Vagrant 2.2.5+. Thanks to @leejo for the PR. [GH-37]
+
+## 0.9.0 (June 28, 2015)
+
+This release adds two big features: Windows support and automatic sync on startup.
+
+It also adds the `config.gatling.rsync_on_startup` configuration option to turn automatic rsync on startup off if you
+do not want it.
+
+It also updates the Gemfile to use Vagrant 1.7.2 for development. The gem should still work with Vagrant 1.5.1+.
+
+FEATURES:
+
+- Add support for Windows. Thanks to @mfradcourt for wiring it up. [GH-21]
+- Add automatic sync startup on `vagrant up` or `vagrant reload` if rsync folders are present. [GH-14]
+
+## 0.1.0 (January 04, 2015)
+
+This release adds feature parity with Vagrant core rsync-auto by doing a sync when gatling-rsync is started.
+
+FEATURES:
+
+- Perform an initial rsync when the watcher starts. [GH-13]
+
+## 0.0.4 (August 24, 2014)
+
+This release adds notification of time and duration of rsyncs.
+
+It also adds the `config.gatling.time_format` configuration option to allow customization of the time format string when
+time information is printed to the console.
+
+It also updates the Gemfile to use Vagrant 1.6.4 so that I can test on Linux using the Docker provider. This should not
+have any impact on using the gem with 1.5.1+ versions of Vagrant, however.
+
+FEATURES:
+
+- Add output to note when an rsync finishes and how long it took. [GH-7, GH-10]
+
+BUG FIXES:
+
+- The plugin now correctly outputs an error instead of failing to load on Vagrant versions < 1.5.1. [GH-11]
+
+## 0.0.3 (May 02, 2014)
+
+Bugfix release.
+
+BUG FIXES:
+
+- Fix the plugin under multi-box environments. Thanks to @mattchannelgrabber. [GH-5]
+
+## 0.0.2 (April 27, 2014)
+
+Bugfix release.
+
+BUG FIXES:
+
+- Catch ThreadErrors (this sometimes happens in practice on OS X.)
+- Reflect that this plugin requires Vagrant 1.5.1+.
+
+## 0.0.1 (March 23, 2014)
+
+Initial release.
+
+FEATURES:
+
+- Implement an rb-fsevent adapter for Mac.
+- Implement an rb-inotify adapter for Linux.
+- Add the `vagrant gatling-rsync-auto` command.
+- Implement the first draft of a config option to allow changing the latency.
+
+## Backlog
+
+- Allow configuring and running the rsync daemon to avoid SSH overhead.
+- Get latency validation working.

data/Gemfile

@@ -0,0 +1,10 @@
+source "https://rubygems.org"
+
+group :development do
+  gem "vagrant", git: "https://github.com/hashicorp/vagrant.git"
+  gem "rubocop", require: false
+end
+
+group :plugins do
+  gem "vagrant-rsync-blitz", path: "."
+end

data/Gemfile.lock

@@ -0,0 +1,141 @@
+GIT
+  remote: https://github.com/hashicorp/vagrant.git
+  revision: 22795b161bf67a4c0ebbe32c9ce8777cb888c4a7
+  specs:
+    vagrant (2.2.11.dev)
+      bcrypt_pbkdf (~> 1.0.0)
+      childprocess (~> 4.0.0)
+      ed25519 (~> 1.2.4)
+      erubi
+      hashicorp-checkpoint (~> 0.1.5)
+      i18n (~> 1.8)
+      listen (~> 3.1)
+      log4r (~> 1.1.9, < 1.1.11)
+      mime (~> 0.4.4)
+      net-scp (~> 1.2.0)
+      net-sftp (~> 3.0)
+      net-ssh (~> 6.0)
+      rb-kqueue (~> 0.2.0)
+      rest-client (>= 1.6.0, < 3.0)
+      ruby_dep (<= 1.3.1)
+      rubyzip (~> 2.0)
+      vagrant_cloud (~> 2.0.3)
+      wdm (~> 0.1.0)
+      winrm (>= 2.3.4, < 3.0)
+      winrm-elevated (>= 1.2.1, < 2.0)
+      winrm-fs (>= 1.3.4, < 2.0)
+
+PATH
+  remote: .
+  specs:
+    vagrant-rsync-blitz (2.0.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.1)
+    bcrypt_pbkdf (1.0.1)
+    builder (3.2.4)
+    childprocess (4.0.0)
+    concurrent-ruby (1.1.7)
+    domain_name (0.5.20190701)
+      unf (>= 0.0.5, < 1.0.0)
+    ed25519 (1.2.4)
+    erubi (1.10.0)
+    ffi (1.13.1)
+    gssapi (1.3.1)
+      ffi (>= 1.0.1)
+    gyoku (1.3.1)
+      builder (>= 2.1.2)
+    hashicorp-checkpoint (0.1.5)
+    http-cookie (1.0.3)
+      domain_name (~> 0.5)
+    httpclient (2.8.3)
+    i18n (1.8.5)
+      concurrent-ruby (~> 1.0)
+    listen (3.3.3)
+      rb-fsevent (~> 0.10, >= 0.10.3)
+      rb-inotify (~> 0.9, >= 0.9.10)
+    little-plugger (1.1.4)
+    log4r (1.1.10)
+    logging (2.3.0)
+      little-plugger (~> 1.1)
+      multi_json (~> 1.14)
+    mime (0.4.4)
+    mime-types (3.3.1)
+      mime-types-data (~> 3.2015)
+    mime-types-data (3.2020.1104)
+    multi_json (1.15.0)
+    net-scp (1.2.1)
+      net-ssh (>= 2.6.5)
+    net-sftp (3.0.0)
+      net-ssh (>= 5.0.0, < 7.0.0)
+    net-ssh (6.1.0)
+    netrc (0.11.0)
+    nori (2.6.0)
+    parallel (1.20.1)
+    parser (2.7.2.0)
+      ast (~> 2.4.1)
+    rainbow (3.0.0)
+    rb-fsevent (0.10.4)
+    rb-inotify (0.10.1)
+      ffi (~> 1.0)
+    rb-kqueue (0.2.5)
+      ffi (>= 0.5.0)
+    regexp_parser (2.0.0)
+    rest-client (2.0.2)
+      http-cookie (>= 1.0.2, < 2.0)
+      mime-types (>= 1.16, < 4.0)
+      netrc (~> 0.8)
+    rexml (3.2.4)
+    rubocop (1.5.1)
+      parallel (~> 1.10)
+      parser (>= 2.7.1.5)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.0)
+      rexml
+      rubocop-ast (>= 1.2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 2.0)
+    rubocop-ast (1.3.0)
+      parser (>= 2.7.1.5)
+    ruby-progressbar (1.10.1)
+    ruby_dep (1.3.1)
+    rubyntlm (0.6.2)
+    rubyzip (2.3.0)
+    unf (0.1.4)
+      unf_ext
+    unf_ext (0.0.7.7)
+    unicode-display_width (1.7.0)
+    vagrant_cloud (2.0.3)
+      rest-client (~> 2.0.2)
+    wdm (0.1.1)
+    winrm (2.3.5)
+      builder (>= 2.1.2)
+      erubi (~> 1.8)
+      gssapi (~> 1.2)
+      gyoku (~> 1.0)
+      httpclient (~> 2.2, >= 2.2.0.2)
+      logging (>= 1.6.1, < 3.0)
+      nori (~> 2.0)
+      rubyntlm (~> 0.6.0, >= 0.6.1)
+    winrm-elevated (1.2.3)
+      erubi (~> 1.8)
+      winrm (~> 2.0)
+      winrm-fs (~> 1.0)
+    winrm-fs (1.3.5)
+      erubi (~> 1.8)
+      logging (>= 1.6.1, < 3.0)
+      rubyzip (~> 2.0)
+      winrm (~> 2.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  rubocop
+  vagrant!
+  vagrant-rsync-blitz!
+
+BUNDLED WITH
+   2.1.4

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Steven Merrill
+Copyright (c) 2020 Mitchell Nemitz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,99 @@
+# vagrant-rsync-blitz
+
+An rsync watcher for Vagrant 1.5.1+ that uses fewer host resources at the
+potential cost of more rsync actions.
+
+Forked from vagrant-gatling-rsync.
+
+## Getting started
+
+To get started, you need to have Vagrant 1.5.1 installed on your Linux, Mac, or
+Windows host machine. To install the plugin, use the following command.
+
+```bash
+vagrant plugin install vagrant-rsync-blitz
+```
+
+## Working with this plugin
+
+Add the following information to the Vagrantfile to set the coalescing
+threshold in seconds. If you do not set it, it will default to 2.
+
+You may also specify what
+[Time.strftime](http://www.ruby-doc.org/core-2.0.0/Time.html#method-i-strftime)
+options the plugin will use when it reports on completed rsyncs. The default is
+"%I:%M:%S %p".
+
+You will also need to have at least one synced folder set to type "rsync"
+to use the plugin.
+
+```ruby
+VAGRANTFILE_API_VERSION = "2"
+
+Vagrant.configure(VAGRANTFILE_API_VERSION) do |config|
+  config.vm.box = "hashicorp/precise64"
+
+  config.vm.synced_folder "../files", "/opt/vagrant/rsynced_folder", type: "rsync",
+    rsync__exclude: [".git/", ".idea/"]
+
+  # Configure the window for blitz to coalesce writes
+  if Vagrant.has_plugin?("vagrant-rsync-blitz")
+    config.blitz.latency = 3
+    config.blitz.time_format = "%H:%M:%S"
+  end
+
+  # Automatically sync when machines with rsync folders come up
+  config.blitz.autostart = true
+end
+```
+
+With the Vagrantfile configured in this fashion, you can run the following
+command to sync files.
+
+```bash
+vagrant rsync-blitz
+```
+
+## This plugin
+
+The built-in `rsync-auto` plugin sometimes uses a lot of CPU and disk I/O when
+it starts up on very large rsynced directories. This plugin is designed to
+work well with such large rsynced folders.
+
+The `rsync-auto` command that ships with Vagrant 1.5+ uses the listen gem. The
+Listen gem is quite thorough - it uses Celluloid to spin up an actor system
+and it checks file contents on OS X to ensure that running "touch" on a file
+(to do a write but not update its content) will not fire the rsync command.
+
+The downside of using Listen is that it takes a large amount of host resources
+to monitor large directory structures. This gem works well with to monitor
+directories hierarchies with 10,000-100,000 files.
+
+This gem's implementation is much closer to the underlying fsevent or inotify
+APIs, which allows for higher performance.
+
+## Event coalescing
+
+This plugin coalesces events for you. The default latency is 2 seconds.
+It is configurable through the `config.blitz.latency` parameter.
+If you specify a latency of two seconds, this plugin will not fire a
+`vagrant rsync` until two contiguous seconds without file events have passed.
+This will delay rsyncs from happening if many writes are happening on the host
+(during a `make` or a `git clone`, for example) until the activity has leveled off.
+
+## Building
+
+```
+```
+
+## Authors
+
+Steven Merrill (@stevenmerrill) originally had the idea to tap into rb-fsevent
+and rb-inotify to more efficiently rsync files.
+
+Doug Marcey (@dougmarcey) provided considerable guidance in the implementation
+of the coalescing functionality and wrote the initial sketch of the Linux and
+Windows adapters.
+
+Mitchell Nemitz (@mitchellnemitz) hard forked the plugin and added quality of
+life features and sane default configuration.

data/Rakefile

@@ -0,0 +1,3 @@
+require "rubygems"
+require "bundler/setup"
+Bundler::GemHelper.install_tasks

data/example/vagrant/Vagrantfile

@@ -0,0 +1,46 @@
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+# Vagrantfile API/syntax version. Don't touch unless you know what you're doing!
+VAGRANTFILE_API_VERSION = "2"
+
+Vagrant.configure(VAGRANTFILE_API_VERSION) do |config|
+  config.vm.box = "centos/7"
+
+  config.vm.provider "docker" do |d, override|
+    d.image = "smerrill/vagrant-centos"
+    d.has_ssh = true
+
+    # This is needed if you have non-Docker provisioners in the Vagrantfile.
+    override.vm.box = nil
+  end
+
+  config.vm.provider "lxc" do |d, override|
+    override.vm.box = "smerrill/centos-7"
+  end
+
+  # When using rsync-blitz in your projects, you should wrap these configs in
+  # an 'if Vagrant.has_plugin?("vagrant-rsync-blitz")' test.
+
+  # Configure the window for blitz to coalesce writes.
+  config.blitz.latency = 1.0
+  config.blitz.time_format = "%H:%M:%S"
+
+  # Blitz will run `vagrant rsync-blitz` after the machines in
+  # your Vagrant environment start if you set this to true.
+  config.blitz.autostart = true
+
+  # Add a multi-box setup.
+  config.vm.define "rsync", primary: true do |m|
+    m.vm.synced_folder "../files", "/opt/vagrant/rsynced_folder", type: "rsync",
+      rsync__exclude: [".git/", ".idea/"]
+  end
+
+  config.vm.define "rsync2", primary: true do |m|
+    m.vm.synced_folder "../files", "/opt/vagrant/rsynced_folder", type: "rsync",
+      rsync__exclude: [".git/", ".idea/"]
+  end
+
+  config.vm.define "norsync" do |m|
+  end
+end

data/lib/vagrant-rsync-blitz.rb

@@ -0,0 +1,19 @@
+require "vagrant-rsync-blitz/plugin"
+require "pathname"
+
+module VagrantPlugins
+  module RsyncBlitz
+    lib_path = Pathname.new(File.expand_path("../vagrant-rsync-blitz", __FILE__))
+    autoload :Errors, lib_path.join("errors")
+    autoload :ListenOSX, lib_path.join("listen/listenosx")
+    autoload :ListenLinux, lib_path.join("listen/listenlinux")
+    autoload :ListenWindows, lib_path.join("listen/listenwindows")
+
+    # This returns the path to the source of this plugin.
+    #
+    # @return [Pathname]
+    def self.source_root
+      @source_root ||= Pathname.new(File.expand_path("../../", __FILE__))
+    end
+  end
+end

data/lib/vagrant-rsync-blitz/action/startup_rsync.rb

@@ -0,0 +1,47 @@
+require "vagrant"
+
+module VagrantPlugins
+  module RsyncBlitz
+    class StartupRsync
+      include Vagrant::Action::Builtin::MixinSyncedFolders
+
+      def initialize(app, env)
+        @app = app
+        @blitz_startup_registered = false
+        @rsync_folder_count = 0
+      end
+
+      def call(env)
+        folders = synced_folders(env[:machine])
+        @rsync_folder_count += folders[:rsync].size if folders.key?(:rsync)
+
+        @app.call(env)
+
+        # Ensure only one at_exit block is registered.
+        return unless @blitz_startup_registered == false
+
+        return unless env[:machine].config.blitz.autostart == true
+
+        at_exit do
+          unless $!.is_a?(SystemExit)
+            env[:ui].warn "Vagrant's startup was interrupted by an exception."
+            exit 1
+          end
+
+          exit_status = $!.status
+          if exit_status != 0
+            env[:ui].warn "The previous process exited with exit code #{exit_status}."
+            exit exit_status
+          end
+
+          # Don't run if there are no rsynced folders.
+          unless @rsync_folder_count == 0 then
+            env[:machine].env.cli("rsync-blitz")
+          end
+        end
+
+        @blitz_startup_registered = true
+      end
+    end
+  end
+end

data/lib/vagrant-rsync-blitz/command/rsync_auto.rb

@@ -0,0 +1,162 @@
+require "log4r"
+require "optparse"
+
+require "vagrant"
+
+module VagrantPlugins
+  module RsyncBlitz
+    class RsyncBlitzAuto < Vagrant.plugin(2, :command)
+      # This is a sanity check to make sure no one is attempting to install
+      # this into an early Vagrant version.
+      if Vagrant::VERSION < "1.5.1"
+        raise Errors::Vagrant15RequiredError
+      end
+
+      include Vagrant::Action::Builtin::MixinSyncedFolders
+
+      def self.synopsis
+        "syncs rsync synced folders when folders change"
+      end
+
+      def execute
+        @logger = Log4r::Logger.new("vagrant::commands::rsync-blitz")
+
+        opts = OptionParser.new do |o|
+          o.banner = "Usage: vagrant rsync-blitz [vm-name]"
+          o.separator ""
+        end
+
+        # Parse the options and return if we don't have any target.
+        argv = parse_options(opts)
+        return if !argv
+
+        latency = nil
+
+        # Build up the paths that we need to listen to.
+        paths = {}
+        ignores = []
+        with_target_vms(argv) do |machine|
+          latency = machine.config.blitz.latency
+
+          folders = synced_folders(machine)[:rsync]
+          next if !folders || folders.empty?
+
+          # Get the SSH info for this machine so we can do an initial
+          # sync to the VM, just as core `vagrant rsync-auto` does.
+          ssh_info = machine.ssh_info
+          if ssh_info
+            machine.ui.info(I18n.t("vagrant.rsync_auto_initial"))
+            folders.each do |id, folder_opts|
+              VagrantPlugins::SyncedFolderRSync::RsyncHelper.rsync_single(machine, ssh_info, folder_opts)
+            end
+          end
+
+          folders.each do |id, folder_opts|
+            # If we marked this folder to not auto sync, then
+            # don't do it.
+            next if folder_opts.has_key?(:auto) && !folder_opts[:auto]
+
+            hostpath = folder_opts[:hostpath]
+            hostpath = File.expand_path(hostpath, machine.env.root_path)
+            paths[hostpath] ||= []
+            paths[hostpath] << {
+              id: id,
+              machine: machine,
+              opts: folder_opts,
+            }
+
+            if folder_opts[:exclude]
+              Array(folder_opts[:exclude]).each do |pattern|
+               if Gem::Version.new(Vagrant::VERSION) < Gem::Version.new("2.2.5")
+                 ignores << VagrantPlugins::SyncedFolderRSync::RsyncHelper.exclude_to_regexp(hostpath, pattern.to_s)
+               else
+                 ignores << VagrantPlugins::SyncedFolderRSync::RsyncHelper.exclude_to_regexp(pattern.to_s)
+                end
+              end
+            end
+          end
+        end
+
+        # Output to the user what paths we'll be watching
+        paths.keys.sort.each do |path|
+          paths[path].each do |path_opts|
+            path_opts[:machine].ui.info(I18n.t(
+              "vagrant.rsync_auto_path",
+              path: path.to_s,
+            ))
+          end
+        end
+
+        @logger.info("Listening to paths: #{paths.keys.sort.inspect}")
+        @logger.info("Ignoring #{ignores.length} paths:")
+        ignores.each do |ignore|
+          @logger.info("  -- #{ignore.to_s}")
+        end
+
+        case RUBY_PLATFORM
+        when /darwin/
+          ListenOSX.new(paths, ignores, latency, @logger, self.method(:callback)).run
+        when /linux/
+          ListenLinux.new(paths, ignores, latency, @logger, self.method(:callback)).run
+        when /cygwin|mswin|mingw|bccwin|wince|emx/
+          ListenWindows.new(paths, ignores, latency, @logger, self.method(:callback)).run
+        else
+          # @TODO: Raise this earlier?
+          raise Errors::OSNotSupportedError
+        end
+
+        0
+      end
+
+      # This callback gets called when any directory changes.
+      def callback(paths, ignores, modified)
+        @logger.info("File change callback called!")
+        @logger.info("  - Paths: #{paths.inspect}")
+        @logger.info("  - Ignores: #{ignores.inspect}")
+        @logger.info("  - Modified: #{modified.inspect}")
+
+        tosync = []
+        paths.each do |hostpath, folders|
+          # Find out if this path should be synced
+          found = catch(:done) do
+            modified.each do |changed|
+              match = nil
+              ignores.each do |ignore|
+                next unless match.nil?
+                match = ignore.match(changed)
+              end
+
+              next unless match.nil?
+              throw :done, true if changed.start_with?(hostpath)
+            end
+
+            # Make sure to return false if all else fails so that we
+            # don't sync to this machine.
+            false
+          end
+
+          # If it should be synced, store it for later
+          tosync << folders if found
+        end
+
+        # Sync all the folders that need to be synced
+        tosync.each do |folders|
+          folders.each do |opts|
+            ssh_info = opts[:machine].ssh_info
+            do_rsync(opts[:machine], ssh_info, opts[:opts]) if ssh_info
+          end
+        end
+      end
+
+      def do_rsync(machine, ssh_info, opts)
+        start_time = Time.new
+        VagrantPlugins::SyncedFolderRSync::RsyncHelper.rsync_single(machine, ssh_info, opts)
+        end_time = Time.new
+        machine.ui.info(I18n.t(
+          "vagrant_rsync_blitz.blitz_ran",
+          date: end_time.strftime(machine.config.blitz.time_format),
+          milliseconds: (end_time - start_time) * 1000))
+      end
+    end
+  end
+end

data/lib/vagrant-rsync-blitz/config.rb

@@ -0,0 +1,39 @@
+require "vagrant"
+
+module VagrantPlugins
+  module RsyncBlitz
+    class Config < Vagrant.plugin(2, :config)
+      attr_accessor :autostart
+      attr_accessor :latency
+      attr_accessor :time_format
+
+      def initialize
+        @autostart = UNSET_VALUE
+        @latency = UNSET_VALUE
+        @time_format = UNSET_VALUE
+      end
+
+      def finalize!
+        @autostart = false if @autostart == UNSET_VALUE
+        @latency = 2.0 if @latency == UNSET_VALUE
+        @time_format = "%I:%M:%S %p" if @time_format == UNSET_VALUE
+      end
+
+      def validate(machine)
+        errors = _detected_errors
+
+        if @latency == UNSET_VALUE
+          return
+        elsif not @latency.is_a? Numeric
+          @latency = 2.0
+          errors << "Latency must be a number, setting to 2.0"
+        elsif @latency < 0.2
+          @latency = 0.2
+          errors << "Latency must not be too low, setting to 0.2 seconds"
+        end
+
+        { "blitz" => errors }
+      end
+    end
+  end
+end

data/lib/vagrant-rsync-blitz/errors.rb

@@ -0,0 +1,19 @@
+require "vagrant"
+
+module VagrantPlugins
+  module RsyncBlitz
+    module Errors
+      class VagrantRsyncBlitzError < Vagrant::Errors::VagrantError
+        error_namespace("vagrant_rsync_blitz.errors")
+      end
+
+      class OSNotSupportedError < VagrantRsyncBlitzError
+        error_key(:os_not_supported)
+      end
+
+      class Vagrant15RequiredError < VagrantRsyncBlitzError
+        error_key(:vagrant_15_required)
+      end
+    end
+  end
+end

data/lib/vagrant-rsync-blitz/listen/listenlinux.rb

@@ -0,0 +1,43 @@
+require "rb-inotify"
+
+module VagrantPlugins
+  module RsyncBlitz
+    class ListenLinux
+      def initialize(paths, ignores, latency, logger, callback)
+        @paths = paths
+        @ignores = ignores
+        @latency = latency
+        @logger = logger
+        @callback = callback
+      end
+
+      def run
+        @logger.info("Listening via: rb-inotify on Linux.")
+
+        notifier = INotify::Notifier.new
+        @paths.keys.each do |path|
+          notifier.watch(path, :modify, :create, :delete, :recursive) {}
+        end
+
+        loop do
+          directories = Set.new
+          begin
+            loop do
+              events = []
+              events = Timeout::timeout(@latency) {
+                notifier.read_events
+              }
+              events.each { |e| directories << e.absolute_name }
+            end
+          rescue Timeout::Error
+            @logger.info("Breaking out of the loop at #{Time.now.to_s}.")
+          end
+
+          @logger.info("Detected changes to #{directories.inspect}.") unless directories.empty?
+
+          @callback.call(@paths, @ignores, directories) unless directories.empty?
+        end
+      end
+    end
+  end
+end

data/lib/vagrant-rsync-blitz/listen/listenosx.rb

@@ -0,0 +1,52 @@
+require "rb-fsevent"
+
+module VagrantPlugins
+  module RsyncBlitz
+    class ListenOSX
+      def initialize(paths, ignores, latency, logger, callback)
+        @paths = paths
+        @ignores = ignores
+        @latency = latency
+        @options = {
+          # We set this to a small value to ensure that we can coalesce the
+          # events together to prevent rsyncing too often under heavy write
+          # load.
+          :latency => 0.1,
+          :no_defer => false,
+        }
+        @logger = logger
+        @callback = callback
+      end
+
+      def run
+        @logger.info("Listening via: rb-fsevent on Mac OS X.")
+        changes = Queue.new
+
+        fsevent = FSEvent.new
+        fsevent.watch @paths.keys, @options do |directories|
+          directories.each { |d| changes << d }
+        end
+        Thread.new { fsevent.run }
+
+        loop do
+          directories = Set.new
+          begin
+            loop do
+              @logger.info("Starting the timeout at #{Time.now.to_s}.")
+              change = Timeout::timeout(@latency) {
+                changes.pop
+              }
+              directories << change unless change.nil?
+            end
+          rescue Timeout::Error, ThreadError
+            @logger.info("Breaking out of the loop at #{Time.now.to_s}.")
+          end
+
+          @logger.info("Detected changes to #{directories.inspect}.") unless directories.empty?
+
+          @callback.call(@paths, @ignores, directories) unless directories.empty?
+        end
+      end
+    end
+  end
+end

data/lib/vagrant-rsync-blitz/listen/listenwindows.rb

@@ -0,0 +1,45 @@
+# @TODO: Note that this is entirely untested and not yet implemented.
+
+require "wdm"
+
+module VagrantPlugins
+  module RsyncBlitz
+    class ListenWindows
+      def initialize(paths, ignores, latency, logger, callback)
+        @paths = paths
+        @ignores = ignores
+        @latency = latency
+        @logger = logger
+        @callback = callback
+      end
+
+      def run
+        @logger.info("Listening via: WDM on Windows.")
+        monitor = WDM::Monitor.new
+        changes = Queue.new
+        @paths.keys.each do |path|
+          monitor.watch_recursively(path.dup) { |change| changes << change }
+        end
+        Thread.new { monitor.run! }
+
+        loop do
+          directories = Set.new
+          begin
+            loop do
+              change = Timeout::timeout(@latency) {
+                changes.pop
+              }
+              directories << change.path
+            end
+          rescue Timeout::Error
+            @logger.info("Breaking out of the loop at #{Time.now.to_s}.")
+          end
+
+          @logger.info(directories.inspect) unless directories.empty?
+
+          @callback.call(@paths, @ignores, directories) unless directories.empty?
+        end
+      end
+    end
+  end
+end

data/lib/vagrant-rsync-blitz/plugin.rb

@@ -0,0 +1,40 @@
+begin
+  require "vagrant"
+rescue LoadError
+  raise "The vagrant-rsync-blitz plugin must be run within Vagrant."
+end
+
+module VagrantPlugins
+  module RsyncBlitz
+    class Plugin < Vagrant.plugin(2)
+      name "Rsync Blitz"
+      description <<-DESC
+      Rsync large project directories to your Vagrant VM without using many resources on the host.
+      DESC
+
+      # This initializes the internationalization strings.
+      def self.setup_i18n
+        I18n.load_path << File.expand_path("locales/en.yml", RsyncBlitz.source_root)
+        I18n.reload!
+      end
+
+      action_hook "startup-rsync" do |hook|
+        setup_i18n
+        require_relative "action/startup_rsync"
+        hook.after Vagrant::Action::Builtin::SyncedFolders, StartupRsync
+      end
+
+      command "rsync-blitz" do
+        setup_i18n
+
+        require_relative "command/rsync_auto"
+        RsyncBlitzAuto
+      end
+
+      config "blitz" do
+        require_relative "config"
+        Config
+      end
+    end
+  end
+end

data/lib/vagrant-rsync-blitz/version.rb

@@ -0,0 +1,5 @@
+module VagrantPlugins
+  module RsyncBlitz
+    VERSION = "2.0.0"
+  end
+end

data/locales/en.yml

@@ -0,0 +1,9 @@
+en:
+  vagrant_rsync_blitz:
+    blitz_ran: |-
+      %{date}: The rsync operation completed in %{milliseconds} milliseconds.
+    errors:
+      os_not_supported: |-
+        The vagrant-rsync-blitz plugin does not support your OS.
+      vagrant_15_required: |-
+        The vagrant-rsync-blitz plugin requires Vagrant 1.5.1 or newer to function.

data/vagrant-rsync-blitz.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "vagrant-rsync-blitz/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "vagrant-rsync-blitz"
+  spec.version       = VagrantPlugins::RsyncBlitz::VERSION
+  spec.authors       = ["Steven Merrill", "Mitchell Nemitz"]
+  spec.email         = ["steven.merrill@gmail.com", "mitchell.nemitz@gmail.com"]
+  spec.summary       = %q{A lighter-weight Vagrant plugin for watching and rsyncing directories.}
+  spec.description   = %q{The rsync-blitz plugin runs on Mac and Linux and is far less CPU-intensive than the built-in rsync-auto.}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject {|f| f.start_with?("example/files")}
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "pry"
+end

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification
+name: vagrant-rsync-blitz
+version: !ruby/object:Gem::Version
+  version: 2.0.0
+platform: ruby
+authors:
+- Steven Merrill
+- Mitchell Nemitz
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2020-12-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: The rsync-blitz plugin runs on Mac and Linux and is far less CPU-intensive
+  than the built-in rsync-auto.
+email:
+- steven.merrill@gmail.com
+- mitchell.nemitz@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".ruby-version"
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- example/vagrant/Vagrantfile
+- lib/vagrant-rsync-blitz.rb
+- lib/vagrant-rsync-blitz/action/startup_rsync.rb
+- lib/vagrant-rsync-blitz/command/rsync_auto.rb
+- lib/vagrant-rsync-blitz/config.rb
+- lib/vagrant-rsync-blitz/errors.rb
+- lib/vagrant-rsync-blitz/listen/listenlinux.rb
+- lib/vagrant-rsync-blitz/listen/listenosx.rb
+- lib/vagrant-rsync-blitz/listen/listenwindows.rb
+- lib/vagrant-rsync-blitz/plugin.rb
+- lib/vagrant-rsync-blitz/version.rb
+- locales/en.yml
+- vagrant-rsync-blitz.gemspec
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.4
+signing_key:
+specification_version: 4
+summary: A lighter-weight Vagrant plugin for watching and rsyncing directories.
+test_files: []