cafe_car 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7349873b72f79f05fd45bdb30e1a474b0d89d0b8352172378f6cecd239cc4f56
-  data.tar.gz: 1c2dcb971ecb7426bd168add0ffd46bff5fff204600e6f125aaa853db983feea
+  metadata.gz: 8f2ee78455723f808d6f02bbcad83ac86cd5f4fcf8c05203bd3afc602afe1d4f
+  data.tar.gz: '09447696c9bd504e776cc1cc493025ff99ceb467276ca916eb660165bfdf42cc'
 SHA512:
-  metadata.gz: 7d9aebfaa9fec6e15149003739dab554bcd1e3279c66ef040fba72656b8d916c411cac39e05589e08e3b95b28a77311fac6875068e9a6f527f73c8a16d43fbe7
-  data.tar.gz: 037c7c894cd5c161e3c3544195074888d71166a6504e5e3115cd660372ac4038d793a1e78ab65713e760a49d019ff32717b73c99eba59a62fe935234705adfde
+  metadata.gz: b39a51b42de3e8ffa3440e3d714eab15415592e30077187ddabf970826f64ef210d7f4f3e6a61ef28de43e0c8715dbaba35367700d1f2537fad3817c16b347ee
+  data.tar.gz: 30792c4c93baf653babd0f2bb64dc0790875faa41db6ef7d5dcf93e69238c146752930794a2672f68eee83c15facfb537b200825750b370d2199e79dc627cc2e

data/README.md

@@ -33,6 +33,55 @@ an application-wide or model-specific basis.
 
 **Perfect for**: Admin panels, internal tools, and rapid prototyping.
 
+## Table of Contents
+
+- [How CafeCar compares](#how-cafecar-compares)
+- [Features](#features)
+- [Prerequisites](#prerequisites)
+- [Installation](#installation)
+- [Getting Started](#getting-started)
+- [Core Components](#core-components)
+  - [Controllers](#controllers)
+  - [Policies](#policies)
+  - [Presenters](#presenters)
+  - [UI Components](#ui-components)
+  - [Forms](#forms)
+  - [Filtering & Sorting](#filtering--sorting)
+- [Advanced Usage](#advanced-usage)
+- [Sessions & Authentication](#sessions--authentication)
+- [Generators](#generators)
+  - [Resource Generator](#resource-generator)
+  - [Controller Generator](#controller-generator)
+  - [Policy Generator](#policy-generator)
+  - [Notes Generator](#notes-generator)
+  - [Sessions Generator](#sessions-generator)
+- [Configuration](#configuration)
+- [Testing](#testing)
+- [Contributing](#contributing)
+- [License](#license)
+
+## How CafeCar compares
+
+CafeCar is convention-first. Rather than a separate admin app with its own DSL,
+it extends Rails' own view layer: a plain model renders a working admin with
+essentially no configuration, and you extend it with the Rails you already know
+— controllers, Pundit policies, presenters, and ERB. There's no new query
+language or admin framework to learn; you stay in Rails.
+
+The established alternatives are all solid, and each fits a different taste.
+Reach for one of them when its model matches how you want to work:
+
+| Gem | Reach for it when… | Trade-off |
+| --- | --- | --- |
+| **ActiveAdmin** | You want a mature, batteries-included admin with a rich registration DSL. | You author screens in its Arbre/Ruby DSL rather than plain Rails views. |
+| **Avo** | You prefer defining resources through configuration and want polished paid Pro features. | Config-driven, and the richer tiers are commercial. |
+| **Administrate** | You want to scaffold controllers and views you fully own and edit. | You maintain the generated code as your app grows. |
+| **RailsAdmin** | You want an admin mounted as an engine with almost zero setup. | Heavy runtime introspection and less conventional customization. |
+| **Trestle** | You like a modular, DSL-driven admin with a built-in UI toolkit. | Another admin DSL to learn alongside Rails. |
+
+Reach for CafeCar when you want a Rails-native, convention-over-configuration
+admin that you extend with ordinary Rails code.
+
 ## Features
 
 - 🚀 **Auto-generated CRUD interfaces** - One line of code generates complete
@@ -79,7 +128,7 @@ $ rails generate cafe_car:install
 
 This will:
 
-- Add required gems (cnc, bcrypt, paper_trail, factory_bot_rails, faker, rouge)
+- Add required gems (bcrypt, paper_trail, factory_bot_rails, faker, rouge)
   plus development tools (hotwire-livereload, better_errors, binding_of_caller,
   chrome_devtools_rails, i18n-debug)
 - Mount the CafeCar engine at `/` under the `:admin` namespace

data/app/controllers/concerns/cafe_car/authentication.rb

@@ -23,10 +23,17 @@ module CafeCar
     end
 
     def current_user
-      current_session.user
+      current_session&.user
     end
 
+    # No session without the opt-in infrastructure. Pundit evaluates
+    # `current_user` (its default `pundit_user`) on every authorized request, so
+    # building a session here would 500 a CRUD-only host that never ran
+    # `cafe_car:sessions`. Gate on `sessions_available?` so it degrades to a nil
+    # user (→ 403) instead.
     def current_session
+      return unless sessions_available?
+
       CafeCar[:Current].session ||= find_session_by_cookie || build_session
     end
 

data/lib/cafe_car/version.rb

@@ -1,3 +1,3 @@
 module CafeCar
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

data/lib/generators/cafe_car/policy/policy_generator.rb

@@ -22,19 +22,28 @@ class CafeCar::PolicyGenerator < Rails::Generators::NamedBase
 
   def model_class = file_path.classify.safe_constantize
 
-  def model  = @model ||= CafeCar[:ModelInfo].new(model_class)
+  def model  = @model ||= CafeCar[:ModelInfo].new(model: model_class)
 
   def attribute_names
-    @attribute_names ||= permitted.presence || model.fields.editable.map(&:method)
+    @attribute_names ||= permitted.presence || model_fields
+  end
+
+  # Introspect the model's editable columns, but only when it resolves to a
+  # loaded constant — a resource run writes the model file first but may not
+  # have autoloaded it yet, in which case the caller forwards explicit fields.
+  def model_fields
+    return [] if model_class.nil?
+
+    model.fields.editable.map(&:method)
   end
 
   def title_attribute
-    return ":could_not_find_model" if model_class.nil?
+    return ":could_not_find_model" if attribute_names.blank?
     attribute_names.first.then { ":#{_1}" }
   end
 
   def permitted_attributes
-    return ":create_model_first_to_generate_attributes" if model_class.nil?
+    return ":create_model_first_to_generate_attributes" if attribute_names.blank?
 
     # TODO: replace *_digest with * and *_confirmation
     # TODO: handle attachments

data/lib/generators/cafe_car/resource/resource_generator.rb

@@ -16,11 +16,17 @@ class CafeCar::ResourceGenerator < Rails::Generators::NamedBase
   end
 
   def create_policy
-    generate "cafe_car:policy", file_path, force
+    generate "cafe_car:policy", file_path, *field_names, force
   end
 
   private
 
+  # The policy generator wants bare field names (`name price`), not the model
+  # generator's `field:type:index` form. Forwarding them lets the policy list
+  # real permitted attributes instead of falling back to model introspection,
+  # which can't see a model that isn't a loaded constant yet mid-run.
+  def field_names = attributes.map { _1.to_s.split(":").first }
+
   def assign_controller_names!(...)
     if options[:model_name].blank?
       assign_names!(file_name)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cafe_car
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Jeff Peterson
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-30 00:00:00.000000000 Z
+date: 2026-07-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails