sugarjar 1.1.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 017705b23c86a5a5c6f1695c5e7dabca591409d2f99039c592d9db14822d7cd2
-  data.tar.gz: e41d40f68013573e5074772d061aa8c55fc69f860d6f63688219a995ab409abc
+  metadata.gz: bc16295007c8698083a182a521c68481b3cb421644def0115aa04286867dd1eb
+  data.tar.gz: c901d92e5d7d5287472f52cf56a83d29a5b1b4b0248232278b36e1706bc7117d
 SHA512:
-  metadata.gz: 54d411046b2f5cab10e97d740e0c4c335a17ec9c4cefcd363720f06660ba4a3310d8ab2a48e057f9047b16d116e30e0e1b082d78953fe9570cee3bee2d14f6f0
-  data.tar.gz: fefe49ca8cd8a8b8c80139a10cc874d24a08808349cae3a71237f47b263502c2fafc92a12d947bcf9b1c17a977bd4ffff8c3956f17bd0f1a18f68dfb566d8b2f
+  metadata.gz: 6d64d758a56feac59e5617544cdde17341c804a8831524c49222f6397e47e886ed16f42280d60584a5231d279410839bdacebda66827ae77bb115addb24f3b6d
+  data.tar.gz: e65b75d83d852906c713f00d6424a76897177f39eb1f2eaa0b5d17896b6d2fb288de3d1cf0946f5587f5674819a074782279ecdb26094c8038d221fcd7ceab0f

data/README.md

@@ -5,14 +5,13 @@
 [![DCO](https://github.com/jaymzh/sugarjar/workflows/DCO%20Check/badge.svg)](https://github.com/jaymzh/sugarjar/actions?query=workflow%3A%22DCO+Check%22)
 
 > [!IMPORTANT]
-> If you are a _new_ user, I suggest looking at [Sapling](https://sapling-scm.com/)
-> instead of this. This was written as a stop-gap to approximate some features
-> of the Facebook/Meta internal development tools before they were released.
-> Now that those tools have been open-sourced and work with GitHub, new users
-> will likely want to start there.  Sapling is far more feature rich, faster,
-> and have more development resources behind them. SugarJar is a smaller
-> transition, and for the time being I'm maintaining it for all existing users,
-> and for those who may not yet be ready for the transition to Sapling.
+> As this was meant to replace arc/jf, which has now been open-sourced as
+> [Sapling](https://sapling-scm.com/), I highly recommend taking a look at that!
+>
+> Sapling is a great tool and solves a variety of problems SugarJar will never
+> be able to. However, it is a bigger workflow change, so existing SJ users
+> may choose to stick with this. Similarly some workflows may not be suitable
+> for Sapling. I still plan to maintain and develop SugarJar for the time being.
 
 Welcome to SugarJar - a git/github helper. It needs one of the GitHub CLI's:
 either [gh](https://cli.github.com/) or the older [hub](https://hub.github.com/).
@@ -33,18 +32,29 @@ If you don't, there's a ton of useful stuff for everyone!
 Sugarjar is packaged in a variety of Linux distributions - see if it's on the
 list here, and if so, use your package manager (or `gem`) to install it:
 
-[![Packaging status](https://repology.org/badge/vertical-allrepos/sugarjar.svg)](https://repology.org/project/sugarjar/versions)
+[![Packaging status](https://repology.org/badge/vertical-allrepos/sugarjar.svg?exclude_unsupported=1)](https://repology.org/project/sugarjar/versions)
 
-For MacOS users, you can use our Homebrew Tap:
+If you are using a Linux distribution version that is end-of-life'd, click the
+above image, it'll take you to a page that lists unsupported distro versions
+as well (they'll have older SugarJar, but they'll probably still have some
+version).
+
+Ubuntu users, Ubuntu versions prior to 24.x cannot be updated, so if you're on
+an older Ubuntu please use [this
+PPA](https://launchpad.net/~michel-slm/+archive/ubuntu/sugarjar) from our
+Ubuntu package maintainer.
+
+For MacOS users, we recommend using Homebrew - SugarJar is now in Homebrew Core.
+
+NOTE: If you previously used our custom Homebrew tap, you should remove and
+untap it:
 
 ```shell
-homebrew tap jaymzh/sugarjar
-homebrew install sugarjar
+homebrew uninstall sugarjar
+homebrew untap jaymzh/sugarjar
 ```
 
-You can also weigh in on [this
-PR](https://github.com/Homebrew/homebrew-core/pull/157910) and tell the
-Homebrew folks you'd like to see it in core.
+Then you can install the core version (`brew install sugarjar`).
 
 Finally, if none of those work for you, you can clone this repo and run it
 directly from there.
@@ -410,3 +420,9 @@ will allow me to make sure it shows up in the Repology badge above.
 Since it's Ruby, it should work across all platforms, however, it's developed
 and primarily tested on Linux as well as regularly used on Mac. I've not tested
 it on Windows, but I'll happily accept patches for Windows compatibility.
+
+**How do I get tab-completion?**
+
+If the package for your OS/distro didn't set it up manually, you should find
+that `sugarjar_completion.bash` is included in the package, and you can simply
+source that in your dotfiles, assuming you are using bash.

data/bin/sj

@@ -190,9 +190,9 @@ COMMANDS:
               Print the version of sugarjar, and then run 'hub version'
               to show the hub and git versions.
 
-Be sure to checkout Sapling (https://sapling-scm.com/)! This was written as
+Be sure to checkout Sapling (https://sapling-scm.com/)! SugarJar was written as
 a stop-gap to get Sapling features before it was open-sourced, and as such
-I may deprecate this in the future.
+Sapling may serve your needs even better.
 COMMANDS
 
   # rubocop:enable Layout/HeredocIndentation

data/extras/sugarjar_completion.bash

@@ -0,0 +1,42 @@
+# bash completion for sugarjar
+
+SJCONFIG="$HOME/.config/sugarjar/config.yaml"
+
+_sugarjar_completions()
+{
+    if [ "${#COMP_WORDS[@]}" -eq 2 ]; then
+        return
+    fi
+
+    local -a suggestions
+
+    # grap the feature_prefix if we have one so that we
+    # can let the user ignore that part. If we have `yq`
+    # we'll use it as that's going to be always 100%
+    # reliable, but if we don't, do our best with shell
+    # utils
+    local prefix=''
+    if [ -e "$SJCONFIG" ]; then
+        if type yq &>/dev/null; then
+            prefix=$(yq .feature_prefix $SJCONFIG)
+        else
+            # the xargs removes extra spaces
+            prefix=$(grep feature_prefix $SJCONFIG | cut -f2 -d: | xargs)
+        fi
+    fi
+
+    case "${COMP_WORDS[1]}" in
+        co|checkout|bclean)
+            local branches=$(git branch | sed -e 's/* //g' | xargs)
+            if [ -n "$prefix" ]; then
+                local branches=$(echo $branches | sed -e "s!$prefix!!g")
+            fi
+            suggestions=($(compgen -W "$branches" -- "${COMP_WORDS[2]}"))
+            COMPREPLY=("${suggestions[@]}")
+            ;;
+        *)
+            return
+    esac
+}
+
+complete -F _sugarjar_completions sj

data/lib/sugarjar/commands.rb

@@ -140,10 +140,15 @@ class SugarJar
       curr = current_branch
       result = gitup
       if result['so'].error?
+        backout = ''
+        if rebase_in_progress?
+          backout = ' You can get out of this with a `git rebase --abort`.'
+        end
+
         die(
           "#{color(curr, :red)}: Failed to rebase on " +
-          "#{result['base']}. Leaving the repo as-is. You can get out of " +
-          'this with a `git rebase --abort`. Output from failed rebase is: ' +
+          "#{result['base']}. Leaving the repo as-is.#{backout} " +
+          'Output from failed rebase is: ' +
           "\nSTDOUT:\n#{result['so'].stdout.lines.map { |x| "\t#{x}" }.join}" +
           "\nSTDERR:\n#{result['so'].stderr.lines.map { |x| "\t#{x}" }.join}",
         )
@@ -179,7 +184,7 @@ class SugarJar
             "#{color(branch, :red)} failed rebase. Reverting attempt and " +
             'moving to next branch. Try `sj up` manually on that branch.',
           )
-          git('rebase', '--abort')
+          git('rebase', '--abort') if rebase_in_progress?
         else
           SugarJar::Log.info(
             "#{color(branch, :green)} rebased on " +
@@ -807,6 +812,15 @@ class SugarJar
       }
     end
 
+    def rebase_in_progress?
+      # for rebase without -i
+      rebase_file = git('rev-parse', '--git-path', 'rebase-apply').stdout.strip
+      # for rebase -i
+      rebase_merge_file = git('rev-parse', '--git-path', 'rebase-merge').
+                          stdout.strip
+      File.exist?(rebase_file) || File.exist?(rebase_merge_file)
+    end
+
     def tracked_branch
       s = git_nofail(
         'rev-parse', '--abbrev-ref', '--symbolic-full-name', '@{u}'

data/lib/sugarjar/util.rb

@@ -1,5 +1,7 @@
 require_relative 'log'
 
+require 'mixlib/shellout'
+
 class SugarJar
   # Some common methods needed by other classes
   module Util

data/lib/sugarjar/version.rb

@@ -1,3 +1,3 @@
 class SugarJar
-  VERSION = '1.1.0'.freeze
+  VERSION = '1.1.1'.freeze
 end

data/sugarjar.gemspec

@@ -8,14 +8,16 @@ Gem::Specification.new do |spec|
   spec.email = ['phil@ipom.com']
   spec.license = 'Apache-2.0'
   spec.homepage = 'https://github.com/jaymzh/sugarjar'
-  spec.required_ruby_version = '>= 3.1'
+  # We'll support 3.0 until 2024-03-31 when it goes EOL
+  # https://www.ruby-lang.org/en/downloads/branches/
+  spec.required_ruby_version = '>= 3.0'
   docs = %w{README.md LICENSE Gemfile sugarjar.gemspec}
   spec.extra_rdoc_files = docs
   spec.executables << 'sj'
   spec.files =
     Dir.glob('lib/sugarjar/*.rb') +
     Dir.glob('bin/*') +
-    docs
+    Dir.glob('extras/*')
 
   spec.add_dependency 'deep_merge'
   spec.add_dependency 'mixlib-log'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sugarjar
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.1.1
 platform: ruby
 authors:
 - Phil Dibowitz
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-12-31 00:00:00.000000000 Z
+date: 2024-02-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: deep_merge
@@ -82,6 +82,7 @@ files:
 - LICENSE
 - README.md
 - bin/sj
+- extras/sugarjar_completion.bash
 - lib/sugarjar/commands.rb
 - lib/sugarjar/config.rb
 - lib/sugarjar/log.rb
@@ -106,7 +107,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: '3.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="