forever_version 1.3.8

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a7d18cbd762bb65c1bf6ff84fb2023ddb4b80f18216e3d15b2e10b843de771e7
+  data.tar.gz: 9e1bc6e905c672a3d84e3419c6ccacf5dfc4fd4c8f8e750eb11f1c06db31c091
+SHA512:
+  metadata.gz: 4bdcaf333460563e7a09a33c9efb80d2f7ccb5caab49d41374a61494ca8d14a3541731c1e79bb9f3655cd19785e4a68b1f3cfeb3308c4b5389ce303421a39624
+  data.tar.gz: 863fe928bf66456d4296c6cc491b0bf819b0739615729e685b5f03fff3896a3c49c67555e1d7fa67b956e5c512fa0a3e3031224dc0340903c9671ea771b0bea9

data/Gemfile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in forever_version.gemspec
+gemspec
+
+gem "rake", "~> 13.0"

data/Gemfile.lock

@@ -0,0 +1,19 @@
+PATH
+  remote: .
+  specs:
+    forever_version (1.3.7)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    rake (13.3.1)
+
+PLATFORMS
+  x86_64-linux
+
+DEPENDENCIES
+  forever_version!
+  rake (~> 13.0)
+
+BUNDLED WITH
+   2.3.27

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Forever Version
+
+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/Rakefile

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+
+task default: :spec

data/SETUP.md

@@ -0,0 +1,126 @@
+# Setup Instructions
+
+This document explains how to set up the `forever_version` gem for automated releases and publishing to RubyGems.
+
+## Prerequisites
+
+1. A GitHub repository for the gem
+2. A RubyGems account
+3. Admin access to the GitHub repository
+
+## GitHub Repository Setup
+
+1. **Create the repository** on GitHub and push your gem code
+2. **Enable GitHub Actions** (should be enabled by default)
+3. **Configure repository settings**:
+   - Go to Settings → Actions → General
+   - Under "Workflow permissions", select "Read and write permissions"
+   - Check "Allow GitHub Actions to create and approve pull requests"
+
+## RubyGems API Key Setup
+
+1. **Generate a RubyGems API Key**:
+   - Log in to [RubyGems.org](https://rubygems.org)
+   - Go to your account settings
+   - Click on "API Keys"
+   - Create a new API key with "Push rubygems" scope
+   - Copy the generated API key
+
+2. **Add the API key to GitHub Secrets**:
+   - Go to your GitHub repository
+   - Navigate to Settings → Secrets and variables → Actions
+   - Click "New repository secret"
+   - Name: `RUBYGEMS_API_KEY`
+   - Value: Paste the API key from RubyGems
+   - Click "Add secret"
+
+## Gem Configuration
+
+1. **Update the gemspec file** (`forever_version.gemspec`):
+   - Change the author name and email
+   - Update the homepage URL to your repository
+   - Update the source_code_uri to your repository
+
+2. **Update the README** if needed:
+   - Change any references to your username/repository
+
+## Testing the Setup
+
+1. **Test the workflows**:
+   - Go to Actions tab in your GitHub repository
+   - You should see the "Test" workflow run automatically on pushes
+   - You can manually trigger the "Automated Releases" workflow to test it
+
+2. **Verify permissions**:
+   - The automated release workflow needs write access to create releases
+   - The publish workflow needs the RubyGems API key to push gems
+
+## How It Works
+
+### Automated Releases (auto-release.yml)
+
+- Runs every 4 hours via cron schedule
+- Uses randomized thresholds to determine when to create releases:
+  - **Patch**: 8-16 hours since last release (80% probability when threshold met)
+  - **Minor**: 18-30 hours since last release (60% probability when threshold met)
+  - **Major**: 144-168 hours since last release (60% probability when threshold met)
+- Updates the version in lib/forever_version/version.rb
+- Creates a git commit and pushes it
+- Creates a GitHub release with generated notes
+
+### Publish to RubyGems (publish-gem.yml)
+
+- Triggers automatically when a GitHub release is published
+- Builds the gem using the gemspec
+- Publishes it to RubyGems using the API key
+- Cleans up credentials after publishing
+
+## Manual Release
+
+You can also create releases manually:
+
+1. Go to Actions → "Automated Releases"
+2. Click "Run workflow"
+3. Choose the release type (patch/minor/major)
+4. Click "Run workflow"
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Permission denied errors**: Check that workflow permissions are set to "Read and write permissions"
+
+2. **RubyGems push fails**: 
+   - Verify the API key is correct
+   - Check that the gem name is not already taken
+   - Ensure you have push permissions for the gem
+
+3. **Version conflicts**: 
+   - Make sure the version in version.rb matches what is expected
+   - Check that you have not manually created conflicting releases
+
+4. **Workflow does not run**:
+   - Check that the cron syntax is correct
+   - Verify that Actions are enabled for the repository
+
+### Logs
+
+- All workflow runs are logged in the Actions tab
+- Check individual job logs for detailed error messages
+- The workflows include debug output to help troubleshoot timing decisions
+
+## Security Notes
+
+- The RubyGems API key is stored as a GitHub secret and is automatically masked in logs
+- Credentials are cleaned up after each publish job
+- The workflows only run on the main branch by default
+
+## Customization
+
+To modify the release frequency:
+
+1. Edit the cron schedule in auto-release.yml
+2. Adjust the threshold calculations in the "Determine release type" step
+3. Modify the randomization percentages to change release probability
+
+The current settings create a varied mix of releases with randomization for organic patterns.

data/forever_version.gemspec

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require_relative "lib/forever_version/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "forever_version"
+  spec.version = ForeverVersion::VERSION
+  spec.authors = ["kinduff"]
+  spec.email = ["kinduff@protonmail.com"]
+
+  spec.summary = "Minimal implementation of forever versioning"
+  spec.description = "Minimal implementation of forever versioning using semantic versioning"
+  spec.homepage = "https://github.com/lasagnapizza/forever_version"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 2.6.0"
+
+  spec.metadata["allowed_push_host"] = "https://rubygems.org"
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/lasagnapizza/forever_version"
+
+  # Specify which files should be added to the gem when it is released.
+  spec.files = Dir.glob("**/*").select { |f| File.file?(f) }.reject do |f|
+    f.match(%r{\A(?:(?:bin|test|spec|features|\.github)/|\.(?:git|travis|circleci)|appveyor)}) ||
+      f.end_with?(".gem")
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+end

data/lib/forever_version/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module ForeverVersion
+  VERSION = "1.3.8"
+end

data/lib/forever_version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require_relative "forever_version/version"
+
+module ForeverVersion
+  class Error < StandardError; end
+end

data/vendor/bundle/ruby/3.1.0/bin/rake

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by RubyGems.
+#
+# The application 'rake' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'rubygems'
+
+Gem.use_gemdeps
+
+version = ">= 0.a"
+
+str = ARGV.first
+if str
+  str = str.b[/\A_(.*)_\z/, 1]
+  if str and Gem::Version.correct?(str)
+    version = str
+    ARGV.shift
+  end
+end
+
+if Gem.respond_to?(:activate_bin_path)
+load Gem.activate_bin_path('rake', 'rake', version)
+else
+gem "rake", version
+load Gem.bin_path("rake", "rake", version)
+end