mirrorfile 0.1.1 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: de77b25cb4e899eb5e29e28c56864a7f592a917721333e7846f27143ce4e7fd1
-  data.tar.gz: e67318033257885299216cb91234ca51f53204224e6fd2a17d7e3cb86170b832
+  metadata.gz: d8ab3635e4795e7250a284a158d0122062460a19db75d4eb00cd8754e0cedbb5
+  data.tar.gz: aec727ba372fea9a0cf78fcb38e321db66845f6e8d6e63618a62b6d2ba6c780b
 SHA512:
-  metadata.gz: 9f78685072b0bc631479c96d980a78a52f45e00d8ed9109937f9ead3a2de2e0fc1a48e5f85556630c7e7a22b5e160e1949b70c42d0513cbc91320c4626a33e16
-  data.tar.gz: f0c17c1fe5cfa8ac281bf61c0b0b7e0f1f9c518476444a49184087845ea355664f5f7f0613176710698455e34751212b3d6fc210fa84fd00dce9df74fba499e3
+  metadata.gz: 8deb4362ac6f4d89ba6dc3d8c7f5d2dc3887bf1e433ca2dba9151ffcd0905edfaddf62757f3600fae74f6eb53982c7f1ba7b35a4e8e55e1e62bb03d84f54e43c
+  data.tar.gz: 3c190b0887928dfedd7cd5cfae45fa1858f248417461e7e05411a63c93cd827844a18ef3c0462e1b3fe7120ad3487b9e0c77ab7fc61fa9bfb2fb37ea0f39654b

data/lib/mirrorfile/cli.rb

@@ -21,12 +21,7 @@ module Mirrorfile
   class CLI
     # Available CLI commands
     # @return [Array<String>] list of valid commands
-    COMMANDS = %w[init install update list migrate-to-v1 help].freeze
-
-    # Deprecation warning shown on every command except migrate-to-v1
-    DEPRECATION_WARNING = <<~WARN.freeze
-      [mirrorfile] WARNING: v#{VERSION} is deprecated. Run `mirror migrate-to-v1` to upgrade to v1.0.
-    WARN
+    COMMANDS = %w[init install update list git migrate-to-v1 help].freeze
 
     # Creates a new CLI instance.
     #
@@ -53,16 +48,32 @@ module Mirrorfile
     def call(args)
       command = args.first
 
-      @stderr.puts DEPRECATION_WARNING unless command == 'migrate-to-v1'
+      if legacy_command?(command) && Mirror.new.legacy?
+        return CLILegacy.new(stdout: @stdout, stderr: @stderr).call(args)
+      end
+
+      dispatch(args)
+    end
+
+    # Dispatches args to the appropriate command method.
+    #
+    # Separated from {#call} so that {CLILegacy} can dispatch
+    # without re-checking legacy state.
+    #
+    # @param args [Array<String>] command-line arguments
+    # @return [Integer] exit status code
+    def dispatch(args)
+      command = args.first
 
       case command
-      when 'init'           then init
-      when 'install'        then install
-      when 'update'         then update
-      when 'list'           then list
+      when 'init'    then init
+      when 'install' then install
+      when 'update'  then update
+      when 'list'    then list
+      when 'git'            then git(args.drop(1))
       when 'migrate-to-v1'  then migrate_to_v1
       when 'help'           then help
-      when '-h', '--help'   then help
+      when '-h', '--help' then help
       when '-v', '--version' then version
       else usage
       end
@@ -79,6 +90,19 @@ module Mirrorfile
 
     private
 
+    # Returns whether the given command should use legacy mode
+    # when legacy mirrors are detected.
+    #
+    # Commands like init, help, and version flags are not affected
+    # by legacy state and always use the standard CLI.
+    #
+    # @param command [String, nil] the command name
+    # @return [Boolean]
+    # @api private
+    def legacy_command?(command)
+      %w[install update list git].include?(command)
+    end
+
     # Executes the init command.
     #
     # @return [void]
@@ -117,6 +141,18 @@ module Mirrorfile
       entries.empty? ? @stdout.puts('No mirrors defined.') : entries.each { @stdout.puts _1 }
     end
 
+    # Executes a git command against a .git.mirror directory.
+    #
+    # Runs git with --git-dir=.git.mirror in the current working
+    # directory, passing through all additional arguments.
+    #
+    # @param args [Array<String>] arguments to pass to git
+    # @return [void]
+    # @api private
+    def git(args)
+      system('git', '--git-dir=.git.mirror', *args)
+    end
+
     # Executes the migrate-to-v1 command.
     #
     # @return [void]
@@ -141,7 +177,8 @@ module Mirrorfile
           install        Clone repositories that don't exist locally
           update         Pull latest changes for existing repositories
           list           Show all defined mirrors
-          migrate-to-v1  Upgrade to mirrorfile v1.0
+          git            Run git commands against a .git.mirror directory
+          migrate-to-v1  Upgrade legacy mirrors to v1.0 format
           help           Show this help message
 
         Options:
@@ -152,6 +189,7 @@ module Mirrorfile
           $ mirror init
           $ mirror install
           $ mirror update
+          $ cd mirrors/rails && mirror git log --oneline
 
         Mirrorfile syntax:
           source "https://github.com"
@@ -188,7 +226,8 @@ module Mirrorfile
           install        Clone repositories that don't exist locally
           update         Pull latest changes for existing repositories
           list           Show all defined mirrors
-          migrate-to-v1  Upgrade to mirrorfile v1.0
+          git            Run git commands against a .git.mirror directory
+          migrate-to-v1  Upgrade legacy mirrors to v1.0 format
           help           Show detailed help
 
         Run 'mirror help' for more information.

data/lib/mirrorfile/cli_legacy.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module Mirrorfile
+  # Legacy CLI for projects with old-style .git directories.
+  #
+  # This CLI is used automatically when mirrorfile detects that the
+  # mirrors directory contains repositories with .git instead of
+  # .git.mirror. It prints a deprecation warning and operates using
+  # the legacy .git directory name.
+  #
+  # @see CLI
+  # @since 1.0.0
+  class CLILegacy < CLI
+    LEGACY_WARNING = <<~WARN
+      [mirrorfile] WARNING: Your mirrors use legacy .git directories.
+      Upgrade with mirrorfile v0.1.1 (`mirror migrate-to-v1`), or remove
+      the mirrors/ directory and re-run `mirror install`.
+    WARN
+
+    # Overrides CLI#call to skip legacy detection and dispatch directly.
+    #
+    # @param args [Array<String>] command-line arguments
+    # @return [Integer] exit status code
+    def call(args)
+      dispatch(args)
+    end
+
+    private
+
+    # Executes the install command in legacy mode.
+    #
+    # @return [void]
+    # @api private
+    def install
+      @stderr.puts LEGACY_WARNING
+      @stdout.puts 'Installing mirrors (legacy mode)...'
+      Mirror.new.install(legacy: true)
+      @stdout.puts 'Done.'
+    end
+
+    # Executes the update command in legacy mode.
+    #
+    # @return [void]
+    # @api private
+    def update
+      @stderr.puts LEGACY_WARNING
+      @stdout.puts 'Updating mirrors (legacy mode)...'
+      Mirror.new.update(legacy: true)
+      @stdout.puts 'Done.'
+    end
+
+    # Executes the list command with a legacy warning.
+    #
+    # @return [void]
+    # @api private
+    def list
+      @stderr.puts LEGACY_WARNING
+      super
+    end
+
+    # Executes a git command using the default .git directory.
+    #
+    # In legacy mode, mirrors have .git (not .git.mirror), so
+    # no --git-dir flag is needed.
+    #
+    # @param args [Array<String>] arguments to pass to git
+    # @return [void]
+    # @api private
+    def git(args)
+      @stderr.puts LEGACY_WARNING
+      system('git', *args)
+    end
+  end
+end

data/lib/mirrorfile/entry.rb

@@ -41,7 +41,13 @@ module Mirrorfile
     # clone the repository once. If the local directory already exists,
     # no action is taken.
     #
+    # After cloning, the .git directory is renamed to the configured
+    # git_dir name (default: .git.mirror) so that the host project's
+    # git does not treat it as a nested repository.
+    #
     # @param base_dir [Pathname] the base directory to clone into
+    # @param git_dir [String] the git directory name to use
+    #   (default: ".git.mirror", use ".git" for legacy mode)
     # @return [Boolean, nil] true if clone succeeded, false if failed,
     #   nil if already exists
     #
@@ -49,9 +55,15 @@ module Mirrorfile
     #   entry.install(Pathname.new("mirrors"))
     #
     # @see #update
-    def install(base_dir)
+    def install(base_dir, git_dir: '.git.mirror')
       dir = local_path(base_dir)
-      system("git", "clone", url, dir.to_s) unless dir.exist?
+      return if dir.exist?
+
+      return unless system('git', 'clone', url, dir.to_s)
+
+      return unless git_dir != '.git'
+
+      File.rename(dir.join('.git').to_s, dir.join(git_dir).to_s)
     end
 
     # Updates an existing repository by pulling the latest changes.
@@ -60,6 +72,8 @@ module Mirrorfile
     # If the local directory doesn't exist, no action is taken.
     #
     # @param base_dir [Pathname] the base directory containing the clone
+    # @param git_dir [String] the git directory name to use
+    #   (default: ".git.mirror", use ".git" for legacy mode)
     # @return [Boolean, nil] true if pull succeeded, false if failed,
     #   nil if directory doesn't exist
     #
@@ -67,9 +81,12 @@ module Mirrorfile
     #   entry.update(Pathname.new("mirrors"))
     #
     # @see #install
-    def update(base_dir)
+    def update(base_dir, git_dir: '.git.mirror')
       dir = local_path(base_dir)
-      system("git", "-C", dir.to_s, "pull", "--ff-only") if dir.exist?
+      return unless dir.exist?
+
+      system('git', '--git-dir', dir.join(git_dir).to_s,
+             '--work-tree', dir.to_s, 'pull', '--ff-only')
     end
 
     # Returns a human-readable representation of the entry.

data/lib/mirrorfile/mirror.rb

@@ -68,10 +68,11 @@ module Mirrorfile
     #   mirror.install
     #
     # @see Entry#install
-    def install
+    def install(legacy: false)
       ensure_mirrorfile!
       mirrors_dir.mkpath
-      @mirrorfile.entries.each { _1.install(mirrors_dir) }
+      git_dir = legacy ? '.git' : '.git.mirror'
+      @mirrorfile.entries.each { _1.install(mirrors_dir, git_dir: git_dir) }
     end
 
     # Updates all existing local repositories.
@@ -88,9 +89,10 @@ module Mirrorfile
     #   mirror.update
     #
     # @see Entry#update
-    def update
+    def update(legacy: false)
       ensure_mirrorfile!
-      @mirrorfile.entries.each { _1.update(mirrors_dir) }
+      git_dir = legacy ? '.git' : '.git.mirror'
+      @mirrorfile.entries.each { _1.update(mirrors_dir, git_dir: git_dir) }
     end
 
     # Initializes a new project with mirror support.
@@ -117,6 +119,7 @@ module Mirrorfile
     def init
       create_mirrorfile
       setup_gitignore
+      setup_templates
       setup_zeitwerk
       puts "Initialized mirrors in #{root}"
     end
@@ -145,11 +148,25 @@ module Mirrorfile
     def migrate_to_v1
       update_gemfile
       update_system_gem
-      install_templates
+      setup_templates
       rename_git_dirs
       puts 'Migration to v1.0 complete.'
     end
 
+    # Returns whether any mirrors use legacy .git directories.
+    #
+    # A project is considered legacy if any subdirectory of mirrors/
+    # contains a .git directory without a .git.mirror sibling.
+    #
+    # @return [Boolean] true if legacy mirrors are detected
+    def legacy?
+      return false unless mirrors_dir.exist?
+
+      mirrors_dir.children.select(&:directory?).any? do |path|
+        path.join('.git').exist? && !path.join('.git.mirror').exist?
+      end
+    end
+
     private
 
     # Loads and parses the Mirrorfile.
@@ -253,6 +270,26 @@ module Mirrorfile
       RUBY
     end
 
+    # Copies template files into the mirrors directory.
+    #
+    # Creates the mirrors directory if it doesn't exist, then copies
+    # envrc.template and README.md.template from the gem's
+    # templates directory. Existing files are not overwritten.
+    #
+    # @return [void]
+    # @api private
+    def setup_templates
+      mirrors_dir.mkpath
+
+      templates_dir = Pathname.new(__dir__).join('../../templates')
+
+      envrc_dest = mirrors_dir.join('.envrc')
+      envrc_dest.exist? || FileUtils.cp(templates_dir.join('envrc.template'), envrc_dest)
+
+      readme_dest = mirrors_dir.join('README.md')
+      readme_dest.exist? || FileUtils.cp(templates_dir.join('README.md.template'), readme_dest)
+    end
+
     # Updates the Gemfile to use mirrorfile ~> 1.0.
     #
     # Replaces any existing mirrorfile gem declaration with one
@@ -289,32 +326,6 @@ module Mirrorfile
       system('gem', 'update', 'mirrorfile')
     end
 
-    # Copies template files into the mirrors directory.
-    #
-    # Creates the mirrors directory if needed, then copies
-    # envrc.template and README.md.template. Existing files
-    # are not overwritten.
-    #
-    # @return [void]
-    # @api private
-    def install_templates
-      mirrors_dir.mkpath
-
-      templates_dir = Pathname.new(__dir__).join('../../templates')
-
-      envrc_dest = mirrors_dir.join('.envrc')
-      unless envrc_dest.exist?
-        FileUtils.cp(templates_dir.join('envrc.template'), envrc_dest)
-        puts 'Created mirrors/.envrc'
-      end
-
-      readme_dest = mirrors_dir.join('README.md')
-      return if readme_dest.exist?
-
-      FileUtils.cp(templates_dir.join('README.md.template'), readme_dest)
-      puts 'Created mirrors/README.md'
-    end
-
     # Renames .git directories to .git.mirror in existing mirrors.
     #
     # Scans all subdirectories of mirrors/ for .git directories

data/lib/mirrorfile/version.rb

@@ -3,5 +3,5 @@
 module Mirrorfile
   # Current version of the Mirrorfile gem
   # @return [String] the semantic version string
-  VERSION = '0.1.1'
+  VERSION = '1.0.1'
 end

data/lib/mirrorfile.rb

@@ -1,12 +1,13 @@
 # frozen_string_literal: true
 
-require "pathname"
+require 'pathname'
 
-require_relative "mirrorfile/version"
-require_relative "mirrorfile/entry"
-require_relative "mirrorfile/mirrorfile"
-require_relative "mirrorfile/mirror"
-require_relative "mirrorfile/cli"
+require_relative 'mirrorfile/version'
+require_relative 'mirrorfile/entry'
+require_relative 'mirrorfile/mirrorfile'
+require_relative 'mirrorfile/mirror'
+require_relative 'mirrorfile/cli'
+require_relative 'mirrorfile/cli_legacy'
 
 # Mirrorfile is a gem for managing local mirrors of git repositories.
 #
@@ -49,14 +50,14 @@ module Mirrorfile
     #
     # @return [Pathname] path to the mirrors directory
     def mirrors_dir
-      root.join("mirrors")
+      root.join('mirrors')
     end
 
     # Returns the path to the Mirrorfile
     #
     # @return [Pathname] path to the Mirrorfile
     def mirrorfile_path
-      root.join("Mirrorfile")
+      root.join('Mirrorfile')
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mirrorfile
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 1.0.1
 platform: ruby
 authors:
 - Nathan Kidd
@@ -88,6 +88,7 @@ files:
 - flake.nix
 - lib/mirrorfile.rb
 - lib/mirrorfile/cli.rb
+- lib/mirrorfile/cli_legacy.rb
 - lib/mirrorfile/entry.rb
 - lib/mirrorfile/mirror.rb
 - lib/mirrorfile/mirrorfile.rb