leave_it 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 132986cf5b0e44f0189e98b45bf98c35d4d95e4902d33a1506c670d05c8857e3
+  data.tar.gz: a306605029ddfa8d6d22f89d0ba20fd142022ab751e2587e1a5484aca232a585
+SHA512:
+  metadata.gz: 92a74d4b08f4cfdd2c65c0f561d4d1e8b1ed44e47270111d1498af174c04fff51a111aeb373e3129e6712f0bed88176a3ba8ff0843279fea23167b1987acf22a
+  data.tar.gz: 357daaa2b78d54edece4473569e60a2a11232a4928603eadc08738d38cbda4a8e2e4fc7a33b7806c23436d869fb3bd71ae78cde1fd993ea405cffc3fe0cccc5a

data/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+This project adheres to [Semantic Versioning](https://semver.org/) and [Keep a Changelog](https://keepachangelog.com/).
+
+---
+
+## [0.1.1] - 2025-06-24
+
+### Fixed
+- Corrected homepage link in gemspec.
+
+---
+
+## [0.1.0] - 2025-06-24
+
+### Added
+- Initial release.
+- CLI tool to parse `Gemfile.lock` and inject pessimistic `~>` version constraints into `Gemfile`.

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 mykbren
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,107 @@
+# leave_it
+
+**Inject pessimistic (`~>`) version constraints into your Gemfile from your Gemfile.lock automatically, preventing major updates during bundling and allowing only safe patch and minor version upgrades.**
+
+If I had to describe the motivation behind this tool in one sentence, it would be:  
+**No more pain after `bundle update` — keep your Gemfile locked to working versions, and update dependencies one by one only when needed.** (⇀‸↼‶)
+
+PS. Patches can still break functionality sometimes, but by nature they shouldn’t — this tool helps minimize those risks. (｀_´)ゞ
+
+---
+
+## Motivation
+
+Managing Ruby gem dependencies can be tricky, especially when your Gemfile includes gems without explicit version constraints. Running bundle update often results in major version bumps that introduce breaking changes or cause unexpected instability in your project.
+
+I was tired of manually specifying version constraints and constantly dealing with surprise major upgrades during bundling that break things — wasting hours debugging incompatibilities.
+
+Another common pain is resurrecting an old project from its Gemfile.lock. The lockfile helps you restore the exact gem versions that last worked, but sometimes you need to update a few libraries to get the project running on newer Ruby or system environments. Then, running bundle update without precise version constraints causes a flood of major upgrades, breaking your app's functionality completely — and leaving you staring at a wall of errors (╯°□°）╯︵ ┻━┻
+
+This tool solves those headaches by scanning your Gemfile.lock and automatically injecting the correct pessimistic (~>) version constraints into your Gemfile for any gems missing them. This keeps your dependencies safely locked, prevents unintentional major upgrades, and helps maintain project stability — whether you’re actively developing or resurrecting legacy code.
+
+---
+
+## Features
+
+* Parses your `Gemfile.lock` for exact gem versions.
+* Adds pessimistic version constraints (`~> x.y.z`) to unversioned gems in your `Gemfile`.
+* Keeps existing version constraints untouched.
+* Simple CLI interface — just run in your project directory.
+* Helps reduce unintended major version updates and improves bundle stability.
+
+---
+
+## Installation
+
+Add this line to your Gemfile:
+
+```ruby
+gem 'leave_it'
+```
+
+Then execute:
+
+```bash
+bundle install
+```
+
+Or install it yourself with:
+
+```bash
+gem install leave_it
+```
+
+---
+
+## Usage
+
+Run the CLI from your project root directory (where `Gemfile` and `Gemfile.lock` reside):
+
+```bash
+leave-it .
+```
+
+This will update your `Gemfile` in-place, adding `~>` version constraints for all gems missing them, based on the versions locked in your `Gemfile.lock`.
+
+---
+
+## Example
+
+Before:
+
+```ruby
+gem 'rake'
+gem 'rspec', '~> 3.10'
+```
+
+After running `leave-it .`:
+
+```ruby
+gem 'rake', '~> 13.0.6'
+gem 'rspec', '~> 3.10'
+```
+
+---
+
+## Development
+
+Clone the repo and run tests:
+
+```bash
+git clone https://github.com/mykbren/leave_it.git
+cd leave_it
+bundle install
+bundle exec rspec
+```
+
+---
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at [https://github.com/mykbren/leave_it](https://github.com/mykbren/leave_it).
+
+---
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/bin/console

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'leave_it'
+
+require 'irb'
+IRB.start(__FILE__)

data/bin/leave-it

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'leave_it'
+
+LeaveIt.run(ARGV.first || '.')

data/bin/setup

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install

data/leave_it.gemspec

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require_relative 'lib/leave_it/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'leave_it'
+  spec.version       = LeaveIt::VERSION
+  spec.authors       = ['mykbren']
+  spec.email         = ['myk.bren@gmail.com']
+
+  spec.summary       = 'Injects pessimistic (~>) version constraints into your Gemfile from Gemfile.lock'
+  spec.description = <<~DESC.strip
+    CLI tool that scans Gemfile.lock and updates your Gemfile by adding pessimistic (~>) version
+    constraints to unversioned gems.
+  DESC
+  spec.homepage      = 'https://github.com/mykbren/leave_it'
+  spec.license       = 'MIT'
+  spec.required_ruby_version = '>= 2.7.0'
+  spec.metadata['homepage_uri']     = spec.homepage
+  spec.metadata['source_code_uri']  = spec.homepage
+  spec.metadata['changelog_uri']    = "#{spec.homepage}/blob/main/CHANGELOG.md"
+  spec.metadata['allowed_push_host'] = 'https://rubygems.org'
+
+  # Includes all files tracked by git
+  spec.files = Dir.glob('lib/**/*') + Dir.glob('bin/*') + ['README.md', 'CHANGELOG.md', 'LICENSE.txt',
+                                                           'leave_it.gemspec']
+
+  spec.bindir        = 'bin'
+  spec.executables   = ['leave-it']
+  spec.require_paths = ['lib']
+end

data/lib/leave_it/cli.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+module LeaveIt
+  class CLI
+    def self.run(path)
+      gemfile = File.join(path, 'Gemfile')
+      lockfile = File.join(path, 'Gemfile.lock')
+
+      unless File.exist?(gemfile) && File.exist?(lockfile)
+        puts "❌ Gemfile or Gemfile.lock not found in #{path}"
+        exit(1)
+      end
+
+      versions = parse_lockfile_versions(lockfile)
+      updated = update_gemfile_versions(gemfile, versions)
+      File.write(gemfile, updated)
+
+      puts "✅ Gemfile in #{path} updated successfully."
+    end
+
+    def self.parse_lockfile_versions(lockfile)
+      versions = {}
+      File.foreach(lockfile) { |line| process_lockfile_line(line, versions) }
+      versions
+    end
+
+    def self.update_gemfile_versions(gemfile, lock_versions)
+      new_lines = []
+      File.foreach(gemfile) { |line| new_lines << process_gemfile_line(line, lock_versions) }
+      new_lines.join
+    end
+
+    def self.process_lockfile_line(line, versions)
+      @in_gem_section ||= false
+      @in_gem_section = true if gem_section_start?(line)
+      return unless @in_gem_section
+
+      if gem_line?(line)
+        gem_name, version = parse_gem_line(line)
+        versions[gem_name] = version
+      elsif line.strip.empty?
+        @in_gem_section = false
+      end
+    end
+
+    def self.process_gemfile_line(line, lock_versions)
+      if gem_declaration_line?(line)
+        indent, gem_name, _, version, rest = parse_gem_declaration_line(line)
+
+        if version.nil? && lock_versions[gem_name]
+          version_str = pessimistic_version(lock_versions[gem_name])
+          return "#{indent}gem '#{gem_name}', '#{version_str}'#{rest}\n"
+        end
+      end
+
+      line
+    end
+
+    def self.gem_section_start?(line)
+      line.strip == 'GEM'
+    end
+
+    def self.gem_line?(line)
+      line =~ /^\s{4}(\S+)\s\(([^)]+)\)/
+    end
+
+    def self.parse_gem_line(line)
+      match = line.match(/^\s{4}(\S+)\s\(([^)]+)\)/)
+      [match[1], match[2]]
+    end
+
+    def self.gem_declaration_line?(line)
+      line =~ /^(\s*)gem ['"]([^'"]+)['"](,\s*['"]([^'"]+)['"])?(.*)$/
+    end
+
+    def self.parse_gem_declaration_line(line)
+      match = line.match(/^(\s*)gem ['"]([^'"]+)['"](,\s*['"]([^'"]+)['"])?(.*)$/)
+      [match[1], match[2], match[3], match[4], match[5]]
+    end
+
+    def self.pessimistic_version(version)
+      parts = version.split('.')
+      if parts.length >= 3
+        "~> #{parts[0]}.#{parts[1]}.#{parts[2]}"
+      else
+        "~> #{version}"
+      end
+    end
+  end
+end

data/lib/leave_it/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module LeaveIt
+  VERSION = '0.1.1'
+end

data/lib/leave_it.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require_relative 'leave_it/version'
+require_relative 'leave_it/cli'
+
+module LeaveIt
+  def self.run(path = '.')
+    CLI.run(path)
+  end
+end

metadata

@@ -0,0 +1,60 @@
+--- !ruby/object:Gem::Specification
+name: leave_it
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- mykbren
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-06-24 00:00:00.000000000 Z
+dependencies: []
+description: |-
+  CLI tool that scans Gemfile.lock and updates your Gemfile by adding pessimistic (~>) version
+  constraints to unversioned gems.
+email:
+- myk.bren@gmail.com
+executables:
+- leave-it
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- bin/console
+- bin/leave-it
+- bin/setup
+- leave_it.gemspec
+- lib/leave_it.rb
+- lib/leave_it/cli.rb
+- lib/leave_it/version.rb
+homepage: https://github.com/mykbren/leave_it
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/mykbren/leave_it
+  source_code_uri: https://github.com/mykbren/leave_it
+  changelog_uri: https://github.com/mykbren/leave_it/blob/main/CHANGELOG.md
+  allowed_push_host: https://rubygems.org
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.10
+signing_key:
+specification_version: 4
+summary: Injects pessimistic (~>) version constraints into your Gemfile from Gemfile.lock
+test_files: []