git-jump 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dfb31c6068e94ef82538f0df322527fec4cd32b1458cf7dd2f62bba076b0371a
-  data.tar.gz: 46d4763ee56a9b588a96000980f32ec6f828185feaf83ec0ad3f6c5e9c683981
+  metadata.gz: 7137fa6fe4eb3b364da1e52979e79428817a7c40d9da2b665cbceea2733f6817
+  data.tar.gz: 465f2e0d55117769052efdef1137556b09dcdfdc5a3b52d9f28905ee2b1b019e
 SHA512:
-  metadata.gz: 40ad5bdd5b4ba6f5dcbc9f6d51de60e8ebde83fdf58cd8296f95824e64a701be70af974029d9aeed1b3e5073ab2260a8b65a32c8a20cf376d34c560f4ac6fc83
-  data.tar.gz: 93927a1d2ea2ea154fc051cbef01a7f50926668557a8b083f76c18a942c43d0c87cb8d9c0708e499d4e1cfeb090e04a72fa2b046fe08e9b58e24b9ecb35dcd59
+  metadata.gz: 7cec7b19e5210677959c391d0ec8892f9d70616c2952083fdc254b0a4fe9a9d29e0316e51efb7a3377d4408192858743e83d580f3b8e8364f308cde3baf00d21
+  data.tar.gz: 7a5137b19d11359c1b115ac9171a75ac3f33d7f17ab9443308b955060abffa3c856042bb1c5a0906ad12683551af59f894167a4bb1aff95fa379b52889411dd3

data/AGENTS.md

@@ -0,0 +1,22 @@
+# Agent Guidelines for git-jump
+
+## Build/Test/Lint Commands
+- Setup: `bin/setup` or `bundle install`
+- Run all tests: `rake spec` or `bundle exec rspec`
+- Run single test file: `bundle exec rspec spec/path/to/file_spec.rb`
+- Run single test: `bundle exec rspec spec/path/to/file_spec.rb:LINE_NUMBER`
+- Lint: `rake rubocop` or `bundle exec rubocop`
+- Lint autofix: `bundle exec rubocop -a`
+- Default task (tests + lint): `rake`
+
+## Code Style Guidelines
+- **Ruby version**: >= 3.2.0
+- **Frozen string literal**: Add `# frozen_string_literal: true` to top of every .rb file
+- **String literals**: Use double quotes for all strings (enforced by RuboCop)
+- **Imports**: Use `require_relative` for internal files, `require` for gems. Optimize loading via loaders for CLI actions
+- **Naming**: Use snake_case for methods/variables, PascalCase for classes/modules
+- **Documentation**: Class/module documentation comments disabled (no need for YARD-style docs)
+- **Error handling**: Return false for errors in actions, output error messages via `output.error()`
+- **Dependencies**: All actions inherit from `Actions::Base`, accept `config:`, `database:`, `repository:`, `output:` kwargs
+- **Tests**: Use RSpec with `subject(:action)`, `let` helpers, and `instance_double` for mocking. Setup git repos in temp dirs
+- **Modules**: Namespace everything under `GitJump` or `GitJump::Actions`, `GitJump::Utils`, etc.

data/CHANGELOG.md

@@ -1,5 +1,32 @@
 ## [Unreleased]
 
+## [0.1.3] - 2025-12-12
+
+### Fixed
+- Fixed post-checkout hook to work correctly across all projects
+  - Hook now properly requires 'git_jump/hooks/post_checkout' instead of 'git_jump'
+  - Added missing dependency requires to post_checkout.rb (Repository, Config, Database)
+  - Added missing require for Utils::XDG in config.rb
+  - Hook now respects .ruby-version files in repositories
+- Fixed install_loader to include Database dependency
+
+### Added
+- Comprehensive test suite for post-checkout hook (17 tests)
+  - Tests for branch tracking, project creation, error handling
+  - Hook template validation tests
+  - Dependency loading verification tests
+- Added loader tests to ensure all dependencies are properly loaded (6 tests)
+- Added local testing documentation in docs/local-testing.md
+
+### Changed
+- Improved code quality by fixing all RuboCop offenses
+- Extracted helper methods in specs for better maintainability
+
+## [0.1.2] - 2025-11-16
+
+### Fixed
+- Fixed setup action error handling and loader dependencies
+
 ## [0.1.1] - 2025-11-16
 
 ### Changed

data/docs/local-testing.md

@@ -0,0 +1,187 @@
+# Testing git-jump Locally Before Release
+
+This guide explains how to test git-jump in local projects before releasing a new version to RubyGems.
+
+## Prerequisites
+
+- Ruby >= 3.2.0
+- Bundler installed (`gem install bundler`)
+
+## Method 1: Using `bundle exec rake install`
+
+This installs the gem locally on your system:
+
+```bash
+# From the git-jump directory
+cd /path/to/git-jump
+
+# Install dependencies
+bundle install
+
+# Build and install the gem locally
+bundle exec rake install
+```
+
+After running this, `git-jump` will be available system-wide. You can test it in any project:
+
+```bash
+cd /path/to/your/test-project
+git-jump status
+git-jump list
+```
+
+## Method 2: Using `gem build` + `gem install`
+
+Build the gem manually and install it:
+
+```bash
+# From the git-jump directory
+cd /path/to/git-jump
+
+# Build the gem
+gem build git-jump.gemspec
+
+# Install the built gem (version will match lib/git_jump/version.rb)
+gem install ./git-jump-*.gem
+```
+
+## Method 3: Using Bundler's Path Option (Recommended for Development)
+
+Add git-jump to a test project's Gemfile using the local path:
+
+```ruby
+# In your test project's Gemfile
+gem "git-jump", path: "/path/to/git-jump"
+```
+
+Then run:
+
+```bash
+cd /path/to/your/test-project
+bundle install
+bundle exec git-jump status
+```
+
+This method is useful because:
+- Changes to the source code are immediately available
+- No need to rebuild/reinstall after each change
+- Isolated to the specific project
+
+## Method 4: Direct Execution from Source
+
+Run git-jump directly from the source directory without installing:
+
+```bash
+# From the git-jump directory
+cd /path/to/git-jump
+
+# Run using the exe script
+bundle exec exe/git-jump status
+
+# Or run in a different directory
+bundle exec exe/git-jump --help
+```
+
+To test in another project directory:
+
+```bash
+cd /path/to/your/test-project
+/path/to/git-jump/bin/git-jump list
+```
+
+## Running Tests Before Local Testing
+
+Always run the test suite before testing locally:
+
+```bash
+# Run all tests
+bundle exec rspec
+
+# Run tests with coverage
+bundle exec rspec
+
+# Run linter
+bundle exec rubocop
+
+# Run both tests and linter
+bundle exec rake
+```
+
+## Testing Checklist
+
+Before releasing, verify these commands work correctly:
+
+1. **Setup**: `git-jump setup` - Creates config file
+2. **Install hook**: `git-jump install` - Installs post-checkout hook
+3. **Add branch**: `git-jump add <branch-name>` - Adds branch to tracking
+4. **List branches**: `git-jump list` - Shows tracked branches
+5. **Jump**: `git-jump jump` - Switches to next branch
+6. **Jump by index**: `git-jump jump 2` - Switches to branch at index
+7. **Clear**: `git-jump clear` - Clears non-kept branches
+8. **Status**: `git-jump status` - Shows current status
+9. **Version**: `git-jump version` - Shows version number
+
+## Testing the Post-Checkout Hook
+
+After installing the hook with `git-jump install`:
+
+```bash
+# Check the hook exists
+cat .git/hooks/post-checkout
+
+# Test by checking out branches
+git checkout -b test-branch-1
+git checkout -b test-branch-2
+git checkout main
+
+# Verify branches were tracked
+git-jump list
+```
+
+## Cleaning Up After Testing
+
+To remove the locally installed gem:
+
+```bash
+gem uninstall git-jump
+```
+
+To remove git-jump data:
+
+```bash
+# Remove config
+rm -rf ~/.config/git-jump
+
+# Remove database
+rm -rf ~/.local/share/git-jump
+
+# Or if using custom XDG paths
+rm -rf $XDG_CONFIG_HOME/git-jump
+rm -rf $XDG_DATA_HOME/git-jump
+```
+
+## Troubleshooting
+
+### Gem not found after installation
+
+Make sure the gem's bin directory is in your PATH:
+
+```bash
+gem environment | grep "EXECUTABLE DIRECTORY"
+```
+
+### Changes not reflected
+
+If using Method 1 or 2, you need to rebuild and reinstall after making changes:
+
+```bash
+bundle exec rake install
+```
+
+### Database errors
+
+Delete the SQLite database and start fresh:
+
+```bash
+rm ~/.local/share/git-jump/branches.db
+```

data/lib/git_jump/actions/install.rb

@@ -30,7 +30,7 @@ module GitJump
         #{"    "}
             "$RUBY_PATH" -e "
               begin
-                require 'git_jump'
+                require 'git_jump/hooks/post_checkout'
                 GitJump::Hooks::PostCheckout.new('$(pwd)').run
               rescue LoadError
                 # Gem not available, skip silently

data/lib/git_jump/config.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative "utils/xdg"
+
 module GitJump
   # Manages configuration from TOML file
   class Config

data/lib/git_jump/hooks/post_checkout.rb

@@ -1,5 +1,9 @@
 # frozen_string_literal: true
 
+require_relative "../repository"
+require_relative "../config"
+require_relative "../database"
+
 module GitJump
   module Hooks
     # Post-checkout hook implementation

data/lib/git_jump/loaders/install_loader.rb

@@ -5,6 +5,7 @@ require_relative "../version"
 require_relative "../utils/xdg"
 require_relative "../utils/output"
 require_relative "../config"
+require_relative "../database"
 require_relative "../repository"
 require_relative "../actions/base"
 require_relative "../actions/install"

data/lib/git_jump/utils/output.rb

@@ -50,15 +50,16 @@ module GitJump
       def branch_list(branches, current_branch)
         return if quiet || branches.empty?
 
-        heading("Tracked Branches")
+        max_branch_width = calculate_max_branch_width
 
         rows = branches.map.with_index(1) do |branch, index|
           name = branch["name"]
           marker = name == current_branch ? Colors.green("→") : " "
           styled_name = name == current_branch ? Colors.green(name, bold: true) : name
+          truncated_name = truncate_text(styled_name, max_branch_width)
           last_visited = format_time(branch["last_visited_at"])
 
-          ["#{marker} #{index}", styled_name, last_visited]
+          ["#{marker} #{index}", truncated_name, last_visited]
         end
 
         table(["#", "Branch", "Last Visited"], rows)
@@ -93,6 +94,60 @@ module GitJump
       rescue StandardError
         "unknown"
       end
+
+      # Get terminal width using multiple detection methods
+      def terminal_width
+        # Try tput command
+        width = `tput cols 2>/dev/null`.to_i
+        return width if width.positive?
+
+        # Try COLUMNS environment variable
+        width = ENV.fetch("COLUMNS", 0).to_i
+        return width if width.positive?
+
+        # Default fallback
+        80
+      end
+
+      # Calculate maximum width for branch names in the table
+      # Table structure: | # | Branch | Last Visited |
+      # Fixed widths:
+      #   - '# ' column: ~5 chars (marker + index)
+      #   - 'Last Visited' column: ~14 chars
+      #   - Table borders and padding: ~12 chars
+      def calculate_max_branch_width
+        fixed_width = 5 + 14 + 12
+        branch_width = terminal_width - fixed_width
+
+        # Ensure minimum branch width for readability
+        [branch_width, 20].max
+      end
+
+      # Strip ANSI color codes from text for accurate length calculation
+      def strip_ansi_codes(text)
+        text.gsub(/\e\[[0-9;]*m/, "")
+      end
+
+      # Truncate text to max_width, preserving ANSI color codes
+      def truncate_text(text, max_width)
+        plain_text = strip_ansi_codes(text)
+        return text if plain_text.length <= max_width
+        return "..." if max_width < 3
+
+        # Check if text contains ANSI color codes
+        if text.include?("\e[")
+          # Extract all leading ANSI codes (color, bold, etc.)
+          color_start = text[/^(\e\[[0-9;]*m)+/, 0] || ""
+          color_end = text[/\e\[0m$/] || ""
+
+          # Truncate the plain text and reapply colors
+          truncated = "#{plain_text[0...(max_width - 3)]}..."
+          color_start + truncated + color_end
+        else
+          # No color codes, simple truncation
+          "#{plain_text[0...(max_width - 3)]}..."
+        end
+      end
     end
   end
 end

data/lib/git_jump/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module GitJump
-  VERSION = "0.1.1"
+  VERSION = "0.1.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: git-jump
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.3
 platform: ruby
 authors:
 - David Sáenz
@@ -131,12 +131,14 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- AGENTS.md
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - LICENSE.txt
 - README.md
 - Rakefile
 - db/schema.rb
+- docs/local-testing.md
 - exe/git-jump
 - lib/git_jump.rb
 - lib/git_jump/action.rb
@@ -187,7 +189,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 4.0.1
 specification_version: 4
 summary: Smart git branch tracker and switcher with SQLite persistence
 test_files: []