astroturf 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 79d39987b44a757f2689d900dd7256baef7b9d95a3206bf33384b84d57c84b9a
-  data.tar.gz: '004561878c96134cdfe94faf12bfb503985aa941e608e353b6a055f8d39073dc'
+  metadata.gz: 0c840afa6051a6e128fd5e66f56e5dc19e57da9e0d9258985b1f3c326fcbcb52
+  data.tar.gz: d13ba6b04700248f94a6e0d68f7fa04e7a5ed611623d90a061de95b53c6bfe73
 SHA512:
-  metadata.gz: 49b5b8e9dba709aaef0bb233a04a0be9d97feac081a59a139a193b915a7b300316dfd39d5440469a12d568ac3052093f7eb9ff5930729c262f8fa9592d072dc4
-  data.tar.gz: 1d660ba73e13a93ea2c385815a7ea8283093aac4329bd5321b5b4b77d779caa5ebe523b50a72b94f23ae1b6d951ab4762f6d7ef8ba5de6d9cd10eb2647ec4965
+  metadata.gz: 5e69982ff8ae987fdb50b8e0ac46ed7f9bf9c764e30691dcf727be13c7311edadecc7bcc6370261a08d8df262437bbda236cd72030ceaa37237594f919898a40
+  data.tar.gz: f737ba2834e8765e25774945dc4c5efebd61524917a0d542b3a19e4103a14ab87e05edee7c5089a9e7e4504f7ce43a4749199c2f14b1a5cbb47d3b7245d65b1e

data/.gitignore

@@ -1,6 +1,8 @@
 *.gem
 *.rbc
 /.config
+.ruby-version
+Gemfile.lock
 /coverage/
 /InstalledFiles
 /pkg/

data/.okf/README.md

@@ -0,0 +1,7 @@
+# OKF (Open Knowledge Format)
+
+This directory maintains agent and developer architecture records, decision logs, and project knowledge for Astroturf.
+
+## Directory Structure
+
+- `decisions/`: Architecture Decision Records (ADRs) tracking design choices, tradeoffs, and rationale.

data/.okf/decisions/0001-initial-architecture.md

@@ -0,0 +1,32 @@
+# ADR 0001: Initial Architecture and Matrix Design
+
+## Context
+When performing large-scale architectural refactors or AI-assisted system rewrites, existing test data strategies (such as manual fixtures or procedural factories) test only a sparse subset of happy-path states. Hidden edge cases (such as unhandled enum combinations, boolean permutations, or foreign key cascades) are frequently missed.
+
+Astroturf was conceived to aim for total coverage of value and combination space through declarative YAML matrices.
+
+## Decisions
+
+1. **Pure Ruby In-Memory Hashes as Primary Representation**:
+   - Astroturf builds pure Ruby hashes first without requiring an active database connection or ActiveRecord dependency.
+   - Decoupling generation from ORM storage allows maximum generation speed and makes equivalence comparison straightforward.
+
+2. **Full Cartesian Product by Default**:
+   - Attribute dimensions are computed as full Cartesian products.
+   - For nested associations (`has_many`), the default mode is `:combinations`, providing each parent record with the full combination matrix of child records.
+   - An optional `:count` mode is supported when fixed cardinality is desired per parent.
+
+3. **Deterministic Fixture-Style Slug Labels**:
+   - Records receive semantic labels derived from entity names and matrix coordinates (e.g. `user_admin_active_true`).
+   - Labels make test failures and refactor diffs immediately diagnosable.
+
+4. **Pluggable Primary Key Strategies**:
+   - Supports monotonic integer sequences (`1, 2, 3...`) with configurable start/step offsets.
+   - Supports deterministic RFC 4122 UUIDv5 values generated from record labels to ensure consistency across runs.
+   - Supports custom callable procs.
+
+5. **Self-Contained Inflection**:
+   - Includes a lightweight `Astroturf::Inflector` for singular/plural/tableize conversions, avoiding a mandatory heavyweight dependency on ActiveSupport for basic usage.
+
+6. **Ruby 3.4/4.0 Compatibility**:
+   - Explicitly adds `ostruct` as a development dependency in the gemspec to prevent `LoadError` when Rake tasks run under modern Ruby environments where `ostruct` is a bundled gem.

data/astroturf.gemspec

@@ -23,5 +23,6 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_development_dependency "minitest", "~> 5.0"
-  spec.add_development_dependency "rake", "~> 12.0"
+  spec.add_development_dependency "rake", ">= 12.0"
+  spec.add_development_dependency "ostruct"
 end

data/lib/astroturf/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: astroturf
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Jeff Lunt
@@ -27,16 +27,30 @@ dependencies:
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '12.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '12.0'
+- !ruby/object:Gem::Dependency
+  name: ostruct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Astroturf generates combinatorial synthetic data graphs in memory from
   declarative YAML matrix specifications.
 email:
@@ -46,6 +60,8 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".okf/README.md"
+- ".okf/decisions/0001-initial-architecture.md"
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -82,7 +98,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.16
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Exhaustive synthetic data generator for Rails and Ruby applications
 test_files: []