vagrant-notify-forwarder-christhomas 0.7.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ebd442143f0bfe525439a82b8925276cf3445c5ecade651897eb8e0f8dc75f9a
+  data.tar.gz: 854a72e1dbb009415d0eb9d59d4c099e2883bcb7b6d0ef288c2e269cb3728cd4
+SHA512:
+  metadata.gz: e90f2898da93aa0466704842678f5c268c6efd614f01721354beaba4a4b761d20b1f20ddc38b66e2e9b3d539cf127d6fc698fb326873153a58f101aa9353e957
+  data.tar.gz: 04cf72017184d7f7858408b49ab6a49cc034d3eee25a2f60e0f3542df90c76c98d72a14866c2778352d8ca6003d82c9d6d12a8e6d85dca5c126d5bf7dd9b9d03

data/.github/workflows/release.yml

@@ -0,0 +1,39 @@
+name: Release gem
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.3'
+
+      - name: Build gem
+        run: gem build vagrant-notify-forwarder-christhomas.gemspec
+
+      - name: Publish to RubyGems
+        uses: rubygems/release-gem@v1
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: vagrant-notify-forwarder-christhomas-*.gem
+          body: |
+            vagrant-notify-forwarder-christhomas ${{ github.ref_name }}
+
+            ## Install
+            ```
+            vagrant plugin install vagrant-notify-forwarder-christhomas
+            ```

data/.gitignore

@@ -0,0 +1,28 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+Vagrantfile
+/.vagrant
+Gemfile.lock
+.idea
+.history
+vendor
+.DS_Store

data/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+## v0.7.0
+
+- Added Linux armv7l (ARM32) guest support
+- Updated all notify-forwarder binaries to v1.1.0
+- Updated all SHA256 checksums
+- Added armv7l to hardware name detection
+
+## v0.6.3
+
+- Added auto-correct for UDP port conflicts — tries next 10 ports if default is in use
+- Added `auto_correct: true` to forwarded port declaration
+- Added GitHub Actions release pipeline (triggers on version tags)
+- Added Homebrew formula for installation via `brew install antimatter-studios/tap/vagrant-notify-forwarder`
+
+## v0.6.2
+
+- Added configurable binary sources via `config.notify_forwarder.binaries`
+- Added support for macOS ARM64 (Apple Silicon) and Linux ARM64
+- Updated notify-forwarder binaries to v1.0.0

data/Gemfile

@@ -0,0 +1,10 @@
+source "https://rubygems.org"
+
+group :development do
+  gem "rake"
+  gem "vagrant", git: "https://github.com/hashicorp/vagrant.git"
+end
+
+group :plugins do
+  gem "vagrant-notify-forwarder2", path: "."
+end

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 mhallin
+
+MIT License
+
+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,138 @@
+# Vagrant file system notification forwarder plugin
+
+A vagrant plugin that uses [notify-forwarder](https://github.com/mhallin/notify-forwarder) to
+forward file system events from the host to the guest automatically on all shared folders.
+
+This is useful for auto reloading file systems that rebuild when files change. Normally, they have
+to use CPU intensive polling when watching shared folders. This plugin makes them able to use
+inotify or similar for improved performance and reduced CPU usage.
+
+## Installation
+
+### Via Homebrew (recommended)
+
+```bash
+brew install antimatter-studios/tap/vagrant-notify-forwarder
+```
+
+This downloads the gem and runs `vagrant plugin install` automatically.
+
+### Manual install
+
+```bash
+vagrant plugin install vagrant-notify-forwarder2
+```
+
+Or from a specific release:
+
+```bash
+curl -fsSL -o /tmp/vagrant-notify-forwarder2.gem \
+  https://github.com/christhomas/vagrant-notify-forwarder/releases/download/v0.6.3/vagrant-notify-forwarder2-0.6.3.gem
+vagrant plugin install /tmp/vagrant-notify-forwarder2.gem
+```
+
+After installing, reload your Vagrant environment:
+
+```bash
+vagrant reload
+```
+
+## Configuration
+
+### Port
+
+By default, the plugin uses UDP port 29324. If multiple VMs are running, the
+port is automatically corrected to the next available port (tries up to 10 ports).
+
+To set a specific port:
+
+```ruby
+config.notify_forwarder.port = 22020
+```
+
+### Disabling
+
+To disable the plugin for a specific machine:
+
+```ruby
+config.notify_forwarder.enable = false
+```
+
+### Permissions
+
+The client in the guest OS runs as root by default, assuming passwordless `sudo` works. To disable
+privilege escalation:
+
+```ruby
+config.notify_forwarder.run_as_root = false
+```
+
+### Overriding binary sources
+
+The plugin ships with a default map of download URLs and SHA256 checksums for each supported
+`[os, hardware]` combination. You can override or extend the map via
+`config.notify_forwarder.binaries`:
+
+```ruby
+config.notify_forwarder.binaries = {
+  [:darwin, :arm64] => {
+    url: "https://example.com/notify-forwarder-osx-arm64",
+    sha256: "deadbeef..."
+  },
+  [:linux, :riscv64] => [
+    "https://example.com/notify-forwarder-linux-riscv64",
+    "cafebabe..."
+  ]
+}
+```
+
+You may supply each entry either as an array `[url, sha256]` or a hash with `:url`/`:sha256` keys.
+Entries you omit continue using the built-in defaults.
+
+## Supported platforms
+
+The plugin downloads binaries for supported platforms:
+
+| Platform | Host | Guest |
+|----------|------|-------|
+| Linux arm64 | ✓ | ✓ |
+| Linux armv7l | — | ✓ |
+| Linux x86_64 | ✓ | ✓ |
+| macOS arm64 | ✓ | — |
+| macOS x86_64 | ✓ | — |
+
+## Development
+
+Use Bundler and the project `Rakefile` to keep all tooling local to the repository.
+
+1. Install dependencies:
+
+   ```bash
+   rake dev:bundle
+   ```
+
+2. Build the gem:
+
+   ```bash
+   bundle exec rake dev:build
+   ```
+
+3. Install locally for testing:
+
+   ```bash
+   bundle exec rake dev:install
+   ```
+
+4. Launch or reload Vagrant:
+
+   ```bash
+   bundle exec rake dev:up
+   bundle exec rake dev:reload
+   ```
+
+## Contributors
+
+* [CharlieC3](https://github.com/CharlieC3)
+* [hedinfaok](https://github.com/hedinfaok)
+* [seff](https://github.com/seff)
+* [christhomas](https://github.com/christhomas)

data/Rakefile

@@ -0,0 +1,46 @@
+require 'rubygems'
+require 'bundler/gem_tasks'
+
+$stdout.sync = true
+$stderr.sync = true
+
+# Change to the directory of this file.
+Dir.chdir(File.expand_path("../", __FILE__))
+
+GEMSPEC = Gem::Specification.load('vagrant-notify-forwarder.gemspec')
+raise 'Unable to load vagrant-notify-forwarder.gemspec' unless GEMSPEC
+GEM_PACKAGE = File.join('pkg', "#{GEMSPEC.name}-#{GEMSPEC.version}.gem")
+
+namespace :dev do
+  desc 'Install gems locally under vendor/bundle'
+  task :bundle do
+    sh "bundle config set --local path 'vendor/bundle'"
+    sh "bundle install --path 'vendor/bundle'"
+  end
+
+  desc 'Build the plugin gem into pkg/'
+  task :build => :bundle do
+    Rake::Task['build'].reenable
+    Rake::Task['build'].invoke
+  end
+
+  desc 'Install the freshly built gem into your Vagrant plugins'
+  task :install => :build do
+    sh "vagrant plugin install ./#{GEM_PACKAGE}"
+  end
+
+  desc 'Push the gem to RubyGems (requires configured credentials)'
+  task :publish => :build do
+    sh "gem push #{GEM_PACKAGE}"
+  end
+
+  desc 'Run vagrant up using the bundled environment and local plugin path'
+  task :up => :bundle do
+    sh 'bundle exec vagrant up'
+  end
+
+  desc 'Reload the running Vagrant environment via Bundler'
+  task :reload => :bundle do
+    sh 'bundle exec vagrant reload'
+  end
+end

data/lib/vagrant-notify-forwarder/action/check_boot_state.rb

@@ -0,0 +1,18 @@
+module VagrantPlugins
+  module VagrantNotifyForwarder
+    module Action
+      class CheckBootState
+        def initialize(app, env)
+          @app = app
+        end
+
+        def call(env)
+          return unless env[:machine].config.notify_forwarder.enable
+          $BOOT_SAVED = env[:machine].state.id == :saved
+
+          @app.call env
+        end
+      end
+    end
+  end
+end

data/lib/vagrant-notify-forwarder/action/start_client_forwarder.rb

@@ -0,0 +1,59 @@
+require 'vagrant-notify-forwarder/utils'
+
+module VagrantPlugins
+  module VagrantNotifyForwarder
+    module Action
+      class StartClientForwarder
+        def initialize(app, env)
+          @app = app
+        end
+
+        def ensure_binary_downloaded(env)
+          os = :unsupported
+          hardware = :unsupported
+
+          env[:machine].communicate.execute('uname -s') do |type, data|
+            env[:ui].info "Notify-forwarder: Detected client operating system: #{data}"
+            os = Utils.parse_os_name data if type == :stdout
+          end
+
+          env[:machine].communicate.execute('uname -m') do |type, data|
+            env[:ui].info "Notify-forwarder: Detected client hardware: #{data}"
+            hardware = Utils.parse_hardware_name data if type == :stdout
+          end
+
+          env[:ui].error "Notify-forwarder: Unsupported client operating system (detected: #{os})" if os == :unsupported
+          env[:ui].error "Notify-forwarder: Unsupported client hardware (detected: #{hardware})" if hardware == :unsupported
+
+          if os != :unsupported and hardware != :unsupported
+            Utils.ensure_binary_downloaded env, os, hardware
+          end
+        end
+
+        def call(env)
+          @app.call env
+
+          return if $BOOT_SAVED
+
+          return unless env[:machine].config.notify_forwarder.enable
+
+          path = ensure_binary_downloaded env
+          return unless path
+
+          port = env[:machine].config.notify_forwarder.port
+
+          start_command = "nohup /tmp/notify-forwarder receive -p #{port} &"
+
+          if env[:machine].config.notify_forwarder.run_as_root
+            start_command = "sudo #{start_command}"
+          end
+
+          env[:machine].communicate.upload(path, "/tmp/notify-forwarder")
+          env[:ui].output("Starting notify-forwarder ...")
+          env[:machine].communicate.execute(start_command)
+          env[:ui].detail("Notify-forwarder: guest listening for file change notifications on 0.0.0.0:#{port}.")
+        end
+      end
+    end
+  end
+end

data/lib/vagrant-notify-forwarder/action/start_host_forwarder.rb

@@ -0,0 +1,61 @@
+require 'vagrant-notify-forwarder/utils'
+
+module VagrantPlugins
+  module VagrantNotifyForwarder
+    module Action
+      class StartHostForwarder
+        def initialize(app, env)
+          @app = app
+        end
+
+        def ensure_binary_downloaded(env)
+          os = Utils.parse_os_name `uname -s`
+          hardware = Utils.parse_hardware_name `uname -m`
+
+          env[:ui].error "Notify-forwarder: Unsupported host operating system (detected: #{os})" if os == :unsupported
+          env[:ui].error "Notify-forwarder: Unsupported host hardware (detected: #{hardware})" if hardware == :unsupported
+
+          if os != :unsupported and hardware != :unsupported
+            Utils.ensure_binary_downloaded env, os, hardware
+          end
+        end
+
+        def start_watcher(env, command)
+          pid = Process.spawn command
+          Process.detach(pid)
+
+          pidfile = Utils.host_pidfile env
+          pidfile.open('a+') do |f|
+            f.write("#{pid}\n")
+          end
+        end
+
+        def call(env)
+          if env[:machine].config.notify_forwarder.enable
+            port = env[:machine].config.notify_forwarder.port
+            env[:machine].config.vm.network :forwarded_port, host: port, guest: port, protocol: 'udp', auto_correct: true
+          end
+
+          @app.call env
+
+          if env[:machine].config.notify_forwarder.enable
+            path = ensure_binary_downloaded env
+            return unless path
+
+            env[:machine].config.vm.synced_folders.each do |id, options|
+              unless options[:disabled]
+                hostpath = File.expand_path(options[:hostpath], env[:root_path])
+                guestpath = options[:guestpath]
+
+                args = "watch -c 127.0.0.1:#{port} #{hostpath} #{guestpath}"
+                start_watcher env, "#{path} #{args}"
+                env[:ui].detail("Notify-forwarder: host sending file change notifications to 127.0.0.1:#{port}")
+                env[:ui].detail("Notify-forwarder: host forwarding notifications on #{hostpath} to #{guestpath}")
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/vagrant-notify-forwarder/action/stop_host_forwarder.rb

@@ -0,0 +1,34 @@
+require 'vagrant-notify-forwarder/utils'
+
+module VagrantPlugins
+  module VagrantNotifyForwarder
+    module Action
+      class StopHostForwarder
+        def initialize(app, env)
+          @app = app
+        end
+
+        def call(env)
+          @app.call env
+
+          return unless env[:machine].config.notify_forwarder.enable
+
+          pidfile = Utils.host_pidfile env
+
+          if File.exist? pidfile
+            pidfile.open('r') do |f|
+              f.readlines.each do |process|
+                pid = process.to_i
+                begin
+                  Process.kill 'TERM', pid
+                rescue Errno::ESRCH
+                end
+              end
+              pidfile.delete
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/vagrant-notify-forwarder/config.rb

@@ -0,0 +1,111 @@
+module VagrantPlugins
+  module VagrantNotifyForwarder
+    class Config < Vagrant.plugin(2, :config)
+      attr_accessor :port
+      attr_accessor :enable
+      attr_accessor :run_as_root
+      attr_accessor :binaries
+
+      DEFAULT_BINARIES = {
+        [:linux, :x86_64] => [
+          'https://github.com/christhomas/notify-forwarder/releases/download/v1.1.0/notify-forwarder-linux_x86_64',
+          'baee3d06acccd126b37c8e9abd73cfd3ab3a83886eeb7572d36d9e0e38177a24'
+        ],
+        [:linux, :arm64] => [
+          'https://github.com/christhomas/notify-forwarder/releases/download/v1.1.0/notify-forwarder-linux_arm64',
+          'a9bace65cbefc99db78e2e6fb47e55ed9df2ddf460c173dee7400d70de25c9c0'
+        ],
+        [:linux, :armv7l] => [
+          'https://github.com/christhomas/notify-forwarder/releases/download/v1.1.0/notify-forwarder-linux_armv7l',
+          '35e05a9af6cb50417919b0cc579b0ecdc87160be811bdac651488e3bbeb19bbe'
+        ],
+        [:darwin, :x86_64] => [
+          'https://github.com/christhomas/notify-forwarder/releases/download/v1.1.0/notify-forwarder-darwin_x86_64',
+          '195fde3f90425c8e73b59d832f9cf5ecf98857fa3b992ba1bd6cfbdd749ca96a'
+        ],
+        [:darwin, :arm64] => [
+          'https://github.com/christhomas/notify-forwarder/releases/download/v1.1.0/notify-forwarder-darwin_arm64',
+          'ac78532672553174bfc20e3c3d5d5c9fdccfe51d5fee5521bf34a3168d4acb34'
+        ],
+      }.freeze
+
+      def initialize
+        @port = UNSET_VALUE
+        @enable = UNSET_VALUE
+        @run_as_root = UNSET_VALUE
+        @binaries = UNSET_VALUE
+      end
+
+      def finalize!
+        @port = 29324 if @port == UNSET_VALUE
+        @port = auto_correct_port(@port)
+        @enable = true if @enable == UNSET_VALUE
+        @run_as_root = true if @run_as_root == UNSET_VALUE
+        @binaries = prepare_binaries(@binaries)
+      end
+
+      private
+
+      def auto_correct_port(port)
+        require 'socket'
+        10.times do
+          begin
+            socket = UDPSocket.new
+            socket.bind('127.0.0.1', port)
+            socket.close
+            return port
+          rescue Errno::EADDRINUSE
+            port += 1
+          end
+        end
+        port
+      end
+
+      def prepare_binaries(value)
+        defaults = DEFAULT_BINARIES.transform_values(&:dup)
+
+        return defaults if value == UNSET_VALUE || value.nil?
+
+        overrides = normalize_binary_map(value)
+        defaults.merge(overrides) do |_key, _old, new_value|
+          Array(new_value)
+        end
+      end
+
+      def normalize_binary_map(map)
+        map.each_with_object({}) do |(key, raw_value), acc|
+          normalized_key = normalize_binary_key(key)
+          acc[normalized_key] = normalize_binary_value(raw_value)
+        end
+      end
+
+      def normalize_binary_key(key)
+        tuple = Array(key).map do |segment|
+          segment.respond_to?(:to_sym) ? segment.to_sym : segment
+        end
+
+        unless tuple.length == 2
+          raise ArgumentError, "Binary definitions must use two-part keys like [:linux, :x86_64]"
+        end
+
+        [tuple[0], tuple[1]]
+      end
+
+      def normalize_binary_value(value)
+        case value
+        when Array
+          value
+        when Hash
+          url = value[:url] || value['url']
+          checksum = value[:sha256] || value['sha256']
+          if url.nil? || checksum.nil?
+            raise ArgumentError, "Binary definition hash must include :url and :sha256 keys"
+          end
+          [url, checksum]
+        else
+          raise ArgumentError, "Binary definition must be an Array [url, sha256] or Hash with :url/:sha256"
+        end
+      end
+    end
+  end
+end

data/lib/vagrant-notify-forwarder/plugin.rb

@@ -0,0 +1,71 @@
+require 'vagrant'
+
+$BOOT_SAVED = false
+
+module VagrantPlugins
+  module VagrantNotifyForwarder
+    class Plugin < Vagrant.plugin('2')
+      name 'vagrant-notify-forwarder'
+      description 'Wrapper around the notify-forwarder file system event forwarder'
+
+      register_boot_hooks = lambda do |hook|
+        require_relative 'action/start_host_forwarder'
+        # require_relative 'action/stop_host_forwarder'
+        require_relative 'action/start_client_forwarder'
+        require_relative 'action/check_boot_state'
+
+        hook.before VagrantPlugins::ProviderVirtualBox::Action::Resume,
+                    VagrantPlugins::VagrantNotifyForwarder::Action::CheckBootState
+        hook.after Vagrant::Action::Builtin::Provision,
+                   VagrantPlugins::VagrantNotifyForwarder::Action::StartHostForwarder
+        hook.after VagrantPlugins::VagrantNotifyForwarder::Action::StartHostForwarder,
+                   VagrantPlugins::VagrantNotifyForwarder::Action::StartClientForwarder
+      end
+
+      register_suspend_hooks = lambda do |hook|
+        require_relative 'action/stop_host_forwarder'
+
+        hook.before VagrantPlugins::ProviderVirtualBox::Action::Suspend,
+                    VagrantPlugins::VagrantNotifyForwarder::Action::StopHostForwarder
+      end
+
+      register_resume_hooks = lambda do |hook|
+        require_relative 'action/start_host_forwarder'
+
+        hook.after VagrantPlugins::ProviderVirtualBox::Action::Provision,
+                    VagrantPlugins::VagrantNotifyForwarder::Action::StartHostForwarder
+      end
+
+      register_halt_hooks = lambda do |hook|
+        require_relative 'action/stop_host_forwarder'
+
+        hook.before Vagrant::Action::Builtin::GracefulHalt,
+                    VagrantPlugins::VagrantNotifyForwarder::Action::StopHostForwarder
+      end
+
+      register_destroy_hooks = lambda do |hook|
+        require_relative 'action/stop_host_forwarder'
+
+        hook.before Vagrant::Action::Builtin::GracefulHalt,
+                    VagrantPlugins::VagrantNotifyForwarder::Action::StopHostForwarder
+      end
+
+      config(:notify_forwarder) do
+        require_relative 'config'
+        Config
+      end
+
+      action_hook :start_notify_forwarder, :machine_action_up, &register_boot_hooks
+      action_hook :start_notify_forwarder, :machine_action_reload, &register_boot_hooks
+
+      action_hook :stop_notify_forwarder, :machine_action_suspend, &register_suspend_hooks
+      action_hook :stop_notify_forwarder, :machine_action_resume, &register_resume_hooks
+
+      action_hook :stop_notify_forwarder, :machine_action_halt, &register_halt_hooks
+      action_hook :stop_notify_forwarder, :machine_action_reload, &register_halt_hooks
+
+      action_hook :stop_notify_forwarder, :machine_action_destroy, &register_destroy_hooks
+
+    end
+  end
+end

data/lib/vagrant-notify-forwarder/utils.rb

@@ -0,0 +1,98 @@
+require 'uri'
+require 'vagrant/util/downloader'
+
+module VagrantPlugins
+  module VagrantNotifyForwarder
+    class Utils
+      @@OS_NAMES = {
+          "Linux" => :linux,
+          "Darwin" => :darwin,
+          "FreeBSD" => :freebsd,
+      }
+
+      @@HARDWARE_NAMES = {
+          "x86_64" => :x86_64,
+          "amd64" => :x86_64,
+          "arm64" => :arm64,
+          "aarch64" => :arm64,
+          "armv7l" => :armv7l,
+      }
+
+      def self.parse_os_name(data)
+        @@OS_NAMES[data.strip] or :unsupported
+      end
+
+      def self.parse_hardware_name(data)
+        @@HARDWARE_NAMES[data.strip] or :unsupported
+      end
+
+      def self.ensure_binary_downloaded(env, os, hardware)
+        config = env.fetch(:machine).config.notify_forwarder
+        download_map = config.binaries
+        url, sha256sum = download_map[[os, hardware]]
+
+        unless url && sha256sum
+          env[:ui].error "Notify-forwarder: No binary configured for host '#{os}' '#{hardware}'"
+          return
+        end
+
+        expanded_url = expand_binary_url(url)
+        env[:ui].info "Notify-forwarder: Using binary '#{expanded_url}' (sha256 #{sha256sum[0,8]}...) for '#{os}' '#{hardware}'"
+
+        uri = safe_parse_uri(expanded_url)
+        basename = File.basename(uri ? uri.path : expanded_url)
+        path = env[:tmp_path].join basename
+        should_download = true
+
+        if File.exist? path
+          digest = Digest::SHA256.file(path).hexdigest
+
+          if digest == sha256sum
+            should_download = false
+          end
+        end
+
+        if should_download
+          env[:ui].detail 'Notify-forwarder: Downloading client'
+          downloader = Vagrant::Util::Downloader.new expanded_url, path
+          downloader.download!
+        end
+
+        File.chmod(0755, path)
+
+        path
+      end
+
+      def self.expand_binary_url(url)
+        expanded = expand_environment(url.to_s)
+
+        if expanded.start_with?('file://')
+          uri = URI.parse(expanded)
+          uri.path = File.expand_path(uri.path)
+          return uri.to_s
+        end
+
+        return expanded if expanded =~ %r{^[a-zA-Z][a-zA-Z0-9+.-]*://}
+
+        File.expand_path(expanded)
+      end
+
+      def self.expand_environment(value)
+        value.gsub(/\$(\{)?([A-Za-z0-9_]+)\}?/) do
+          key = Regexp.last_match(2)
+          ENV.fetch(key, '')
+        end
+      end
+
+      def self.safe_parse_uri(url)
+        URI.parse(url)
+      rescue URI::InvalidURIError
+        nil
+      end
+
+      def self.host_pidfile(env)
+        env[:machine].data_dir.join('notify_watcher_host_pid')
+      end
+    end
+  end
+end

data/lib/vagrant-notify-forwarder/version.rb

@@ -0,0 +1,5 @@
+module VagrantPlugins
+  module VagrantNotifyForwarder
+    VERSION = "0.7.0"
+  end
+end

data/lib/vagrant-notify-forwarder-christhomas.rb

@@ -0,0 +1 @@
+require 'vagrant-notify-forwarder'

data/lib/vagrant-notify-forwarder.rb

@@ -0,0 +1,10 @@
+require 'vagrant-notify-forwarder/plugin'
+require 'vagrant-notify-forwarder/config'
+
+module VagrantPlugins
+  module VagrantNotifyForwarder
+    def self.source_root
+      @source_root ||= Pathname.new(File.expand_path('../../', __FILE__))
+    end
+  end
+end

data/vagrant-notify-forwarder-christhomas.gemspec

@@ -0,0 +1,19 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'vagrant-notify-forwarder/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "vagrant-notify-forwarder-christhomas"
+  spec.version       = VagrantPlugins::VagrantNotifyForwarder::VERSION
+  spec.authors       = ["Chris Thomas"]
+  spec.email         = ["chris.alex.thomas@gmail.com"]
+  spec.summary       = "A vagrant plugin that forwards file system events from the host to the guest"
+  spec.description   = spec.summary
+  spec.homepage      = "https://github.com/christhomas/vagrant-notify-forwarder"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.require_paths = ["lib"]
+end
+

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification
+name: vagrant-notify-forwarder-christhomas
+version: !ruby/object:Gem::Version
+  version: 0.7.0
+platform: ruby
+authors:
+- Chris Thomas
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-04-03 00:00:00.000000000 Z
+dependencies: []
+description: A vagrant plugin that forwards file system events from the host to the
+  guest
+email:
+- chris.alex.thomas@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/release.yml"
+- ".gitignore"
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/vagrant-notify-forwarder-christhomas.rb
+- lib/vagrant-notify-forwarder.rb
+- lib/vagrant-notify-forwarder/action/check_boot_state.rb
+- lib/vagrant-notify-forwarder/action/start_client_forwarder.rb
+- lib/vagrant-notify-forwarder/action/start_host_forwarder.rb
+- lib/vagrant-notify-forwarder/action/stop_host_forwarder.rb
+- lib/vagrant-notify-forwarder/config.rb
+- lib/vagrant-notify-forwarder/plugin.rb
+- lib/vagrant-notify-forwarder/utils.rb
+- lib/vagrant-notify-forwarder/version.rb
+- vagrant-notify-forwarder-christhomas.gemspec
+homepage: https://github.com/christhomas/vagrant-notify-forwarder
+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.0.3.1
+signing_key: 
+specification_version: 4
+summary: A vagrant plugin that forwards file system events from the host to the guest
+test_files: []