caber 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 71093a528267100a6e810a9906de6dc3bde29357d54f9b4557926c0d9ce5852b
-  data.tar.gz: cdcfda7d716bc8e5f9fd307d803ce8eba968477e724a872e03f8e088c02da0a5
+  metadata.gz: 3e3022bcc88c31576a8e8f204063bb1cb3a3a2365cee60f5d5d8769779821719
+  data.tar.gz: 9509f57e488c365e11cba921957db94d0f518e476f5457f56c8f12a39c160f54
 SHA512:
-  metadata.gz: 47d31508f48f5390523980e2507e6654412f4eca34e5af152cbb704fb4b7b72a35020189edf1afe41e04db3f88cd080f69f815a0546578e1719734c88a147b06
-  data.tar.gz: 2b48730f693d2ca3425ae70d2df0f950dfaa6dc24a353cbcba06bd08696772ed3cf3c668b2cce7c28e2b99d536ef87ac79ba76adb342fc03e4d6bccd164f4f73
+  metadata.gz: 6c3fb313ae9125c1bf96a857be7abc2b8c2dead1aa4a8e1c9347d08c3e3b2dbe634e6919dac1ccafb673e97002855d0b1ded604fc77d64e4da1b0055b8ba744e
+  data.tar.gz: bb2d952b4fe708bc50194f167bf11cd01fdfdaf5d02a64a50a9c2cd8d3d8f66d0980d84f1c1922f54237cf216bd958788edbbe0b447f7229381c6bf211ed9f52

data/README.md

@@ -1,6 +1,11 @@
 # Caber
 
-A simple ReBAC / Zanzibar gem for Rails apps.
+![Gem Downloads (for latest version)](https://img.shields.io/gem/dtv/caber)
+![Libraries.io dependency status for latest release](https://img.shields.io/librariesio/release/rubygems/caber)
+![Dependent repos (via libraries.io)](https://img.shields.io/librariesio/dependent-repos/rubygems/caber)
+
+
+A simple [ReBAC](https://en.wikipedia.org/wiki/Relationship-based_access_control) / [Zanzibar](https://research.google/pubs/zanzibar-googles-consistent-global-authorization-system/) backend plugin for Rails apps. Allows you to easily specify permission relationships between pairs of objects, e.g. granting edit permission on a document to a specific user, like in Google Docs.
 
 ## Installation
 
@@ -123,6 +128,49 @@ Document.granted_to "viewer", user
 # => All the documents that user has "viewer" permission on
 ```
 
+## Usage with other gems
+
+### Pundit
+
+Caber makes for nice clear [Pundit](https://github.com/varvet/pundit) policies:
+
+```
+class DocumentPolicy < ApplicationPolicy
+  class Scope < ApplicationPolicy::Scope
+    def resolve
+      scope.granted_to(["viewer", "editor", "owner"], user)
+    end
+  end
+
+  def update?
+    record.grants_permission_to? ["editor", "owner"], user
+  end
+end
+```
+
+### Rolify
+
+Caber doesn't include groups specifically, but you can integrate it easily with a role management gem like [Rolify](https://github.com/RolifyCommunity/rolify) pretty easily. Make your Role class a subject, and you can grant permissions to roles:
+
+```
+class Document < ApplicationRecord
+  include Caber::Object
+  can_grant_permissions_to Role
+end
+
+class Role < ApplicationRecord
+  include Caber::Subject
+  can_have_permissions_on Document
+
+  scopify
+end
+
+document.grant_permission_to "editor", Role.find_by(name: "editor")
+
+User.with_role(document.permitted_roles.with_permission("editor"))
+# => all users with a role that can edit the document
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests.
@@ -131,11 +179,7 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/manyfold3d/caber. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
-
-## Code of Conduct
-
-Everyone interacting in the Caber project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/manyfold3d/caber/blob/master/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitHub at https://github.com/manyfold3d/caber. This project is intended to be a safe, welcoming space for collaboration; everyone interacting in the Caber project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/manyfold3d/caber/blob/master/CODE_OF_CONDUCT.md).
 
 ## Acknowledgements
 

data/app/models/concerns/caber/object.rb

@@ -11,8 +11,7 @@ module Caber::Object
 
     scope :granted_to, ->(permission, subject) {
                          includes(:caber_relations).where(
-                           "caber_relations.subject_id": subject.id,
-                           "caber_relations.subject_type": subject.class.name,
+                           "caber_relations.subject": subject,
                            "caber_relations.permission": permission
                          )
                        }

data/lib/caber/version.rb

@@ -1,3 +1,3 @@
 module Caber
-  VERSION = "0.3.0"
+  VERSION = "0.3.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: caber
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - James Smith