andromeda_cms 0.4.2 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b3e717009de7bff8e377893a2d94e810d58c3c26827124c63efefdb5e26871df
-  data.tar.gz: d7516800193e99d6a1b67ddf781f6703ea56dad3a76e20ed6bc5adbaf1618b33
+  metadata.gz: 3e28cb7d39787447bf6360e6bfc15477843f77cdab11b1fad64b47cc17be65b2
+  data.tar.gz: bd742b08aaf8ddb578cbb3b0417433c6c399e74b99484bbbde059c76037e6704
 SHA512:
-  metadata.gz: 5062e06b1700c44ebd3adcc4d440d6d929a6f38d593c73491a3d87f7161593e2776b8f9d50fd1ad37b2d6e4c87e15a288bd5d864d5b0961eed113e177c064479
-  data.tar.gz: ebf5ff1699e815b80c540f41b897c0977197fa6a7e18089f42f0049800602178e3217f6f651e988b1f49b2b1dbcc16650e0dd904660ebe53ccf29a53e1d56030
+  metadata.gz: '09057949a55b6029eab67c488989e6a7f4cfd14d67468b7517a07b3eddfbcbd70a2bf1118c5daaaec7663a5a62387efefd0a560315bf640d869221976098f55c'
+  data.tar.gz: 8d92e0d40e78db9985dceb71ec227c89f02a7fc245102d32521bb6de2d243f375f591ddbbfbd52397d0c62371cb6bb0a9f84fbef22b0d10ed911bf98c7adc4a8

data/CHANGELOG.md

@@ -5,6 +5,31 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.0] - 2026-10-08
+
+### Added
+
+- `Entry.replace_entries(list)` swaps a collection's entries in tests without
+  depending on internal cache variables; `reload!` restores the real ones.
+
+### Fixed
+
+- The gem now requires `json < 3`, so `bundle update` no longer pulls in a
+  version that breaks session cookie decryption on Rails 8.1. The `Gemfile`
+  pin from the README is no longer needed.
+
+## [0.5.0] - 2026-10-07
+
+### Changed
+
+- `andromeda_content` now wraps the entry body in an `<andromeda-content>`
+  element, so the body can be targeted from CSS. Browsers treat an unknown
+  element as inline, so add `andromeda-content { display: block; }` to your
+  stylesheet. Markup that selected the body's direct children from the
+  parent element needs updating. Inside a component rendered during
+  `andromeda:build` the wrapper is left out, so an embedded entry is not
+  wrapped twice.
+
 ## [0.4.2] - 2026-09-30
 
 ### Fixed
@@ -141,6 +166,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Generators: `andromeda:install`, `andromeda:collection`,
   `andromeda:component` and `andromeda:import_astro`.
 
+[0.6.0]: https://github.com/AndromedaCMS/andromeda_cms/releases/tag/v0.6.0
+[0.5.0]: https://github.com/AndromedaCMS/andromeda_cms/releases/tag/v0.5.0
 [0.4.2]: https://github.com/AndromedaCMS/andromeda_cms/releases/tag/v0.4.2
 [0.4.1]: https://github.com/AndromedaCMS/andromeda_cms/releases/tag/v0.4.1
 [0.4.0]: https://github.com/AndromedaCMS/andromeda_cms/releases/tag/v0.4.0

data/README.md

@@ -107,6 +107,10 @@ end
 </article>
 ```
 
+`andromeda_content` wraps the body in an `<andromeda-content>` element. Browsers
+treat it as inline by default, so add `andromeda-content { display: block; }`
+to your stylesheet.
+
 From there it is your code. A typical next step is to make fields mandatory,
 add a draft flag, and add a table of contents:
 
@@ -303,16 +307,27 @@ bundle exec rake test:corpus  # after test/fetch_corpus.sh: parse ~370 real Astr
 ## Troubleshooting
 
 **`ArgumentError: wrong number of arguments (given 2, expected 1)` from `JSON.parse`.**
-Not this gem: Rails 8.1 calls `JSON.parse` with a positional options hash, which
-version 3 of the `json` gem no longer accepts, and decrypting a session cookie
-hits that path — so pages fail only once a session exists. Pin the `json` gem
-until Rails ships a fix:
+Not this gem's code: Rails 8.1 calls `JSON.parse` with a positional options hash,
+which version 3 of the `json` gem no longer accepts, and decrypting a session
+cookie hits that path, so pages fail only once a session exists. The gem
+restricts `json` to `< 3` to avoid this. If you are on an older andromeda_cms,
+pin it in your own `Gemfile` until Rails ships a fix:
 
 ```ruby
 # Gemfile
 gem "json", "~> 2.9"
 ```
 
+## Testing
+
+To run model tests against entries that are not files under `app/content`,
+swap them in with `replace_entries` and restore the real ones with `reload!`:
+
+```ruby
+setup    { Content::Post.replace_entries([Content::Post.new(id: "a", collection: :posts, data: { title: "A" }, body: "", file_path: "a.md", digest: "x")]) }
+teardown { Content::Post.reload! }
+```
+
 ## Contributing
 
 Bug reports are welcome; patches are not. Andromeda is open source but not open

data/lib/andromeda/entry.rb

@@ -184,6 +184,22 @@ module Andromeda
         @entries_signature = nil
       end
 
+      # Swaps the collection's entries for `list`, so tests can run against
+      # entries that are not backed by files under `app/content`. The cache
+      # signature is set to match the current source files, so the next query
+      # keeps `list` instead of noticing a mismatch and re-reading the files;
+      # setting `@entries` alone leaves the signature nil and the swap is
+      # silently undone. A later source file change, or `reload!`, restores
+      # the real entries.
+      #
+      # @param list [Array<Andromeda::Entry>]
+      # @return [Array<Andromeda::Entry>]
+      def replace_entries(list)
+        @entries = list.to_a.dup
+        @entries_signature = production? ? nil : source_signature
+        @entries
+      end
+
       private
 
       # Production never touches source files: everything a query

data/lib/andromeda/helpers.rb

@@ -5,7 +5,11 @@ module Andromeda
   # thin presentation layer over data the build already produced: no parsing
   # or rendering happens while serving a request.
   module Helpers
-    # Outputs an entry's converted body. Marked html_safe because the build
+    # Outputs an entry's converted body, wrapped in `<andromeda-content>` so
+    # it can be targeted from CSS. Inside a component rendered at conversion
+    # time the wrapper is left out: the component's output is stored in the
+    # entry's html and wrapped once, when the page is served. Marked
+    # html_safe because the build
     # produced this markup from content the application's own authors wrote,
     # the same trust model Astro applies to `.md`/`.mdx` (see 13_security).
     # Inside a component rendered at conversion time the asset markers are
@@ -14,8 +18,9 @@ module Andromeda
     # @param entry [Andromeda::Entry]
     # @return [ActiveSupport::SafeBuffer]
     def andromeda_content(entry)
-      html = Andromeda::BuildContext.converting? ? entry.html : Andromeda::Assets.resolve(entry.html)
-      html.html_safe # rubocop:disable Rails/OutputSafety
+      return entry.html.html_safe if Andromeda::BuildContext.converting? # rubocop:disable Rails/OutputSafety
+
+      tag.send("andromeda-content", Andromeda::Assets.resolve(entry.html).html_safe) # rubocop:disable Rails/OutputSafety
     end
 
     # Inside a component partial rendered at conversion time, this returns

data/lib/andromeda/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Andromeda
-  VERSION = "0.4.2"
+  VERSION = "0.6.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: andromeda_cms
 version: !ruby/object:Gem::Version
-  version: 0.4.2
+  version: 0.6.0
 platform: ruby
 authors:
 - LIMHAUS Inc.
@@ -65,6 +65,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
 description: |
   Andromeda brings Astro's content collections to an ordinary Ruby on Rails
   app. Markdown and MDX files copied from an Astro project are validated