guarda 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8ffe343cd6f4cd51a1b384fdb4e1299d14960e574a60fd2ef7e5d03298563289
-  data.tar.gz: 60096b5bd502a631c19b5df0a028fd2e4d96828645da9409f47a53f19ea74b95
+  metadata.gz: 830ac445fca08b8bb6ca80668803ee4d65089e5268240ade28ae32c78e0859c5
+  data.tar.gz: c0ed99948611035e596f6208da48a4be92688ca27c8ee6334ec155ba4ac03f28
 SHA512:
-  metadata.gz: 6b1b618a33b3b7a27322cad51b872af9aca19d3d309dbeaf3004112e82b808c859bab5e4c688be6d6f0d98e6ef5ec4359f7573e464e105e8a64563b7d12e2170
-  data.tar.gz: 01bea2ae2c82935e7cfead682f1cedcee50ccace4810b14e1f5f4f5cfbb0d3e20f85fe19eaceccfb904693480c77d1e429e405c26ebcbc3f8da18366f79507fc
+  metadata.gz: fbd646715e014941f75d5b0a1b3725012eb2a774eb03d713647383a9dc347d1cb9a11a1813275c9fbedab72b3ccba81cb2bb3d0558aecb4c29042f570cb8dc62
+  data.tar.gz: c2b37e7eb562b11dd6dd86dfac120cb7b4035c3a2000082749bd71f46c69f842133df5700b031137b581ce70e132039189309a226111c79acdde8fbb7dbcac2d

data/CLAUDE.md

@@ -0,0 +1,38 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## What is Guarda
+
+Guarda is a lightweight Ruby authorization gem. It uses Rails' `CurrentAttributes` (`Current.person`) for the authenticated user and convention-based policy class discovery.
+
+## Commands
+
+```bash
+bundle exec rake test                                    # Run full test suite
+bundle exec rake test TEST=test/authorization_test.rb    # Run a single test file
+bundle exec rake build                                   # Build the gem
+bundle exec rake release                                 # Release to RubyGems
+```
+
+## Architecture
+
+The gem has three core components in `lib/`:
+
+- **`guarda.rb`** — Root module. Defines the exception hierarchy: `Guarda::Error`, `NotAuthorizedError`, `AuthorizationNotPerformedError`, `PolicyFinder::NotFoundError`.
+- **`guarda/authorization.rb`** — An `ActiveSupport::Concern` included in controllers. Provides `authorize(record=nil)`, `policy(controller, record=nil)`, and `verify_authorization_performed`. The `policy` method is also exposed as a view helper.
+- **`guarda/policy_finder.rb`** — Resolves controller paths to policy classes by convention (e.g., `"posts"` → `PostsPolicy`, `"admin/tests"` → `Admin::TestsPolicy`). Uses `safe_constantize`.
+
+## Policy Convention
+
+Policy classes are plain Ruby classes named `{Controller}Policy` with predicate methods matching action names (e.g., `index?`, `show?`, `update?`). They receive an optional record in their constructor. The authenticated user is accessed via `Current.person` inside the policy.
+
+## Test Setup
+
+Tests use Minitest with `ActiveSupport::TestCase`. The `test/test_helper.rb` defines mock objects: a `Controller` class that includes `Guarda::Authorization`, test policy classes (`TestsPolicy`, `Admin::TestsPolicy`), and a `Record` struct.
+
+## Dependencies
+
+- Ruby >= 3.1.0
+- `activesupport ~> 7.1` (runtime)
+- `minitest`, `minitest-reporters`, `rake` (development)

data/lib/guarda/authorization.rb

@@ -17,6 +17,8 @@ module Guarda
 
       policy(controller, record).public_send(query) ||
         raise(NotAuthorizedError, self.class)
+
+      record
     end
 
     def policy(controller, record = nil)

data/lib/guarda/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Guarda
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: guarda
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Abdullah Hashim
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-02-01 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -50,17 +49,16 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.6.1
-description:
 email:
 - abdul@hey.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CLAUDE.md
 - LICENSE.txt
 - README.md
 - Rakefile
-- guarda.gemspec
 - lib/guarda.rb
 - lib/guarda/authorization.rb
 - lib/guarda/policy_finder.rb
@@ -72,7 +70,6 @@ licenses:
 metadata:
   homepage_uri: https://www.guidedrails.com
   source_code_uri: https://github.com/Guided-Rails/guarda
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -87,8 +84,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Another authorization gem
 test_files: []

data/guarda.gemspec

@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "lib/guarda/version"
-
-Gem::Specification.new do |spec|
-  spec.name = "guarda"
-  spec.version = Guarda::VERSION
-  spec.authors = ["Abdullah Hashim"]
-  spec.email = ["abdul@hey.com"]
-
-  spec.summary = "Another authorization gem"
-  spec.homepage = "https://www.guidedrails.com"
-  spec.license = "MIT"
-  spec.required_ruby_version = ">= 3.1.0"
-
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "https://github.com/Guided-Rails/guarda"
-
-  spec.files = Dir.chdir(__dir__) do
-    `git ls-files -z`.split("\x0").reject do |f|
-      (File.expand_path(f) == __FILE__) ||
-        f.start_with?(*%w[bin/ test/ spec/ features/ .git appveyor Gemfile])
-    end
-  end
-
-  spec.bindir = "exe"
-  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-
-  spec.add_development_dependency "activesupport", "~> 7.1", ">= 7.1.3"
-  spec.add_development_dependency "minitest-reporters", "~> 1.6", ">= 1.6.1"
-end