master_to_main 0.0.1 → 0.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 71e3451ce977f600d84510976915b39c28d18a68596b2a9118731fde10d9d4d9
-  data.tar.gz: 9b73f2ec8d863bf86fa4b763f07fddd662676a351f17c5d845767c61bca05a6c
+  metadata.gz: 3e178c01d989407574bbc17949910dca148aad2afaca28205abb785c7aed3263
+  data.tar.gz: eeab0dd082a7808a332a66cb164a67e213f391392cd54ede20a3ba400e9b6c3f
 SHA512:
-  metadata.gz: 34ef7eab028716de82af81e41154ea9e4a0cc963c720c84d9aae6e2118391357e411e6c796d12c8fbce514ada5d145f18575fe0f79c5b76c108a12e60c98453a
-  data.tar.gz: bffc48a13f395255bc403bb8c0270007bd997edd2afd2dede41668bf86387fe7166edd29021785789526b6ba43ff4ed7d5bba1c60fc9ea4b1493900bb3a95e78
+  metadata.gz: 6156ba5854ec68934d55aca6b955b096bfc97def37394669536b4492419ce8b8cf35b45d159f331f3cf22175de5261d71d10dee4302f5fb6058ed24280586872
+  data.tar.gz: d5f7d35aeadee3496122606e6d6f6c613f177526e2780120e249bffcbcab98a80f6449c8b36d88ba0aed4dd557e6dd19ec5450f83574353ce0d9326c2719c857

data/CHANGELOG.md

@@ -1,3 +1,30 @@
+# 0.0.6 - 2020-06-23
+
+- Include `find_references` in `update_docs`
+- README Updates
+
+# 0.0.5 - 2020-06-19
+
+- Add `find_references` for finding non doc references
+- Provide better explanation that you are updating docs only
+- Rescue from branch protection errors like in personal private repos
+
+# 0.0.4 - 2020-06-18
+
+- Change `github` to `update`
+- Add `update_docs` command
+
+# 0.0.3 - 2020-06-17
+
+- Only set api endpoint if not using "github.com"
+- Bump rake version
+- Typos
+- Fetch before checking out main
+
+# 0.0.2 - 2020-06-17
+
+Fix checkout of local branch, add local master branch deletion
+
 # 0.0.1 - 2020-06-17
 
-Initiale release for testing
+Initial release for testing

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    master_to_main (0.1.0)
+    master_to_main (0.0.6)
       octokit (~> 4.0)
       thor (~> 1.0.1)
 
@@ -18,7 +18,7 @@ GEM
       faraday (>= 0.9)
       sawyer (~> 0.8.0, >= 0.5.3)
     public_suffix (4.0.5)
-    rake (10.5.0)
+    rake (13.0.1)
     rspec (3.9.0)
       rspec-core (~> 3.9.0)
       rspec-expectations (~> 3.9.0)
@@ -41,7 +41,10 @@ PLATFORMS
   ruby
 
 DEPENDENCIES
-  bundler (~> 1.17)
+  bundler (~> 2.0)
   master_to_main!
-  rake (~> 10.0)
+  rake (~> 13.0)
   rspec (~> 3.0)
+
+BUNDLED WITH
+   2.1.4

data/README.md

@@ -4,29 +4,49 @@
 enterprise to a new branch. For example, if you wanted to change `master` to
 `main`.
 
+While `master` does have meanings that connote expertise or original record, it also
+has meanings that have much more oppressive and violent histories. Whether or not the
+original meaning of `master` branch was in reference to original record or the opposite
+of slave matters less than what it may mean to a reader who doesn't want to bother with
+the history of git.
+
+Per the twitter thread below, maybe we can just think of it as:
+
+> Agreed. All it does is make the world a tiny bit more welcoming.
+
 Thanks to [@shanselman](https://github.com/shanselman) for [the
 suggestion](https://twitter.com/shanselman/status/1269838158650195968).
 
+## Installation
+
+You need ruby and [rubygems](https://rubygems.org/pages/download) to use `master_to_main`.
+With ruby gems installed you can simply run
+
+```
+$ gem install master_to_main
+```
+
 ## Functionality
 
-`MasterToMain` has 2 actions for now:
+`MasterToMain` has 3 actions:
 
-1. `github`
-2. `update_local`
+1. `update` - Update github, pull requests, branch protections, local origin
+1. `update_local` - For people to use after `update` to update the local clone
+1. `update_docs` - If you just want to search docs for github urls.
 
-## Github
+## `update`
 
 ### Usage
 
 ```
-master_to_main github
+master_to_main update
 ```
 
 After filling out the relevant prompts you will be able to:
 
 1. Create a new branch (e.g. `main`) if it does not exist.
 1. Clone all branch protections from an old branch.
-  - Caveat: This does not include the signed commit requirement
+   - Caveat: This does not include the signed commit requirement
 1. Change the default branch of your repository
 1. Rebase all pull requests based on your old branch to your new branch
 1. Change the local `origin` remote value in github.
@@ -40,8 +60,11 @@ on Fetch URL of `origin` or "github.com")
 or `pwd`)
 1. The current default branch (default is `master`)
 1. The desired default branch (default is `main`)
+1. Your personal access token (instructions for settings one can be found [here](https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line))
+   - You should enable "repo" access
 
-## Update Local Clone
+
+## `update_local`
 
 ### Usage
 
@@ -63,22 +86,16 @@ $ git symbolic-ref refs/remotes/origin/HEAD refs/remotes/origin/main
 All credit for this goes to "Brad from XUnit.net!" per [Scott's
 Blog](https://www.hanselman.com/blog/EasilyRenameYourGitDefaultBranchFromMasterToMain.aspx).
 
+## `update_docs`
 
-## Installation
-
-Add this line to your application's Gemfile:
+### Usage
 
-```ruby
-gem 'master_to_main'
+```
+master_to_main update_docs
 ```
 
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
-
-    $ gem install master_to_main
+This will attempt to update all references to commits on the master branch with
+commits on the main branch.
 
 ## TODO
 
@@ -86,7 +103,7 @@ Or install it yourself as:
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/master_to_main. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+Bug reports and pull requests are welcome on GitHub at https://github.com/dewyze/master_to_main. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
 
 ## Code of Conduct
 

data/lib/master_to_main/cli.rb

@@ -1,24 +1,42 @@
 require "thor"
+require "pry"
 require "octokit"
 
 module MasterToMain
   class CLI < Thor
+    include Thor::Actions
+
     def self.exit_on_failure?
       true
     end
 
-    desc "github", "rebase PRs to the main branch"
-    def github
-
+    desc "update", "rebase PRs to the main branch"
+    def update
       prompt_info
-
       create_client
+
       ensure_old_branch_exists
       ensure_new_branch_exists
       clone_branch_protections
       change_default_branch
       rebase_pull_requests
       change_origin
+      delete_local_old_branch
+      ask_update_docs
+      ask_find_references
+    end
+
+    desc "update_docs", "update local docs to use MAIN"
+    def update_docs
+      prompt_info
+      _update_docs
+      ask_find_references
+    end
+
+    desc "find_references", "find references to github urls with MAIN"
+    def find_references
+      prompt_info
+      _find_references
     end
 
     desc "update_local", "point local clone to new branch"
@@ -31,12 +49,15 @@ module MasterToMain
       `git branch --unset-upstream`
       `git branch -u origin/#{@repo.new_branch}`
       `git symbolic-ref refs/remotes/origin/HEAD refs/remotes/origin/#{@repo.new_branch}`
+      `git pull`
     end
 
     no_commands do
       def create_client
-        Octokit.configure do |c|
-          c.api_endpoint = @repo.api_endpoint
+        if @repo.github != "github.com"
+          Octokit.configure do |c|
+            c.api_endpoint = @repo.api_endpoint
+          end
         end
         token = ask("What is your GitHub Personal Access Token?")
 
@@ -54,7 +75,7 @@ module MasterToMain
           {
             github: "github." + github_suffix,
             user: user,
-            repo: repo.chomp,
+            repo: repo.gsub(/\.git/, "").chomp,
           }
         else
           {
@@ -69,7 +90,7 @@ module MasterToMain
         github_info = get_github_info
         github_url = ask("What is your github url?", default: github_info[:github]).gsub(/https:\/\//, "")
         user = ask("What is your github user?", default: github_info[:user])
-        github_repo = ask("What is your github repo?", default: github_info[:repo])
+        github_repo = ask("What is your github repo?", default: github_info[:repo]).gsub(/\.git/, "")
         old_branch = ask("What is your current primary branch?", default: "master")
         new_branch = ask("What is your desired primary branch?", default: "main")
 
@@ -112,7 +133,12 @@ module MasterToMain
       end
 
       def clone_branch_protections
-        options = @client.branch_protection(@repo.name, @repo.old_branch)
+        begin
+          repo = @client.repo(@repo.name)
+          options = @client.branch_protection(@repo.name, @repo.old_branch)
+        rescue Octokit::Forbidden
+          return
+        end
 
         if options && yes?("Would you like to clone branch protections from '#{@repo.old_branch}'?")
           updates =  BranchProtectionParams.build(options.to_h)
@@ -122,7 +148,7 @@ module MasterToMain
       end
 
       def rebase_pull_requests
-        if yes?("Would you like to rebase all requests based on #{@repo.old_branch} to #{@repo.new_branch}?")
+        if yes?("Would you like to rebase all pull requests based on #{@repo.old_branch} to #{@repo.new_branch}?")
           prs = @client.pull_requests(@repo.name)
           prs.each do |pr|
             if pr[:base][:ref] == @repo.old_branch
@@ -140,11 +166,49 @@ module MasterToMain
 
       def change_origin
         if yes?("Would you like to change origin to point to #{@repo.new_branch}?")
-          `git push -u origin master`
+          `git fetch`
+          `git checkout #{@repo.new_branch}`
+          `git push -u origin #{@repo.new_branch}`
         else
           say "Be sure to change your local `origin` setting"
         end
       end
+
+      def delete_local_old_branch
+        `git branch -D #{@repo.old_branch}` if yes?("Would you like to delete your local #{@repo.old_branch} branch?")
+
+        say "----------------"
+        say "In order to ensure no builds or deployments break, please delete your remote #{@repo.old_branch} on github", :green
+        say "----------------"
+      end
+
+      def ask_update_docs
+        say("We can update #{@repo.github} references in '.md' files that include master in your repo")
+        say("For example: https://#{@repo.github}/#{@repo.name}/(tree|blob)/master")
+        if yes?("Would you like to update these references?")
+          _update_docs
+          say("You should consider searching for other references not in markdown files.")
+          say("We don't want to automatically change those in case something breaks.")
+          say("But you can use `master_to_main find_references` to show you where they are")
+        end
+      end
+
+      def ask_find_references
+        _find_references if yes?("Would you like to display other URL references?")
+      end
+
+      def _update_docs
+        say "This will update all references of #{@repo.old_branch} to #{@repo.new_branch} in the following lines in this repo:"
+        say "https://#{@repo.github}/#{@repo.name}/<tree|blob>/#{@repo.old_branch}"
+        Dir.glob(File.expand_path("**/*.md", Dir.pwd)).each do |path|
+          gsub_file path, /#{@repo.old_branch_regex}/, @repo.new_branch_replacement, verbose: false
+        end
+      end
+
+      def _find_references
+        say "Here are the references to urls with #{@repo.old_branch}:\n\n"
+        puts `git grep -E '#{@repo.old_branch_regex}'`
+      end
     end
   end
 end

data/lib/master_to_main/repo.rb

@@ -18,12 +18,20 @@ module MasterToMain
       "#{user}/#{repo_name}"
     end
 
-    def old_branch_url
-      "https://#{github}/tree/#{old_branch}"
+    def old_branch_regex
+      "(http[s]?:\/\/#{github}\/#{user}\/#{repo_name}\)/(tree|blob)\/#{old_branch}"
+    end
+
+    def new_branch_replacement
+      "\\1/\\2/#{new_branch}"
     end
 
     def new_branch_url
-      "https://#{github}/tree/#{new_branch}"
+      "https://#{github}/#{name}/tree/#{new_branch}"
+    end
+
+    def public_github?
+      @github == "github.com"
     end
   end
 end

data/lib/master_to_main/version.rb

@@ -1,3 +1,3 @@
 module MasterToMain
-  VERSION = "0.0.1"
+  VERSION = "0.0.6"
 end

data/master_to_main.gemspec

@@ -35,8 +35,8 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "bundler", "~> 1.17"
-  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "bundler", "~> 2.0"
+  spec.add_development_dependency "rake", "~> 13.0"
   spec.add_development_dependency "rspec", "~> 3.0"
 
   spec.add_dependency "thor", "~> 1.0.1"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: master_to_main
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.6
 platform: ruby
 authors:
 - John DeWyze
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-06-17 00:00:00.000000000 Z
+date: 2020-06-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -16,28 +16,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.17'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.17'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement