yaml_exporter 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 11669d9671c43a7dced493565d65af864c3e0b61ba583c40b678f547dc952796
-  data.tar.gz: 2f235b07235119bffc293e3030bbeaedfb8f4eca263ef921d0076a83bf658e0c
+  metadata.gz: e760f89f11f40a2f5e94e6e44348da196bd2da09267ad7585070f21c3cf998da
+  data.tar.gz: 8a2261d83c43f0a9ad8be36e3cdb425984dc42088a6cf49d839a779d820e0a80
 SHA512:
-  metadata.gz: 29676b99c64faa28c7e70fddd67fb1376fe9d0ff1bf1657318197367021313164048eb8e75d8ff7e6cbb90b0eba48bbc71ee7aa3fe8ab32bc23e431adc6a8d0b
-  data.tar.gz: 618c63aa98999137b72d3dfc030cb9d861f29a60c333671d58fa21e71974ced9041dd10a6d2c49176669c627d9edca92a19965743945682225e807bffe8f41ef
+  metadata.gz: 40c9ba2b0c249095bf6e88bed66cd13c4a37c6e3566c1f4d3b5308e19df475cc897215962840513b8de90d1298f675d5492c1f8315993840e27dbe77a4de204f
+  data.tar.gz: 347bb621e9f981bdb61899864b70b8659f11b65691fc67c8ccf2bc8417ae1cf0c6ae6f39a091efa1c99f3314ebc1951d650d014a217a9fb2d5970db6d579ae57

data/.github/workflows/gem-push.yml

@@ -1,36 +1,27 @@
-name: Ruby Gem
+name: Push gem
 
+# Publishes to RubyGems when you publish a GitHub Release (tag `vX.Y.Z`).
+# Uses RubyGems Trusted Publishing (OIDC) — no API key stored as a secret.
+# One-time setup: on rubygems.org -> the gem -> Trusted Publishers -> add a
+# GitHub Actions publisher for this repo with workflow `gem-push.yml`.
+# See RELEASING.md.
 on:
-  push:
-    branches: [ "main" ]
-  pull_request:
-    branches: [ "main" ]
+  release:
+    types: [published]
 
 jobs:
-  build:
-    name: Build + Publish
+  push:
     runs-on: ubuntu-latest
     permissions:
-      contents: read
-      packages: write
-
+      contents: write   # let the action attach a build-provenance attestation to the release
+      id-token: write   # required for Trusted Publishing (OIDC)
     steps:
-    - uses: actions/checkout@v4
-    - name: Set up Ruby 3.3.x
-    # To automatically get bug fixes and new Ruby versions for ruby/setup-ruby,
-    # change this to (see https://github.com/ruby/setup-ruby#versioning):
-    # uses: ruby/setup-ruby@v1
-      uses: ruby/setup-ruby@v1
-      with:
-        ruby-version: 3.3.4
-
-    - name: Publish to RubyGems
-      run: |
-        mkdir -p $HOME/.gem
-        touch $HOME/.gem/credentials
-        chmod 0600 $HOME/.gem/credentials
-        printf -- "---\n:rubygems_api_key: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
-        gem build *.gemspec
-        gem push *.gem
-      env:
-        GEM_HOST_API_KEY: "${{secrets.RUBYGEMS_AUTH_TOKEN}}"
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.4'
+          bundler-cache: true
+      - run: bundle exec rake test
+      # Verifies the tag matches lib/yaml_exporter/version.rb, builds, attests,
+      # and pushes via trusted publishing.
+      - uses: rubygems/release-gem@v1

data/.github/workflows/test.yml

@@ -0,0 +1,27 @@
+name: Test
+
+on:
+  push:
+    branches: [main, find_by]
+  # No branch filter — run on every PR, including ones targeting `find_by`,
+  # so a change is tested before it is merged onto its base branch.
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    name: Ruby ${{ matrix.ruby }}
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ['3.2', '3.3', '3.4', '4.0']
+
+    steps:
+      - uses: actions/checkout@v4
+      # Resolve a fresh lockfile so each Ruby gets a compatible dependency set.
+      - run: rm -f Gemfile.lock
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - run: bundle exec rake test

data/AGENTS.md

@@ -0,0 +1,34 @@
+# AGENTS.md
+
+## Cursor Cloud specific instructions
+
+### Project overview
+
+`yaml_exporter` is a Ruby gem that provides YAML serialization/deserialization for ActiveRecord models with JSON schema generation. It is a library (not a runnable application) — there are no servers, databases, or background services to run.
+
+### Ruby version management
+
+Ruby is managed via **rbenv** (installed at `~/.rbenv`). The project targets the latest stable Ruby — currently **4.0.2**.
+
+If a future Ruby version is needed and `rbenv install <version>` fails with "definition not found", update ruby-build first:
+
+```bash
+cd ~/.rbenv/plugins/ruby-build && git pull
+rbenv install <version>
+rbenv global <version>
+```
+
+Then re-run `bundle install` in the workspace.
+
+### Key commands
+
+| Task                 | Command                                                     |
+| -------------------- | ----------------------------------------------------------- |
+| Install dependencies | `bundle install`                                            |
+| Build the gem        | `gem build yaml_exporter.gemspec`                           |
+| Verify the gem loads | `ruby -e 'require_relative "lib/yaml_exporter"; puts "OK"'` |
+
+### Notes
+
+- The gem depends on `activerecord`, `activesupport`, and `json-schema` at runtime. For manual testing, `sqlite3` is also needed (`gem install sqlite3`).
+- The gemspec uses `git ls-files` to determine included files — new files must be tracked by git to be included in builds.

data/CHANGELOG.md

@@ -0,0 +1,45 @@
+# Changelog
+
+All notable changes to this project are documented here.
+This project follows [semantic versioning](https://semver.org).
+
+## Unreleased
+
+## v0.2.0
+
+A ground-up rewrite of the export/import engine and its DSL. **Breaking: nothing
+from 0.1.0 carries over** — the module, the entry points, and the mapping API are
+all new. See the README for the full DSL.
+
+### Changed (breaking)
+
+- **New mixin API.** `include YamlExporter` in the model and declare the mapping
+  in a `yaml_structure do … end` block; round-trip with the instance methods
+  `#yaml_export` / `#yaml_import`. This replaces 0.1.0's
+  `YamlSerializable::YamlExporter.export(object, structure)` / `.import` class
+  methods that took an externally built structure — the `YamlSerializable`
+  module no longer exists.
+- **Ownership-driven DSL.** The mapping is three methods — `attributes`, `one`,
+  `many` — where shape decides ownership: a **block** owns the record
+  (YamlExporter creates, updates, and destroys records to match the YAML), while
+  **`find_by:` without a block** only resolves a reference and never creates or
+  destroys the target.
+
+### Added
+
+- `one` associations in three forms: owned (`one :x do … end`), a plain
+  reference (`one :x, find_by:`), and `one_reference_of` to reach a relation's
+  single record.
+- `many` associations: owned lists, `find_by:` reference lists, positional
+  lists, `positioned_by:` ordering, and `many … through:` (with or without a
+  block).
+- Export omits `nil` attributes by default (`yaml_export(omit_nil:)`).
+- Text columns export as YAML multiline block scalars, with surrounding
+  whitespace stripped and emojis preserved.
+- Column-based type inference and a JSON-schema-style description of a structure
+  via `.yaml_schema`.
+
+### Docs
+
+- Rewritten README covering the mental model (cardinality × ownership) and every
+  DSL form.

data/Gemfile.lock

@@ -0,0 +1,106 @@
+PATH
+  remote: .
+  specs:
+    yaml_exporter (0.2.0)
+      activerecord (>= 5.2)
+      activesupport (>= 5.2)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activemodel (8.1.3)
+      activesupport (= 8.1.3)
+    activerecord (8.1.3)
+      activemodel (= 8.1.3)
+      activesupport (= 8.1.3)
+      timeout (>= 0.4.0)
+    activesupport (8.1.3)
+      base64
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.3.1)
+      connection_pool (>= 2.2.5)
+      drb
+      i18n (>= 1.6, < 2)
+      json
+      logger (>= 1.4.2)
+      minitest (>= 5.1)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
+    base64 (0.3.0)
+    bigdecimal (4.1.1)
+    concurrent-ruby (1.3.6)
+    connection_pool (3.0.2)
+    drb (2.2.3)
+    i18n (1.14.8)
+      concurrent-ruby (~> 1.0)
+    json (2.19.3)
+    logger (1.7.0)
+    minitest (5.27.0)
+    rake (13.3.1)
+    securerandom (0.4.1)
+    sqlite3 (2.9.2-aarch64-linux-gnu)
+    sqlite3 (2.9.2-aarch64-linux-musl)
+    sqlite3 (2.9.2-arm-linux-gnu)
+    sqlite3 (2.9.2-arm-linux-musl)
+    sqlite3 (2.9.2-arm64-darwin)
+    sqlite3 (2.9.2-x86-linux-gnu)
+    sqlite3 (2.9.2-x86-linux-musl)
+    sqlite3 (2.9.2-x86_64-darwin)
+    sqlite3 (2.9.2-x86_64-linux-gnu)
+    sqlite3 (2.9.2-x86_64-linux-musl)
+    timeout (0.6.1)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    uri (1.1.1)
+
+PLATFORMS
+  aarch64-linux-gnu
+  aarch64-linux-musl
+  arm-linux-gnu
+  arm-linux-musl
+  arm64-darwin
+  x86-linux-gnu
+  x86-linux-musl
+  x86_64-darwin
+  x86_64-linux-gnu
+  x86_64-linux-musl
+
+DEPENDENCIES
+  minitest (~> 5.0)
+  rake (~> 13.0)
+  sqlite3 (>= 1.4)
+  yaml_exporter!
+
+CHECKSUMS
+  activemodel (8.1.3) sha256=90c05cbe4cef3649b8f79f13016191ea94c4525ce4a5c0fb7ef909c4b91c8219
+  activerecord (8.1.3) sha256=8003be7b2466ba0a2a670e603eeb0a61dd66058fccecfc49901e775260ac70ab
+  activesupport (8.1.3) sha256=21a5e0dfbd4c3ddd9e1317ec6a4d782fa226e7867dc70b0743acda81a1dca20e
+  base64 (0.3.0) sha256=27337aeabad6ffae05c265c450490628ef3ebd4b67be58257393227588f5a97b
+  bigdecimal (4.1.1) sha256=1c09efab961da45203c8316b0cdaec0ff391dfadb952dd459584b63ebf8054ca
+  concurrent-ruby (1.3.6) sha256=6b56837e1e7e5292f9864f34b69c5a2cbc75c0cf5338f1ce9903d10fa762d5ab
+  connection_pool (3.0.2) sha256=33fff5ba71a12d2aa26cb72b1db8bba2a1a01823559fb01d29eb74c286e62e0a
+  drb (2.2.3) sha256=0b00d6fdb50995fe4a45dea13663493c841112e4068656854646f418fda13373
+  i18n (1.14.8) sha256=285778639134865c5e0f6269e0b818256017e8cde89993fdfcbfb64d088824a5
+  json (2.19.3) sha256=289b0bb53052a1fa8c34ab33cc750b659ba14a5c45f3fcf4b18762dc67c78646
+  logger (1.7.0) sha256=196edec7cc44b66cfb40f9755ce11b392f21f7967696af15d274dde7edff0203
+  minitest (5.27.0) sha256=2d3b17f8a36fe7801c1adcffdbc38233b938eb0b4966e97a6739055a45fa77d5
+  rake (13.3.1) sha256=8c9e89d09f66a26a01264e7e3480ec0607f0c497a861ef16063604b1b08eb19c
+  securerandom (0.4.1) sha256=cc5193d414a4341b6e225f0cb4446aceca8e50d5e1888743fac16987638ea0b1
+  sqlite3 (2.9.2-aarch64-linux-gnu) sha256=eeb86db55645b85327ba75129e3614658d974bf4da8fdc87018a0d42c59f6e42
+  sqlite3 (2.9.2-aarch64-linux-musl) sha256=4feff91fb8c2b13688da34b5627c9d1ed9cedb3ee87a7114ec82209147f07a6d
+  sqlite3 (2.9.2-arm-linux-gnu) sha256=1ee2eb06b5301aaf5ce343a6e88d99ac932d95202d7b350f0e7b6d8d588580d7
+  sqlite3 (2.9.2-arm-linux-musl) sha256=8ca0de6aceede968de0394e22e95d549834c4d8e318f69a92a52f049878a0057
+  sqlite3 (2.9.2-arm64-darwin) sha256=d15bd9609a05f9d54930babe039585efc8cadd57517c15b64ec7dfa75158a5e9
+  sqlite3 (2.9.2-x86-linux-gnu) sha256=066bc904522f8a7072236a81237c03a4a1dfe070a25107e392de03d1e4ad0e6d
+  sqlite3 (2.9.2-x86-linux-musl) sha256=6503c76278f5e8629b12b6518ff43a9a4f6d9381de73f0b086c9fa1226db5ede
+  sqlite3 (2.9.2-x86_64-darwin) sha256=ed691b5021674d72582d03c5a38e89634b961902735fb6225273892805421d13
+  sqlite3 (2.9.2-x86_64-linux-gnu) sha256=dce83ffcb7e72f9f7aeb6e5404f15d277a45332fe18ccce8a8b3ed51e8d23aee
+  sqlite3 (2.9.2-x86_64-linux-musl) sha256=e8dd906a613f13b60f6d47ae9dda376384d9de1ab3f7e3f2fdf2fd18a871a2d7
+  timeout (0.6.1) sha256=78f57368a7e7bbadec56971f78a3f5ecbcfb59b7fcbb0a3ed6ddc08a5094accb
+  tzinfo (2.0.6) sha256=8daf828cc77bcf7d63b0e3bdb6caa47e2272dcfaf4fbfe46f8c3a9df087a829b
+  uri (1.1.1) sha256=379fa58d27ffb1387eaada68c749d1426738bd0f654d812fcc07e7568f5c57c6
+  yaml_exporter (0.2.0)
+
+BUNDLED WITH
+  4.0.6