semverve 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9f0366a11f400a32928725b5f954c9f71e3659a75cb5757cf268a3efc018659c
+  data.tar.gz: 870ae675510264ea80bc7a44dbe86efd5248a4020a98f3884b3123cb1f68bea6
+SHA512:
+  metadata.gz: e945ab75c4b9b4eaf3d232ccc5f0be75b7c024a37e9f5488c2a9d31cefe1bfbd1bc6105b27f1b9d51d600d393ea2ca5b3a51445d9bf712ef279a362192ba5166
+  data.tar.gz: 5dcdc6bb2287825fe348c84c289878f76b06e2b453257848990dc1c9cf42a3581dbafc2fd65e04d88ed2861a2f2c17496ce865d929823c5f8bd36e4e8acff13e

data/.github/workflows/ruby.yml

@@ -0,0 +1,37 @@
+# .github/workflows/ruby.yml
+name: Ruby CI
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  test:
+    runs-on: ubuntu-22.04
+    env:
+      BUNDLER_VERSION: 4.0.10
+
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby-version: ['3.2', '3.3', '4.0']
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Ruby ${{ matrix.ruby-version }}
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+          bundler: ${{ env.BUNDLER_VERSION }}
+          bundler-cache: true
+
+      - name: Print Ruby and Bundler versions
+        run: |
+          ruby -v
+          bundle -v
+
+      - name: Run tests
+        run: bundle exec rake

data/.gitignore

@@ -0,0 +1,3 @@
+semverve-*.gem
+coverage/*
+docs/*

data/.ruby-version

@@ -0,0 +1 @@
+4.0.4

data/CONTRIBUTING.md

@@ -0,0 +1,155 @@
+# Contributing
+Thanks for helping improve Semverve. This project is small on purpose, so the
+best contributions tend to keep behavior explicit, tests close to the feature,
+and release automation boring.
+
+## Ruby and Dependencies
+Use the Ruby version declared in `.ruby-version` for local development. The
+gemspec declares the supported Ruby floor, while `.ruby-version` records the
+maintainer's preferred local runtime.
+
+Install dependencies with:
+
+```sh
+bundle install
+```
+
+The project has no runtime dependencies outside Ruby, Rake, RubyGems, and
+Bundler. Development dependencies are listed in `semverve.gemspec`.
+
+## Test Suite
+Run the full default check with:
+
+```sh
+bundle exec rake
+```
+
+The default task runs:
+
+```sh
+bundle exec rake test
+bundle exec rake semverve:check
+```
+
+Tests live under `test/semverve` and use `test-unit`. The suite exercises the
+Rake tasks through temporary project directories so changes are tested the way a
+real gem or Rails app would use them. `test/test_helper.rb` also enables
+SimpleCov, so test runs print line coverage.
+
+Prefer adding focused tests near the behavior you change:
+
+- format parsing and replacement behavior belongs in format tests
+- Rake task behavior belongs in task tests
+- version value-object behavior belongs in semantic version tests
+- release metadata expectations belong in version or task tests
+
+## Style
+Semverve uses Standard Ruby. Check style with:
+
+```sh
+bundle exec rake standard
+```
+
+You can ask Standard to fix safe offenses with:
+
+```sh
+bundle exec rake standard:fix
+```
+
+Keep comments useful but sparse. Public constants, classes, modules, attributes,
+and methods should have RDoc comments; internal code should usually be clear
+from naming and tests.
+
+## Documentation
+Build the API documentation with:
+
+```sh
+bundle exec rake rerdoc
+```
+
+Check documentation coverage with:
+
+```sh
+bundle exec rake rdoc:coverage
+```
+
+RDoc uses `README.md` as the main page and documents files under `lib/**/*.rb`.
+Generated documentation is written to `docs/`, which is ignored on development
+branches. The generated site is maintained on the `gh-pages` branch for GitHub
+Pages.
+
+Publish generated docs with:
+
+```sh
+bundle exec rake docs:publish
+```
+
+That task runs `rerdoc`, opens `gh-pages` in a temporary Git worktree, copies
+the generated `docs/` output there, commits changed docs, pushes to
+`origin/gh-pages`, and removes the temporary worktree. To preview whether
+publishing would change the docs branch without committing or pushing, run:
+
+```sh
+bundle exec rake docs:publish:dry_run
+```
+
+Keep public RDoc comments current as code changes so `bundle exec rake
+rdoc:coverage` stays clean and the published API docs remain useful.
+
+When changing behavior, update the README at the same time. The README is the
+primary user guide, so examples should match real task names, configuration
+names, defaults, and output.
+
+## Versioning and Release Checks
+Semverve uses Semverve to maintain itself, which doubles as useful
+smoke-testing. The project Rakefile requires `lib/semverve/task` and installs
+`Semverve::Task` with this project-specific configuration:
+
+```ruby
+Semverve::Task.new do |t|
+  t.bundle_lock = true
+  t.version_code_reference_files.append("lib/**/*.rb", "semverve.gemspec", "Rakefile")
+end
+```
+
+That means the local `semverve:*` tasks are the same tasks the gem provides to
+users. The current version is stored in `lib/semverve/version.rb`, the gemspec
+uses `Semverve::VERSION`, and `Gemfile.lock` is checked for drift.
+
+Useful commands:
+
+```sh
+bundle exec rake semverve:current
+bundle exec rake semverve:increment:patch
+bundle exec rake semverve:increment:minor
+bundle exec rake semverve:increment:major
+bundle exec rake semverve:set VERSION=x.y.z
+bundle exec rake semverve:check
+bundle exec rake semverve:fix
+```
+
+Because `bundle_lock` is enabled for this repository, successful version updates
+also run `bundle lock`. The self-check scans README version references,
+configured code literals, the gemspec version, and the lockfile entry.
+
+## Release Sanity Checks
+Before release, run:
+
+```sh
+bundle exec rake
+bundle exec rake standard
+bundle exec rake rdoc:coverage
+bundle exec rake rerdoc
+bundle exec rake build
+bundle exec rake docs:publish:dry_run
+```
+
+The build task writes the packaged gem under `pkg/`. Inspect the package if you
+changed metadata or file lists:
+
+```sh
+gem specification pkg/semverve-*.gem
+```
+
+For a public release, also confirm that the GitHub repository is public, the
+gemspec metadata URLs resolve, and RubyGems credentials are configured locally.

data/Gemfile

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+git_source(:github) { |repo| "https://github.com/#{repo}.git" }
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,93 @@
+PATH
+  remote: .
+  specs:
+    semverve (0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.3)
+    docile (1.4.1)
+    erb (6.0.4)
+    json (2.20.0)
+    language_server-protocol (3.17.0.6)
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    parallel (1.28.0)
+    parser (3.3.11.1)
+      ast (~> 2.4.1)
+      racc
+    power_assert (3.0.1)
+    prism (1.9.0)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.4.2)
+    rbs (4.0.3)
+      logger
+      prism (>= 1.6.0)
+      tsort
+    rdoc (8.0.0)
+      erb
+      prism (>= 1.6.0)
+      rbs (>= 4.0.0)
+      tsort
+    regexp_parser (2.12.0)
+    rubocop (1.84.2)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.50.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    rubocop-performance (1.26.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
+    ruby-progressbar (1.13.0)
+    simplecov (0.22.0)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.13.2)
+    simplecov_json_formatter (0.1.4)
+    standard (1.54.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.84.0)
+      standard-custom (~> 1.0.0)
+      standard-performance (~> 1.8)
+    standard-custom (1.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.50)
+    standard-performance (1.9.0)
+      lint_roller (~> 1.1)
+      rubocop-performance (~> 1.26.0)
+    test-unit (3.7.8)
+      power_assert
+    tsort (0.2.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+
+PLATFORMS
+  arm64-darwin-21
+  arm64-darwin-25
+  x86_64-linux
+
+DEPENDENCIES
+  rake (~> 13.0, >= 13.0.1)
+  rdoc
+  simplecov
+  standard (~> 1.54.0)
+  test-unit (~> 3.3, >= 3.3.5)
+  semverve!
+
+BUNDLED WITH
+  4.0.10

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Evan Gray
+
+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.