➕ timecop-rspec

.env.local.example

@@ -1,3 +1,4 @@
 export DEBUG=false # do not allow byebug statements (override in .env.local)
-export FLOSS_FUNDING_DEBUG=false # extra logging to help diagnose issues (override in .env.local)
+export FLOSS_CFG_FUNDING_DEBUG=false # extra logging to help diagnose issues (override in .env.local)
 export AUTOGEN_FIXTURE_CLEANUP=false # autogenerated gem fixture cleanup after every RSpec run
+export GLOBAL_TIME_TRAVEL_TIME=2025-08-15

.envrc

@@ -18,17 +18,20 @@ PATH_add bin
 export K_SOUP_COV_DO=true # Means you want code coverage
 # Available formats are html, xml, rcov, lcov, json, tty
 export K_SOUP_COV_COMMAND_NAME="Test Coverage"
-export K_SOUP_COV_FORMATTERS="html,xml,rcov,lcov,json,tty"
-export K_SOUP_COV_MIN_BRANCH=86 # Means you want to enforce X% branch coverage
-export K_SOUP_COV_MIN_LINE=94 # Means you want to enforce X% line coverage
+export K_SOUP_COV_FORMATTERS="html,xml,rcov,lcov,json"
+export K_SOUP_COV_MIN_BRANCH=79 # Means you want to enforce X% branch coverage
+export K_SOUP_COV_MIN_LINE=92 # Means you want to enforce X% line coverage
 export K_SOUP_COV_MIN_HARD=true # Means you want the build to fail if the coverage thresholds are not met
 export K_SOUP_COV_MULTI_FORMATTERS=true
 export K_SOUP_COV_OPEN_BIN= # Means don't try to open coverage results in browser
 export MAX_ROWS=1 # Setting for simplecov-console gem for tty output, limits to the worst N rows of bad coverage
 
+# timecop-rspec
+export GLOBAL_TIME_TRAVEL_TIME=2025-08-15
+
 # Internal Debugging Controls
 export DEBUG=false # do not allow byebug statements (override in .env.local)
-export FLOSS_FUNDING_DEBUG=false # extra logging to help diagnose issues (override in .env.local)
+export FLOSS_CFG_FUND_DEBUG=false # extra logging to help diagnose issues (override in .env.local)
 export AUTOGEN_FIXTURE_CLEANUP=false # autogenerated gem fixture cleanup after every RSpec run
 export FLOSS_CFG_FUNDING_LOGFILE=tmp/log/debug.log
 

.floss_funding.yml

@@ -1,2 +1,19 @@
-library_name: floss_funding
-funding_uri: https://floss-funding.dev
+---
+funding_subscription_uri:
+- https://floss-funding.dev/subscribe
+suggested_subscription_amounts:
+- 5
+funding_donation_uri:
+- https://floss-funding.dev/donate
+suggested_donation_amounts:
+- 10
+library_name:
+- floss_funding
+homepage:
+- https://github.com/galtzo-floss/floss_funding
+authors:
+- Peter H. Boling
+email:
+- floss@galtzo.com
+funding_uri:
+- https://github.com/sponsors/pboling

.github/workflows/coverage.yml

@@ -6,8 +6,8 @@ permissions:
   id-token: write
 
 env:
-  K_SOUP_COV_MIN_BRANCH: 86
-  K_SOUP_COV_MIN_LINE: 94
+  K_SOUP_COV_MIN_BRANCH: 79
+  K_SOUP_COV_MIN_LINE: 92
   K_SOUP_COV_MIN_HARD: true
   K_SOUP_COV_FORMATTERS: "html,xml,rcov,lcov,tty"
   K_SOUP_COV_DO: true
@@ -93,6 +93,7 @@ jobs:
       # Build will fail here if coverage upload fails
       #   which will hopefully be noticed for the lack of code coverage comments
       - name: Upload coverage to CodeCov
+        if: ${{ !env.ACT }}
         uses: codecov/codecov-action@v5
         with:
           use_oidc: true
@@ -113,7 +114,7 @@ jobs:
           hide_complexity: true
           indicators: true
           output: both
-          thresholds: '94 86'
+          thresholds: '92 79'
         continue-on-error: ${{ matrix.experimental != 'false' }}
 
       - name: Add Coverage PR Comment

.github/workflows/deps_locked.yml → .github/workflows/locked_deps.yml

@@ -3,13 +3,13 @@
 #
 # Two often conflicting goals resolved!
 #
-#  - deps_unlocked.yml
+#  - unlocked_deps.yml
 #    - All runtime & dev dependencies, but does not have a `gemfiles/*.gemfile.lock` committed
-#    - Uses an Appraisal2 "deps_unlocked" gemfile, and the current MRI Ruby release
+#    - Uses an Appraisal2 "unlocked_deps" gemfile, and the current MRI Ruby release
 #    - Know when new dependency releases will break local dev with unlocked dependencies
 #    - Broken workflow indicates that new releases of dependencies may not work
 #
-#  - deps_locked.yml
+#  - locked_deps.yml
 #    - All runtime & dev dependencies, and has a `Gemfile.lock` committed
 #    - Uses the project's main Gemfile, and the current MRI Ruby release
 #    - Matches what contributors and maintainers use locally for development
@@ -21,7 +21,17 @@ permissions:
   contents: read
 
 env:
-  KITCHEN_SINK: true
+  # Running coverage, but not validating minimum coverage,
+  #   because it would be redundant with the coverage workflow.
+  # Also we can validate all output formats without breaking CodeCov,
+  #   since we aren't submitting these reports anywhere.
+  K_SOUP_COV_MIN_BRANCH: 71
+  K_SOUP_COV_MIN_LINE: 86
+  K_SOUP_COV_MIN_HARD: false
+  K_SOUP_COV_FORMATTERS: "html,xml,rcov,lcov,json,tty"
+  K_SOUP_COV_DO: true
+  K_SOUP_COV_MULTI_FORMATTERS: true
+  K_SOUP_COV_COMMAND_NAME: "Test Coverage"
 
 on:
   push:

.github/workflows/deps_unlocked.yml → .github/workflows/unlocked_deps.yml

@@ -3,13 +3,13 @@
 #
 # Two often conflicting goals resolved!
 #
-#  - deps_unlocked.yml
+#  - unlocked_deps.yml
 #    - All runtime & dev dependencies, but does not have a `gemfiles/*.gemfile.lock` committed
-#    - Uses an Appraisal2 "deps_unlocked" gemfile, and the current MRI Ruby release
+#    - Uses an Appraisal2 "unlocked_deps" gemfile, and the current MRI Ruby release
 #    - Know when new dependency releases will break local dev with unlocked dependencies
 #    - Broken workflow indicates that new releases of dependencies may not work
 #
-#  - deps_locked.yml
+#  - locked_deps.yml
 #    - All runtime & dev dependencies, and has a `Gemfile.lock` committed
 #    - Uses the project's main Gemfile, and the current MRI Ruby release
 #    - Matches what contributors and maintainers use locally for development
@@ -55,7 +55,7 @@ jobs:
         include:
           # Ruby <whichever version is current, e.g., 3.4 as of 2025-07-12>
           - ruby: "ruby"
-            appraisal_name: "deps_unlocked"
+            appraisal_name: "unlocked_deps"
             exec_cmd: "rake"
             gemfile: "Appraisal.root"
             rubygems: latest

.gitignore

@@ -48,5 +48,5 @@ Appraisal.*.gemfile.lock
 /spec/fixtures/gem_mine/*
 /spec/fixtures/bench_gems/*
 
-# Lockfiles
+# Sentinels
 .floss_funding.*.lock

.junie/guidelines.md

@@ -85,7 +85,8 @@ This document captures project-specific knowledge to streamline setup, testing,
       stub_env("FLOSS_FUNDING_MY_NS" => "Free-as-in-beer")
       # example code continues
   - If your spec needs to assert on console output, tag it with :check_output. By default, STDOUT is silenced.
-  - Use Timecop for deterministic time-sensitive behavior as needed (require config/timecop is already done by spec_helper).
+  - Use Timecop::Rspec for deterministic time-sensitive behavior as needed
+    - see spec/config/timecop_rspec.rb for usage examples.
 - Demonstrated example (executed and verified during this session)
   - Example spec content used:
     - File: spec/floss_funding/demo_spec.rb