aserto 0.30.0 → 0.30.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4471efcec975432356d584d3d480e0ab503e139787c8f96ab88032ab15356175
-  data.tar.gz: aa46126a15fb9f583fd8dc9a1b064889f95ccfa3814bc4c6c7588c0ed7f78175
+  metadata.gz: f6f6d7ede8c8254ea3a7660948f01f70ec2d59d1328676c6e479bfe4e79a2305
+  data.tar.gz: b2314cab25c484a0c7b48254869210f11c386084bdeb2cb0a37b2024dee8716f
 SHA512:
-  metadata.gz: 61af3804724a6138e21a5233c25712213860b4e2939331f1087e728c36a6cf5fefb31c6e23b77fc219df75d84abf2ecb1675892e60663e787cd6932884be3dec
-  data.tar.gz: f73188bf7eb0a4b58944022c715fdcb65718e3d8debe3215a6a82437781f544ff78cc1012a169ffd8deb2a762650da9d0970030a2e8eeaab461abe1dc4233d3b
+  metadata.gz: 65c36aee8d336be3016bf70ee95bd44d8ddc74d06fc1a7c0f9cc51ddff8f5a65b8282cc1160e2a6d0389be5eafaa7c2ce51fb61ce84bb9d0297cfdb6865bde2c
+  data.tar.gz: c27fba66e09a55b63060f93596080f89eb3cdb5ee38eed73ca101ae491528abc7688a2e82879c58d187729d6ee9c3c4108b1e09c35aa7450096e8ed8d5ac7a08

data/README.md

@@ -23,7 +23,7 @@ gem install aserto
 
 ## Directory
 
-The Directory APIs can be used to get or set object instances and relation instances. They can also be used to check whether a user has a permission or relation on an object instance.
+The Directory APIs can be used to get or set object instances and relation instances. They can also be used to check whether a user has permission or relation on an object instance.
 
 ### Directory Client
 
@@ -32,7 +32,7 @@ You can initialize a directory client as follows:
 ```ruby
 require 'aserto/directory/client'
 
-directory_client =Aserto::Directory::V3::Client.new(
+directory_client = Aserto::Directory::V3::Client.new(
   url: "directory.eng.aserto.com:8443",
   tenant_id: "aserto-tenant-id",
   api_key: "basic directory api key",
@@ -42,15 +42,15 @@ directory_client =Aserto::Directory::V3::Client.new(
 - `url`: hostname:port of directory service (_required_)
 - `api_key`: API key for directory service (_required_ if using hosted directory)
 - `tenant_id`: Aserto tenant ID (_required_ if using hosted directory)
-- `cert_path`: Path to the grpc service certificate when connecting to local topaz instance.
+- `cert_path`: Path to the grpc service certificate when connecting to the local topaz instance.
 
-See https://rubydoc.info/gems/aserto/docs/Aserto/Directory/V3/Client for full documentation
+See [Aserto::Directory::V3::Client](https://rubydoc.info/gems/aserto/Aserto/Directory/V3/Client) for full documentation
 
 ## Authorizer
 `Aserto::Authorization` is a middleware that allows Ruby applications to use Aserto as the Authorization provider.
 
 ### Prerequisites
-* [Ruby](https://www.ruby-lang.org/en/downloads/) 2.7 or newer.
+* [Ruby](https://www.ruby-lang.org/en/downloads/) 3.0 or newer.
 * An [Aserto](https://console.aserto.com) account.
 
 ### Configuration
@@ -120,7 +120,7 @@ end
 By default, when computing the policy path, the middleware:
 * converts all slashes to dots
 * converts any character that is not alpha, digit, dot or underscore to underscore
-* converts uppercase characters in the URL path to lowercases
+* converts uppercase characters in the URL path to lowercase
 
 This behaviour can be overwritten by providing a custom function:
 
@@ -136,7 +136,7 @@ end
 ```
 
 ### Resource
-A resource can be any structured data that the authorization policy uses to evaluate decisions. By default, middleware does not include a resource in authorization calls.
+A resource can be any structured data the authorization policy uses to evaluate decisions. By default, middleware does not include a resource in authorization calls.
 
 This behaviour can be overwritten by providing a custom function:
 
@@ -244,7 +244,7 @@ end
 Prerequisites:
 
     - go >= 1.17 to run mage
-    - Ruby >= 2.7.0 to run the code
+    - Ruby >= 3.0 to run the code
 
 
  Run `bundle install` to install dependencies. Then, run `bundle exec rspec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/VERSION

@@ -1 +1 @@
-0.30.0
+0.30.4

data/lib/aserto/auth_client.rb

@@ -33,7 +33,7 @@ module Aserto
       exec_is(request_is(config.decision))
     end
 
-    def check(object_id:, object_type:, relation:)
+    def check(object_id: "", object_type: "", relation: "")
       resource_context_fields = {
         object_id: object_id,
         object_type: object_type,

data/lib/aserto/config.rb

@@ -40,7 +40,7 @@ module Aserto
       policy_root: "",
       cert_path: "",
       on_unauthorized: lambda do |_env|
-        return [403, {}, ["Forbidden"]]
+        [403, {}, ["Forbidden"]]
       end
     }.freeze
 

data/lib/aserto/directory/client.rb

@@ -1,14 +1,10 @@
 # frozen_string_literal: true
 
-require "aserto/directory"
-require_relative "interceptors/headers"
-require_relative "requests"
+require_relative "v2/client"
 
 module Aserto
   module Directory
     class Client
-      include Requests
-
       # Creates a new Directory Client
       #
       # @param url [String] the gRpc url of the directory server
@@ -17,127 +13,28 @@ module Aserto
       # @param cert_path [String] the path to the certificates folder
       #
       # @return [Aserto::Directory::Client] the new Directory Client
-      def initialize(url: "directory.prod.aserto.com:8443", api_key: nil, tenant_id: nil, cert_path: nil)
-        @reader_client = ::Aserto::Directory::Reader::V2::Reader::Stub.new(
-          url,
-          load_creds(cert_path),
-          interceptors: [Interceptors::Headers.new(api_key, tenant_id)]
-        )
-        @writer_client = ::Aserto::Directory::Writer::V2::Writer::Stub.new(
-          url,
-          load_creds(cert_path),
-          interceptors: [Interceptors::Headers.new(api_key, tenant_id)]
-        )
-      end
-
-      # Check permissions
-      #
-      # @param subject [::Aserto::Directory::Common::V2::ObjectIdentifier]
-      # @param permission [String] permission name to be checked
-      # @param object [::Aserto::Directory::Common::V2::ObjectIdentifier]
-      # @param trace [Boolean] whether to enable tracing
-      #
-      # @return [Boolean]
-      def check_permission(subject:, permission:, object:, trace: false)
-        reader_client.check_permission(check_permission_request(subject, permission, object, trace))
-      end
-
-      # Check relation
-      #
-      # @param subject [::Aserto::Directory::Common::V2::ObjectIdentifier]
-      # @param relation [::Aserto::Directory::Common::V2::RelationTypeIdentifier] relation name to be checked
-      # @param object [::Aserto::Directory::Common::V2::ObjectIdentifier]
-      # @param trace [Boolean] whether to enable tracing
-      #
-      # @return [Boolean]
-      def check_relation(subject:, relation:, object:, trace: false)
-        reader_client.check_relation(check_relation_request(subject, relation, object, trace))
-      end
-
-      # Get an object by type and key
-      #
-      # @param type [String] the type of object
-      # @param key [String] the key of the object
-      #
-      # @return [::Aserto::Directory::Common::V2::Object]
-      def object(type:, key:)
-        reader_client.get_object(object_request(key, type)).result
-      end
-
-      # Set an object
-      #
-      # @param object [::Aserto::Directory::Common::V2::Object]
-      #
-      # @return [::Aserto::Directory::Common::V2::Object] the created/updated object
-      def set_object(object:)
-        writer_client.set_object(new_object_request(object)).result
-      end
-
-      # Get a list of objects by type
-      #
-      # @param type [String] the type of objects
-      # @param page [::Aserto::Directory::Common::V2::PaginationRequest]
-      #
-      # @return [Array<::Aserto::Directory::Common::V2::Object>]
-      def objects(type:, page: nil)
-        reader_client.get_objects(objects_request(type, page)).results
-      end
 
-      # Get a relation
-      #
-      # @param subject [::Aserto::Directory::Common::V2::ObjectIdentifier]
-      # @param relation [::Aserto::Directory::Common::V2::RelationTypeIdentifier]
-      # @param object [::Aserto::Directory::Common::V2::ObjectIdentifier]
-      #
-      # @return [::Aserto::Directory::Common::V2::Relation]
-      def relation(subject: nil, relation: nil, object: nil)
-        reader_client.get_relation(relation_request(subject, relation, object)).results
-      end
+      def initialize(url: "directory.prod.aserto.com:8443", api_key: nil, tenant_id: nil, cert_path: nil)
+        warn WARN_MESSAGE
 
-      # Get a list of relations
-      #
-      # @param subject [::Aserto::Directory::Common::V2::ObjectIdentifier]
-      # @param relation [::Aserto::Directory::Common::V2::RelationTypeIdentifier]
-      # @param object [::Aserto::Directory::Common::V2::ObjectIdentifier]
-      #
-      # @return [Array<::Aserto::Directory::Common::V2::Relation>]
-      def relations(subject: nil, relation: nil, object: nil, page: nil)
-        reader_client.get_relations(relations_request(subject, relation, object, page)).results
+        @v2_client = Aserto::Directory::V2::Client.new(
+          url: url, api_key: api_key, tenant_id: tenant_id, cert_path: cert_path
+        )
       end
 
-      # Set a relation
-      # @param subject [::Aserto::Directory::Common::V2::ObjectIdentifier]
-      # @param relation [String] name of the relation
-      # @param object [::Aserto::Directory::Common::V2::ObjectIdentifier]
-      # @param hash [String] hash of the relation(required for updating a relation)
-      #
-      # @return [::Aserto::Directory::Common::V2::Relation] the created/updated relation
-      def set_relation(subject:, relation:, object:, hash: nil)
-        writer_client.set_relation(new_relation_request(subject, relation, object, hash)).result
+      def method_missing(method, args)
+        @v2_client.send(method, **args)
       end
 
-      # Delete a relation
-      #
-      # @param subject [::Aserto::Directory::Common::V2::ObjectIdentifier]
-      # @param relation [::Aserto::Directory::Common::V2::RelationTypeIdentifier]
-      # @param object [::Aserto::Directory::Common::V2::ObjectIdentifier]
-      #
-      # @return nil
-      def delete_relation(subject:, relation:, object:)
-        writer_client.delete_relation(delete_relation_request(subject, relation, object))
+      def respond_to_missing?(_name, _include_private)
+        true
       end
 
-      private
-
-      attr_reader :reader_client, :writer_client
-
-      def load_creds(cert_path)
-        if cert_path && File.file?(cert_path)
-          GRPC::Core::ChannelCredentials.new(File.read(cert_path))
-        else
-          GRPC::Core::ChannelCredentials.new
-        end
-      end
+      WARN_MESSAGE = <<~TEXT
+        Aserto::Directory::Client is deprecated and will be removed.
+        Use Aserto::Directory::V3::Client for the latest Directory Client.
+        If you need Directory V2, use Aserto::Directory::V2::Client
+      TEXT
     end
   end
 end

data/lib/aserto/directory/errors.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+class ConfigError < StandardError
+end

data/lib/aserto/directory/v2/client.rb

@@ -0,0 +1,145 @@
+# frozen_string_literal: true
+
+require "aserto/directory"
+require_relative "../interceptors/headers"
+require_relative "requests"
+
+module Aserto
+  module Directory
+    module V2
+      class Client
+        include Requests
+
+        # Creates a new Directory V2 Client
+        #
+        # @param url [String] the gRpc url of the directory server
+        # @param api_key [String] the api key of the directory server(for hosted directory)
+        # @param tenant_id [String] the tenant id of the directory server(for hosted directory)
+        # @param cert_path [String] the path to the certificates folder
+        #
+        # @return [Aserto::Directory::V2::Client] the new Directory Client
+        def initialize(url: "directory.prod.aserto.com:8443", api_key: nil, tenant_id: nil, cert_path: nil)
+          @reader_client = ::Aserto::Directory::Reader::V2::Reader::Stub.new(
+            url,
+            load_creds(cert_path),
+            interceptors: [Interceptors::Headers.new(api_key, tenant_id)]
+          )
+          @writer_client = ::Aserto::Directory::Writer::V2::Writer::Stub.new(
+            url,
+            load_creds(cert_path),
+            interceptors: [Interceptors::Headers.new(api_key, tenant_id)]
+          )
+        end
+
+        # Check permissions
+        #
+        # @param subject [::Aserto::Directory::Common::V2::ObjectIdentifier]
+        # @param permission [String] permission name to be checked
+        # @param object [::Aserto::Directory::Common::V2::ObjectIdentifier]
+        # @param trace [Boolean] whether to enable tracing
+        #
+        # @return [Boolean]
+        def check_permission(subject:, permission:, object:, trace: false)
+          reader_client.check_permission(check_permission_request(subject, permission, object, trace))
+        end
+
+        # Check relation
+        #
+        # @param subject [::Aserto::Directory::Common::V2::ObjectIdentifier]
+        # @param relation [::Aserto::Directory::Common::V2::RelationTypeIdentifier] relation name to be checked
+        # @param object [::Aserto::Directory::Common::V2::ObjectIdentifier]
+        # @param trace [Boolean] whether to enable tracing
+        #
+        # @return [Boolean]
+        def check_relation(subject:, relation:, object:, trace: false)
+          reader_client.check_relation(check_relation_request(subject, relation, object, trace))
+        end
+
+        # Get an object by type and key
+        #
+        # @param type [String] the type of object
+        # @param key [String] the key of the object
+        #
+        # @return [::Aserto::Directory::Common::V2::Object]
+        def object(type:, key:)
+          reader_client.get_object(object_request(key, type)).result
+        end
+
+        # Set an object
+        #
+        # @param object [::Aserto::Directory::Common::V2::Object]
+        #
+        # @return [::Aserto::Directory::Common::V2::Object] the created/updated object
+        def set_object(object:)
+          writer_client.set_object(new_object_request(object)).result
+        end
+
+        # Get a list of objects by type
+        #
+        # @param type [String] the type of objects
+        # @param page [::Aserto::Directory::Common::V2::PaginationRequest]
+        #
+        # @return [Array<::Aserto::Directory::Common::V2::Object>]
+        def objects(type:, page: nil)
+          reader_client.get_objects(objects_request(type, page)).results
+        end
+
+        # Get a relation
+        #
+        # @param subject [::Aserto::Directory::Common::V2::ObjectIdentifier]
+        # @param relation [::Aserto::Directory::Common::V2::RelationTypeIdentifier]
+        # @param object [::Aserto::Directory::Common::V2::ObjectIdentifier]
+        #
+        # @return [::Aserto::Directory::Common::V2::Relation]
+        def relation(subject: nil, relation: nil, object: nil)
+          reader_client.get_relation(relation_request(subject, relation, object)).results
+        end
+
+        # Get a list of relations
+        #
+        # @param subject [::Aserto::Directory::Common::V2::ObjectIdentifier]
+        # @param relation [::Aserto::Directory::Common::V2::RelationTypeIdentifier]
+        # @param object [::Aserto::Directory::Common::V2::ObjectIdentifier]
+        #
+        # @return [Array<::Aserto::Directory::Common::V2::Relation>]
+        def relations(subject: nil, relation: nil, object: nil, page: nil)
+          reader_client.get_relations(relations_request(subject, relation, object, page)).results
+        end
+
+        # Set a relation
+        # @param subject [::Aserto::Directory::Common::V2::ObjectIdentifier]
+        # @param relation [String] name of the relation
+        # @param object [::Aserto::Directory::Common::V2::ObjectIdentifier]
+        # @param hash [String] hash of the relation(required for updating a relation)
+        #
+        # @return [::Aserto::Directory::Common::V2::Relation] the created/updated relation
+        def set_relation(subject:, relation:, object:, hash: nil)
+          writer_client.set_relation(new_relation_request(subject, relation, object, hash)).result
+        end
+
+        # Delete a relation
+        #
+        # @param subject [::Aserto::Directory::Common::V2::ObjectIdentifier]
+        # @param relation [::Aserto::Directory::Common::V2::RelationTypeIdentifier]
+        # @param object [::Aserto::Directory::Common::V2::ObjectIdentifier]
+        #
+        # @return nil
+        def delete_relation(subject:, relation:, object:)
+          writer_client.delete_relation(delete_relation_request(subject, relation, object))
+        end
+
+        private
+
+        attr_reader :reader_client, :writer_client
+
+        def load_creds(cert_path)
+          if cert_path && File.file?(cert_path)
+            GRPC::Core::ChannelCredentials.new(File.read(cert_path))
+          else
+            GRPC::Core::ChannelCredentials.new
+          end
+        end
+      end
+    end
+  end
+end

data/lib/aserto/directory/v3/client.rb

@@ -8,6 +8,7 @@ require_relative "writer"
 require_relative "model"
 require_relative "importer"
 require_relative "exporter"
+require_relative "../errors"
 
 module Aserto
   module Directory
@@ -77,7 +78,7 @@ module Aserto
           end
 
           def method_missing(method, *_args)
-            puts "Cannot call '#{method}': '#{@name.to_s.capitalize}' client is not initialized."
+            raise ConfigError, "Cannot call '#{method}': '#{@name.to_s.capitalize}' client is not initialized."
           end
 
           def respond_to_missing?(_name, _include_private)

data/lib/aserto/directory/v3/config.rb

@@ -10,7 +10,7 @@ module Aserto
 
         def initialize(config)
           @base = {
-            url: config[:url] || "directory.prod.aserto.com:8443",
+            url: config[:url],
             api_key: config[:api_key],
             tenant_id: config[:tenant_id],
             cert_path: config[:cert_path]
@@ -28,6 +28,8 @@ module Aserto
         class BaseConfig
           attr_reader :url, :credentials, :interceptors
 
+          DEFAULT_DIRECTORY_URL = "directory.prod.aserto.com:8443"
+
           def initialize(url, credentials, interceptors)
             @url = url
             @credentials = credentials
@@ -35,16 +37,21 @@ module Aserto
           end
         end
 
-        def build(
-          url: @base[:url],
-          api_key: @base[:api_key],
-          tenant_id: @base[:tenant_id],
-          cert_path: @base[:cert_path]
-        )
+        def build(url: nil, api_key: @base[:api_key], tenant_id: @base[:tenant_id], cert_path: @base[:cert_path])
+          return unless valid_config?(@base, { url: url, api_key: api_key, tenant_id: tenant_id })
 
-          interceptors = []
           interceptors = [Interceptors::Headers.new(api_key, tenant_id)] if !api_key.nil? && !tenant_id.nil?
-          BaseConfig.new(url, load_creds(cert_path), interceptors)
+          BaseConfig.new(
+            url || @base[:url] || BaseConfig::DEFAULT_DIRECTORY_URL,
+            load_creds(cert_path),
+            interceptors || []
+          )
+        end
+
+        def valid_config?(config, fallback)
+          !(config[:url].nil? && fallback[:url].nil?) ||
+            ((!config[:api_key].nil? || !fallback[:api_key].nil?) &&
+            (!config[:tenant_id].nil? || !fallback[:tenant_id].nil?))
         end
 
         def load_creds(cert_path)

data/lib/aserto/directory/v3/importer.rb

@@ -9,15 +9,21 @@ module Aserto
         #
         # @param Array[Hash] data to be imported
         #
+        # op_code = {
+        #   OPCODE_UNKNOWN                                              = ;
+        #   OPCODE_SET                                                  = 1;
+        #   OPCODE_DELETE                                               = 2;
+        # }
         # @example
         #   directory.import(
         #     [
-        #       { object: { id: "import-user", type: "user" } },
-        #       { object: { id: "import-group", type: "group" } },
+        #       { op_code: 1, object: { type: "user", id: "import-user" } },
+        #       { op_code: 1, object: { type: "group", id: "import-group" } },
         #       {
+        #         op_code: 1,
         #         relation: {
-        #           object_id: "import-user",
         #           object_type: "user",
+        #           object_id: "import-user",
         #           relation: "member",
         #           subject_id: "import-group",
         #           subject_type: "group"

data/lib/aserto/directory/v3/reader.rb

@@ -7,8 +7,8 @@ module Aserto
         #
         # find an object by id and type
         #
-        # @param object_id [String]
         # @param object_type [String]
+        # @param object_id [String]
         #
         # @return [Aserto::Directory::Reader::V3::GetObjectResponse]
         #
@@ -17,11 +17,11 @@ module Aserto
         #     object_type: "user",
         #     object_id: "rick@the-citadel.com"
         #   )
-        def get_object(object_id:, object_type:)
+        def get_object(object_type:, object_id:)
           reader.get_object(
             Aserto::Directory::Reader::V3::GetObjectRequest.new(
-              object_id: object_id,
-              object_type: object_type
+              object_type: object_type,
+              object_id: object_id
             )
           )
         end
@@ -227,13 +227,13 @@ module Aserto
         #
         # Returns object graph from anchor to subject or object.
         #
-        # @param [String] anchor_type <description>
-        # @param [String] anchor_id <description>
-        # @param [String] object_type <description>
-        # @param [String] object_id <description>
-        # @param [String] relation <description>
-        # @param [String] subject_type <description>
-        # @param [String] <description>
+        # @param [String] anchor_type
+        # @param [String] anchor_id
+        # @param [String] object_type
+        # @param [String] object_id
+        # @param [String] relation
+        # @param [String] subject_type
+        # @param [String]
         #
         # @return [Aserto::Directory::Reader::V3::GetGraphResponse]
         #

data/lib/aserto/directory/v3/writer.rb

@@ -9,8 +9,8 @@ module Aserto
         #
         # Create a new object
         #
-        # @param [String] object_id
         # @param [String] object_type
+        # @param [String] object_id
         # @param [String] display_name
         # @param [Hash] properties
         # @param [String] etag
@@ -18,13 +18,13 @@ module Aserto
         # @return [Aserto::Directory::Writer::V3::SetObjectResponse]
         #
         # @example
-        #   client.set_object(object_id: "1234", object_type: "user", properties: { email: "test" })
-        def set_object(object_id:, object_type:, display_name: "", properties: {}, etag: nil)
+        #   client.set_object(object_type: "user", object_id: "1234", properties: { email: "test" })
+        def set_object(object_type:, object_id:, display_name: "", properties: {}, etag: nil)
           writer.set_object(
             Aserto::Directory::Writer::V3::SetObjectRequest.new(
               object: {
-                id: object_id,
                 type: object_type,
+                id: object_id,
                 display_name: display_name,
                 properties: Google::Protobuf::Struct.from_hash(properties.transform_keys!(&:to_s)),
                 etag: etag
@@ -36,19 +36,19 @@ module Aserto
         #
         # Delete an object
         #
-        # @param [String] object_id
         # @param [String] object_type
+        # @param [String] object_id
         # @param [Boolean] with_relations
         #
         # @return [ Aserto::Directory::Writer::V3::DeleteObjectResponse]
         #
         # @example
-        #   client.delete_object(object_id: "1234", object_type: "user")
-        def delete_object(object_id:, object_type:, with_relations: false)
+        #   client.delete_object(object_type: "user", object_id: "1234")
+        def delete_object(object_type:, object_id:, with_relations: false)
           writer.delete_object(
             Aserto::Directory::Writer::V3::DeleteObjectRequest.new(
-              object_id: object_id,
               object_type: object_type,
+              object_id: object_id,
               with_relations: with_relations
             )
           )

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aserto
 version: !ruby/object:Gem::Version
-  version: 0.30.0
+  version: 0.30.4
 platform: ruby
 authors:
 - Aserto
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-11-27 00:00:00.000000000 Z
+date: 2023-12-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aserto-authorizer
@@ -81,8 +81,10 @@ files:
 - lib/aserto/authorization.rb
 - lib/aserto/config.rb
 - lib/aserto/directory/client.rb
+- lib/aserto/directory/errors.rb
 - lib/aserto/directory/interceptors/headers.rb
-- lib/aserto/directory/requests.rb
+- lib/aserto/directory/v2/client.rb
+- lib/aserto/directory/v2/requests.rb
 - lib/aserto/directory/v3/client.rb
 - lib/aserto/directory/v3/config.rb
 - lib/aserto/directory/v3/exporter.rb