warrant 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 96189752075819b0a26871afd176789c4cd60293e934b638b5ecfff4b048c8c5
-  data.tar.gz: b3831fc0752a1a64ac0da49a9e585d3eef739196ed4a9a3deffb68d3277a7429
+  metadata.gz: a62cf14af95db8e5b31f60059a2a826a67c067239edb5f6c63cf02426df3ae21
+  data.tar.gz: bdc8aa083993566c57760d484e043ad3ed64abe2bf1945ebad2428c2eb497551
 SHA512:
-  metadata.gz: a577fdd115b97e9f4a7518545c70b9ad9b3f54bfddad9b544bb56e4d431d4a06d6f0d9de2876496051c0f7c90311917788ed3d37545f19ae99e749422a59a06a
-  data.tar.gz: e8dd7505fa2ca83ed231602b0fee52eece2ca7e43b3783dc539d76f879e3d9058821c658e1af0c5aeb9544eadb5130aac4206d04b737c94c9ad36cce4d2ea0e6
+  metadata.gz: 36cf1f6120b776293513e49d5554aa70a8ff22e671105072e2f04115d1e00bc852fd4cc5326672ae9ad246f35f069718272f2abf957ff9abe27ebeed0b564efc
+  data.tar.gz: 4377ab4955b67e922622ef8c10c50c17d3281d097ec62df85ce31779df3554d8326121622024ffde252abf1a3c13655d0e3f6251d898fc78f722a1578b091daa

data/README.md

@@ -28,19 +28,19 @@ require 'warrant'
 Warrant.api_key = 'api_test_f5dsKVeYnVSLHGje44zAygqgqXiLJBICbFzCiAg1E='
 ```
 
-### `createUser(email, user_id, tenant_id)`
+### `create_user(email, user_id = '', tenant_id = '')`
 
-This method creates a user entity in Warrant with the specified `email`, `user_id` (optional), and `tenant_id` (optional). If `user_id` is not provided, one will be generated for the user.
+This method creates a user entity in Warrant with the specified `userId`. Provide an optional `username` to make it easier to identify users in the Warrant dashboard.
 
 ```ruby
-# Create user with `user.id` as the user_id and `user.email` as the username
+# Create user with user email and id
 Warrant::WarrantClient.create_user(user.email, user.id)
 
 # Create user with generated id
 Warrant::WarrantClient.create_user()
 ```
 
-### `createWarrant(objectType, objectId, relation, user)`
+### `create_warrant(objectType, objectId, relation, user)`
 
 This method creates a warrant which specifies that the provided `user` (or userset) has `relation` on the object of type `objectType` with id `objectId`.
 
@@ -49,7 +49,7 @@ This method creates a warrant which specifies that the provided `user` (or users
 Warrant::WarrantClient.create_warrant('store', store.id, 'view', { userId: user.id })
 ```
 
-### `createSession(userId)`
+### `create_session(userId)`
 
 This method creates a session in Warrant for the user with the specified `userId` and returns a session token which can be used to make authorized requests to the Warrant API only for the specified user. This session token can safely be used to make requests to the Warrant API's authorization endpoint to determine user access in web and mobile client applications.
 
@@ -58,7 +58,7 @@ This method creates a session in Warrant for the user with the specified `userId
 Warrant::WarrantClient.create_session(user.id)
 ```
 
-### `isAuthorized(objectType, objectId, relation, userId)`
+### `is_authorized(objectType, objectId, relation, userId)`
 
 This method returns `true` if the user with the specified `userId` has the specified `relation` to the object of type `objectType` with id `objectId` and `false` otherwise.
 
@@ -68,6 +68,34 @@ Warrant::WarrantClient.is_authorized('store', '824', 'view', '123') # true
 Warrant::WarrantClient.is_authorized('store', '824', 'edit', '123') # false
 ```
 
+### `list_warrants(filters = {})`
+This method returns all warrants that match the filters provided, or all warrants for your organization if none are provided. 
+
+#### **Filter Parameters** 
+---
+#### **objectType**
+Only return warrants with the given object type.
+
+#### **objectId**
+Only return warrants with the given object id.
+
+#### **relation**
+Only return warrants with the given relation.
+
+#### **userId**
+Only return warrants with the given user id
+
+
+```ruby
+# List all warrants for an organization
+Warrant::WarrantClient.list_warrants
+
+# List all warrants with object type of store
+Warrant::WarrantClient.list_warrants(object_type: 'store')
+```
+
+---
+
 We’ve used a random API key in these code examples. Replace it with your [actual publishable API keys](https://app.warrant.dev) to
 test this code through your own Warrant account.
 

data/lib/warrant/models/{userset_warrant.rb → warrant.rb}

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Warrant
-    class UsersetWarrant
+    class Warrant
         attr_reader :id, :object_type, :object_id, :relation, :user
 
         def initialize(id, object_type, object_id, relation, user)

data/lib/warrant/util.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Warrant
+    class Util
+        class << self
+            def camelcase(str)
+                str = str.split('_').collect(&:capitalize).join
+                str.sub(str[0], str[0].downcase)
+            end
+
+            def normalize_options(opts)
+                new_opts = opts.each_with_object({}) do |(k, v), new_opts|
+                    new_key = Util.camelcase(k.to_s)
+
+                    new_opts[new_key] = v
+                end
+            end
+        end
+    end
+end

data/lib/warrant/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Warrant
-  VERSION = "0.1.2"
+  VERSION = "0.1.3"
 end

data/lib/warrant/warrant_client.rb

@@ -4,7 +4,7 @@ module Warrant
     class WarrantClient
         class << self
             def create_tenant(tenant_id = '')
-                uri = URI.parse("#{Warrant.config.api_base}/v1/tenants")
+                uri = URI.parse("#{::Warrant.config.api_base}/v1/tenants")
                 params = {
                     tenantId: tenant_id
                 }
@@ -20,7 +20,7 @@ module Warrant
             end
 
             def create_user(email, user_id = '', tenant_id = '')
-                uri = URI.parse("#{Warrant.config.api_base}/v1/users")
+                uri = URI.parse("#{::Warrant.config.api_base}/v1/users")
                 params = {
                     tenantId: tenant_id,
                     userId: user_id,
@@ -38,7 +38,7 @@ module Warrant
             end
 
             def create_role(role_id)
-                uri = URI.parse("#{Warrant.config.api_base}/v1/roles")
+                uri = URI.parse("#{::Warrant.config.api_base}/v1/roles")
                 params = {
                     roleId: role_id
                 }
@@ -54,7 +54,7 @@ module Warrant
             end
 
             def delete_role(role_id)
-                uri = URI.parse("#{Warrant.config.api_base}/v1/roles/#{role_id}")
+                uri = URI.parse("#{::Warrant.config.api_base}/v1/roles/#{role_id}")
                 res = delete(uri)
 
                 case res
@@ -66,7 +66,7 @@ module Warrant
             end
 
             def create_permission(permission_id)
-                uri = URI.parse("#{Warrant.config.api_base}/v1/permissions")
+                uri = URI.parse("#{::Warrant.config.api_base}/v1/permissions")
                 params = {
                     permissionId: permission_id
                 }
@@ -82,7 +82,7 @@ module Warrant
             end
 
             def delete_permission(permission_id)
-                uri = URI.parse("#{Warrant.config.api_base}/v1/permissions/#{permission_id}")
+                uri = URI.parse("#{::Warrant.config.api_base}/v1/permissions/#{permission_id}")
                 res = delete(uri)
 
                 case res
@@ -94,7 +94,7 @@ module Warrant
             end
 
             def create_warrant(object_type, object_id, relation, user)
-                uri = URI.parse("#{Warrant.config.api_base}/v1/warrants")
+                uri = URI.parse("#{::Warrant.config.api_base}/v1/warrants")
                 params = {
                     objectType: object_type,
                     objectId: object_id,
@@ -106,11 +106,7 @@ module Warrant
 
                 case res
                 when Net::HTTPSuccess
-                    if res_json['user']['userId']
-                        UserWarrant.new(res_json['id'], res_json['objectType'], res_json['objectId'], res_json['relation'], res_json['user']['userId'])
-                    elsif res_json['user']['objectType']
-                        UsersetWarrant.new(res_json['id'], res_json['objectType'], res_json['objectId'], res_json['relation'], res_json['user'])
-                    end
+                    Warrant.new(res_json['id'], res_json['objectType'], res_json['objectId'], res_json['relation'], res_json['user'])
                 else
                     res_json
                 end
@@ -128,8 +124,31 @@ module Warrant
                 end
             end
 
+            def list_warrants(filters = {})
+                query_string = ""
+                unless filters.empty?
+                    new_filters = Util.normalize_options(filters.compact)
+
+                    query_string = URI.encode_www_form(new_filters) 
+                end
+
+                uri = URI.parse("#{::Warrant.config.api_base}/v1/warrants?#{query_string}")
+
+                res = get(uri)
+                res_json = JSON.parse(res.body)
+
+                case res
+                when Net::HTTPSuccess
+                    res_json.map do |warrant|
+                        Warrant.new(warrant['id'], warrant['objectType'], warrant['objectId'], warrant['relation'], warrant['user'])
+                    end
+                else
+                    res_json
+                end
+            end
+
             def assign_role_to_user(user_id, role_id)
-                uri = URI.parse("#{Warrant.config.api_base}/v1/users/#{user_id}/roles/#{role_id}")
+                uri = URI.parse("#{::Warrant.config.api_base}/v1/users/#{user_id}/roles/#{role_id}")
                 res = post(uri)
                 res_json = JSON.parse(res.body)
 
@@ -142,7 +161,7 @@ module Warrant
             end
 
             def remove_role_from_user(user_id, role_id)
-                uri = URI.parse("#{Warrant.config.api_base}/v1/users/#{user_id}/roles/#{role_id}")
+                uri = URI.parse("#{::Warrant.config.api_base}/v1/users/#{user_id}/roles/#{role_id}")
                 res = delete(uri)
 
                 case res
@@ -154,7 +173,7 @@ module Warrant
             end
 
             def assign_permission_to_user(user_id, permission_id)
-                uri = URI.parse("#{Warrant.config.api_base}/v1/users/#{user_id}/permissions/#{permission_id}")
+                uri = URI.parse("#{::Warrant.config.api_base}/v1/users/#{user_id}/permissions/#{permission_id}")
                 res = post(uri)
                 res_json = JSON.parse(res.body)
 
@@ -167,7 +186,7 @@ module Warrant
             end
 
             def remove_permission_from_user(user_id, permission_id)
-                uri = URI.parse("#{Warrant.config.api_base}/v1/users/#{user_id}/permissions/#{permission_id}")
+                uri = URI.parse("#{::Warrant.config.api_base}/v1/users/#{user_id}/permissions/#{permission_id}")
                 res = delete(uri)
 
                 case res
@@ -179,7 +198,7 @@ module Warrant
             end
 
             def create_session(user_id)
-                uri = URI.parse("#{Warrant.config.api_base}/v1/users/#{user_id}/sessions")
+                uri = URI.parse("#{::Warrant.config.api_base}/v1/users/#{user_id}/sessions")
                 res = post(uri)
                 res_json = JSON.parse(res.body)
 
@@ -192,7 +211,7 @@ module Warrant
             end
 
             def create_self_service_session(user_id, redirect_url)
-                uri = URI.parse("#{Warrant.config.api_base}/v1/sessions")
+                uri = URI.parse("#{::Warrant.config.api_base}/v1/sessions")
                 params = {
                     type: "ssdash",
                     userId: user_id,
@@ -210,7 +229,7 @@ module Warrant
             end
 
             def is_authorized(object_type, object_id, relation, user_id)
-                uri = URI.parse("#{Warrant.config.api_base}/v1/authorize")
+                uri = URI.parse("#{::Warrant.config.api_base}/v1/authorize")
                 params = {
                     objectType: object_type,
                     objectId: object_id,
@@ -239,7 +258,7 @@ module Warrant
                 http = Net::HTTP.new(uri.host, uri.port)
                 http.use_ssl = true
                 headers = {
-                    "Authorization": "ApiKey #{Warrant.config.api_key}"
+                    "Authorization": "ApiKey #{::Warrant.config.api_key}"
                 }
                 http.post(uri.path, params.to_json, headers)
             end
@@ -248,10 +267,19 @@ module Warrant
                 http = Net::HTTP.new(uri.host, uri.port)
                 http.use_ssl = true
                 headers = {
-                    "Authorization": "ApiKey #{Warrant.config.api_key}"
+                    "Authorization": "ApiKey #{::Warrant.config.api_key}"
                 }
                 http.delete(uri.path, headers)
             end
+
+            def get(uri, params = {})
+                http = Net::HTTP.new(uri.host, uri.port)
+                http.use_ssl = true
+                headers = {
+                    "Authorization": "ApiKey #{::Warrant.config.api_key}"
+                }
+                http.get(uri, headers)
+            end
         end
     end
 end

data/lib/warrant.rb

@@ -11,13 +11,13 @@ require "warrant/models/role"
 require "warrant/models/tenant"
 require "warrant/models/user"
 require "warrant/models/userset"
-require "warrant/models/user_warrant"
-require "warrant/models/userset_warrant"
+require "warrant/models/warrant"
+require "warrant/util"
 require "warrant/warrant_configuration"
 require "warrant/warrant_client"
 
 module Warrant
-    @config = Warrant::WarrantConfiguration.new
+    @config = ::Warrant::WarrantConfiguration.new
 
     class << self
         extend Forwardable

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: warrant
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Warrant
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-05-05 00:00:00.000000000 Z
+date: 2022-05-09 00:00:00.000000000 Z
 dependencies: []
 description: Ruby library for the Warrant API at https://warrant.dev.
 email: hello@warrant.dev
@@ -30,9 +30,9 @@ files:
 - lib/warrant/models/role.rb
 - lib/warrant/models/tenant.rb
 - lib/warrant/models/user.rb
-- lib/warrant/models/user_warrant.rb
 - lib/warrant/models/userset.rb
-- lib/warrant/models/userset_warrant.rb
+- lib/warrant/models/warrant.rb
+- lib/warrant/util.rb
 - lib/warrant/version.rb
 - lib/warrant/warrant_client.rb
 - lib/warrant/warrant_configuration.rb
@@ -44,7 +44,7 @@ metadata:
   source_code_uri: https://github.com/warrant-dev/warrant-ruby
   changelog_uri: https://github.com/warrant-dev/warrant-ruby/CHANGELOG.md
   documentation_uri: https://docs.warrant.dev/
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -59,8 +59,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.14
-signing_key: 
+rubygems_version: 3.3.11
+signing_key:
 specification_version: 4
 summary: Warrant Ruby Library
 test_files: []

data/lib/warrant/models/user_warrant.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-module Warrant
-    class UserWarrant
-        attr_reader :id, :object_type, :object_id, :relation, :user
-
-        def initialize(id, object_type, object_id, relation, user_id)
-            @id = id
-            @object_type = object_type
-            @object_id = object_id
-            @relation = relation
-            @user = User.new(user_id)
-        end
-    end
-end