mirrorfile 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 513175ce2e6de6e4e0a0a810d844ce5a280fd3e899cf490b289249054a8c37f9
-  data.tar.gz: 9a8ca82bdd368ef020c97fbf156aba1e5d3cad6860e5eef4e02226165c167277
+  metadata.gz: d8ab3635e4795e7250a284a158d0122062460a19db75d4eb00cd8754e0cedbb5
+  data.tar.gz: aec727ba372fea9a0cf78fcb38e321db66845f6e8d6e63618a62b6d2ba6c780b
 SHA512:
-  metadata.gz: 0046b1bde5286137d682244bf597e8f72a0d43a206c6013b4dc470b08b9dead8ebbe0d7aa390c63437330b9ccf15c93dbefc99ca8e5a0bd346606166232f38b9
-  data.tar.gz: fa70c541f5cdaa6e17c2a654bf07a094cb2037a405409a9fda00fe8f7d725331cb6b66737915fe1df8b39a2f7c8bdbe4bcd887a1a536fd7c1420fa8bcbbdd971
+  metadata.gz: 8deb4362ac6f4d89ba6dc3d8c7f5d2dc3887bf1e433ca2dba9151ffcd0905edfaddf62757f3600fae74f6eb53982c7f1ba7b35a4e8e55e1e62bb03d84f54e43c
+  data.tar.gz: 3c190b0887928dfedd7cd5cfae45fa1858f248417461e7e05411a63c93cd827844a18ef3c0462e1b3fe7120ad3487b9e0c77ab7fc61fa9bfb2fb37ea0f39654b

data/lib/mirrorfile/cli.rb

@@ -21,7 +21,7 @@ module Mirrorfile
   class CLI
     # Available CLI commands
     # @return [Array<String>] list of valid commands
-    COMMANDS = %w[init install update list git help].freeze
+    COMMANDS = %w[init install update list git migrate-to-v1 help].freeze
 
     # Creates a new CLI instance.
     #
@@ -70,8 +70,9 @@ module Mirrorfile
       when 'install' then install
       when 'update'  then update
       when 'list'    then list
-      when 'git'     then git(args.drop(1))
-      when 'help'    then help
+      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 '-v', '--version' then version
       else usage
@@ -152,6 +153,14 @@ module Mirrorfile
       system('git', '--git-dir=.git.mirror', *args)
     end
 
+    # Executes the migrate-to-v1 command.
+    #
+    # @return [void]
+    # @api private
+    def migrate_to_v1
+      Mirror.new.migrate_to_v1
+    end
+
     # Displays help information.
     #
     # @return [void]
@@ -163,13 +172,14 @@ module Mirrorfile
         Usage: mirror <command>
 
         Commands:
-          init      Initialize project with Mirrorfile, .gitignore entry,
-                    and Zeitwerk initializer for Rails projects
-          install   Clone repositories that don't exist locally
-          update    Pull latest changes for existing repositories
-          list      Show all defined mirrors
-          git       Run git commands against a .git.mirror directory
-          help      Show this help message
+          init           Initialize project with Mirrorfile, .gitignore entry,
+                         and Zeitwerk initializer for Rails projects
+          install        Clone repositories that don't exist locally
+          update         Pull latest changes for existing repositories
+          list           Show all defined mirrors
+          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:
           -h, --help     Show this help message
@@ -212,12 +222,13 @@ module Mirrorfile
         Usage: mirror <command>
 
         Commands:
-          init      Create Mirrorfile, .gitignore entry, and Zeitwerk initializer (Rails only)
-          install   Clone repositories that don't exist locally
-          update    Pull latest changes for existing repositories
-          list      Show all defined mirrors
-          git       Run git commands against a .git.mirror directory
-          help      Show detailed help
+          init           Create Mirrorfile, .gitignore entry, and Zeitwerk initializer (Rails only)
+          install        Clone repositories that don't exist locally
+          update         Pull latest changes for existing repositories
+          list           Show all defined mirrors
+          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.
       USAGE

data/lib/mirrorfile/mirror.rb

@@ -136,6 +136,23 @@ module Mirrorfile
       @mirrorfile.entries.to_a
     end
 
+    # Migrates the project to mirrorfile v1.0.
+    #
+    # Performs the following steps:
+    # - Updates Gemfile version constraint to ~> 1.0 (if Gemfile exists)
+    # - Updates the system gem if installed
+    # - Installs template files (.envrc, README.md) into mirrors/
+    # - Renames .git directories to .git.mirror in existing mirrors
+    #
+    # @return [void]
+    def migrate_to_v1
+      update_gemfile
+      update_system_gem
+      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/
@@ -273,6 +290,63 @@ module Mirrorfile
       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
+    # constrained to ~> 1.0. Does nothing if Gemfile doesn't exist
+    # or doesn't reference mirrorfile.
+    #
+    # @return [void]
+    # @api private
+    def update_gemfile
+      gemfile = root.join('Gemfile')
+      return unless gemfile.exist?
+
+      content = gemfile.read
+      updated = content.gsub(/^(\s*gem\s+["']mirrorfile["']).*$/, '\1, "~> 1.0"')
+
+      return unless content != updated
+
+      gemfile.write(updated)
+      puts 'Updated Gemfile to mirrorfile ~> 1.0'
+    end
+
+    # Updates the system-installed mirrorfile gem.
+    #
+    # Checks if the gem is installed globally and runs gem update
+    # if so.
+    #
+    # @return [void]
+    # @api private
+    def update_system_gem
+      return if ENV['MIRRORFILE_SKIP_GEM_UPDATE']
+      return unless system('gem', 'list', '-i', 'mirrorfile', out: File::NULL, err: File::NULL)
+
+      puts 'Updating system gem...'
+      system('gem', 'update', 'mirrorfile')
+    end
+
+    # Renames .git directories to .git.mirror in existing mirrors.
+    #
+    # Scans all subdirectories of mirrors/ for .git directories
+    # and renames them. Skips entries that already have .git.mirror.
+    #
+    # @return [void]
+    # @api private
+    def rename_git_dirs
+      return unless mirrors_dir.exist?
+
+      mirrors_dir.children.select(&:directory?).each do |mirror_path|
+        git_dir = mirror_path.join('.git')
+        git_mirror_dir = mirror_path.join('.git.mirror')
+
+        if git_dir.exist? && !git_mirror_dir.exist?
+          File.rename(git_dir.to_s, git_mirror_dir.to_s)
+          puts "Renamed #{mirror_path.basename}/.git to .git.mirror"
+        end
+      end
+    end
+
     # Determines if the current project is a Rails application by checking
     # for the standard Rails application entrypoint.
     #

data/lib/mirrorfile/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mirrorfile
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Nathan Kidd