fusionauth_client 1.34.0 → 1.38.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 835c190bdd098d984b2b2d12b509bac233d06fe3ddd9ea164547f6e36dcbb252
-  data.tar.gz: 6daa2a35b29cbc83750aeaf1403389d9739d5719fcc92443c7483408ad7db1c2
+  metadata.gz: 4bf2c4810a2d7c274cda24502f66fdca37b188a74e8799417cc549d9c06e23a0
+  data.tar.gz: b5aa5629f7120d7d4983de81bfddfc4127c0194a2061f1ed11366ab4820bf73d
 SHA512:
-  metadata.gz: e957b952ab5de83f1b2cfda1847cb5cef605b38a1696825e97f80c45fb51c218d2d27e46264edbeed0b491ddb916a6364d953170ec823930c5e9eee465cfc12d
-  data.tar.gz: f828049d36341da401b4cbff6b2170b649c2845e899477ea327b5c2e19be86cf76c9e7ec95c6f73a3dacb7b2401dee5b5104ec596849e153d8fc969eb1e0c7fd
+  metadata.gz: 36e2fb473ac870bd0f8b99a7c513c24bf60459d44e0b6dfc2eec1cad7cbb2ac3118e18df5b1df86ff2ffb151e4a55535e67e9c04a9ff5f587385ac145e2bffa9
+  data.tar.gz: a6ba3e7aca263497406c858e66faedc98405334015bf0b8a9f5a36fb807564afe996fceeb3ad4381648345f5d09e81ad881b1c8730dd828e2ffef388c13d919d

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    fusionauth_client (1.34.0)
+    fusionauth_client (1.38.0)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -20,50 +20,15 @@ Or install it yourself as:
 
 ## Usage
 
-Once the gem is installed, you can call FusionAuth APIs like this:
+Once the gem is installed, you can call FusionAuth APIs.
 
-```ruby
-require 'fusionauth/fusionauth_client'
-
-# Construct the FusionAuth Client
-client = FusionAuth::FusionAuthClient.new(
-    '<YOUR_API_KEY>', 
-    'http://localhost:9011'
-)
-
-# Create a user + registration
-id = SecureRandom.uuid
-client.register(id, {
-    :user => {
-        :firstName => 'Ruby',
-        :lastName => 'Client',
-        :email => 'ruby.client.test@fusionauth.io',
-        :password => 'password'
-    },
-    :registration => {
-        :applicationId => application_id,
-        :data => {
-            :foo => 'bar'
-        },
-        :preferredLanguages => %w(en fr),
-        :roles => %w(user)
-    }
-})
-
-# Authenticate the user
-response = client.login({
-    :loginId => 'ruby.client.test@fusionauth.io',
-    :password => 'password',
-    :applicationId => application_id
-})
-user = response.success.response.user
-```
+See examples in the `examples` directory.
 
 ## Questions and support
 
 If you have a question or support issue regarding this client library, we'd love to hear from you.
 
-If you have a paid edition with support included, please [open a ticket in your account portal](https://account.fusionauth.io/account/support/). Learn more about [paid editions here](https://fusionauth.io/pricing/).
+If you have a paid edition with support included, please [open a ticket in your account portal](https://account.fusionauth.io/account/support/). Learn more about [paid editions here](https://fusionauth.io/pricing).
 
 Otherwise, please [post your question in the community forum](https://fusionauth.io/community/forum/).
 

data/build.savant

@@ -16,7 +16,7 @@
 savantVersion = "1.0.0"
 
 pubVersion = ""
-project(group: "io.fusionauth", name: "fusionauth-ruby-client", version: "1.34.0", licenses: ["ApacheV2_0"]) {
+project(group: "io.fusionauth", name: "fusionauth-ruby-client", version: "1.38.0", licenses: ["ApacheV2_0"]) {
   workflow {
     fetch {
       cache()

data/examples/create_user.rb

@@ -0,0 +1,35 @@
+require 'fusionauth/fusionauth_client'
+require 'securerandom'
+
+# Construct the FusionAuth Client
+client = FusionAuth::FusionAuthClient.new(
+    'APIKEY', 
+    'http://localhost:9011'
+)
+
+application_id = '20ce6dac-b985-4c77-bb59-6369249f884b'
+
+# Create a user + registration
+id = SecureRandom.uuid
+response = client.register(id, {
+    :user => {
+        :firstName => 'Ruby',
+        :lastName => 'Client',
+        :email => 'ruby.client.test@fusionauth.io',
+        :password => 'password'
+    },
+    :registration => {
+        :applicationId => application_id,
+        :data => {
+            :foo => 'bar'
+        },
+        :preferredLanguages => %w(en fr),
+        :roles => %w(user)
+    }
+})
+
+unless response.success_response
+  print response.error_response
+  exit
+end
+

data/examples/login.rb

@@ -0,0 +1,24 @@
+require 'fusionauth/fusionauth_client'
+require 'securerandom'
+
+# Construct the FusionAuth Client
+client = FusionAuth::FusionAuthClient.new(
+    'APIKEY', 
+    'http://localhost:9011'
+)
+
+application_id = '20ce6dac-b985-4c77-bb59-6369249f884b'
+
+# Authenticate a user
+response = client.login({
+    :loginId => 'ruby.client.test@fusionauth.io',
+    :password => 'password',
+    :applicationId => application_id
+})
+
+if response.success_response
+  user = response.success_response.user
+  print user.id
+else 
+  print response.error_response
+end

data/fusionauth-ruby-client.iml

@@ -9,22 +9,23 @@
     <orderEntry type="jdk" jdkName="rbenv: 2.5.9" jdkType="RUBY_SDK" />
     <orderEntry type="sourceFolder" forTests="false" />
     <orderEntry type="library" scope="PROVIDED" name="bundler (v2.2.5, rbenv: 2.5.9) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="minitest (v5.8.3, rbenv: 2.5.9) [gem]" level="application" />
     <orderEntry type="library" scope="PROVIDED" name="rake (v12.3.3, rbenv: 2.5.9) [gem]" level="application" />
   </component>
   <component name="RakeTasksCache">
     <option name="myRootTask">
       <RakeTaskImpl id="rake">
         <subtasks>
-          <RakeTaskImpl description="Build fusionauth_client-1.28.1.gem into the pkg directory" fullCommand="build" id="build" />
+          <RakeTaskImpl description="Build fusionauth_client-1.37.0.gem into the pkg directory" fullCommand="build" id="build" />
           <RakeTaskImpl description="Remove any temporary products" fullCommand="clean" id="clean" />
           <RakeTaskImpl description="Remove any generated files" fullCommand="clobber" id="clobber" />
-          <RakeTaskImpl description="Build and install fusionauth_client-1.28.1.gem into system gems" fullCommand="install" id="install" />
+          <RakeTaskImpl description="Build and install fusionauth_client-1.37.0.gem into system gems" fullCommand="install" id="install" />
           <RakeTaskImpl id="install">
             <subtasks>
-              <RakeTaskImpl description="Build and install fusionauth_client-1.28.1.gem into system gems without network access" fullCommand="install:local" id="local" />
+              <RakeTaskImpl description="Build and install fusionauth_client-1.37.0.gem into system gems without network access" fullCommand="install:local" id="local" />
             </subtasks>
           </RakeTaskImpl>
-          <RakeTaskImpl description="Create tag v1.28.1 and build and push fusionauth_client-1.28.1.gem to https://rubygems.org" fullCommand="release[remote]" id="release[remote]" />
+          <RakeTaskImpl description="Create tag v1.37.0 and build and push fusionauth_client-1.37.0.gem to https://rubygems.org" fullCommand="release[remote]" id="release[remote]" />
           <RakeTaskImpl description="Run tests" fullCommand="test" id="test" />
           <RakeTaskImpl description="" fullCommand="default" id="default" />
           <RakeTaskImpl description="" fullCommand="release" id="release" />

data/fusionauth_client.gemspec

@@ -4,7 +4,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |spec|
   spec.name          = 'fusionauth_client'
-  spec.version       = '1.34.0'
+  spec.version       = '1.38.0'
   spec.authors       = ['Brian Pontarelli', 'Daniel DeGroff']
   spec.email         = %w(brian@fusionauth.io daniel@fusionauth.io)
 

data/lib/fusionauth/fusionauth_client.rb

@@ -2,7 +2,7 @@ require 'ostruct'
 require 'fusionauth/rest_client'
 
 #
-# Copyright (c) 2018-2019, FusionAuth, All Rights Reserved
+# Copyright (c) 2018-2022, FusionAuth, All Rights Reserved
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -130,9 +130,9 @@ module FusionAuth
     #
     # Check to see if the user must obtain a Trust Token Id in order to complete a change password request.
     # When a user has enabled Two-Factor authentication, before you are allowed to use the Change Password API to change
-    # your password, you must obtain a Truest Token by completing a Two-Factor Step-Up authentication.
+    # your password, you must obtain a Trust Token by completing a Two-Factor Step-Up authentication.
     # 
-    # An HTTP status code of 412 indicates that a Trust Token is required to make a POST request to this API.
+    # An HTTP status code of 400 with a general error code of [TrustTokenRequired] indicates that a Trust Token is required to make a POST request to this API.
     #
     # @param change_password_id [string] The change password Id used to find the user. This value is generated by FusionAuth once the change password workflow has been initiated.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
@@ -146,9 +146,9 @@ module FusionAuth
     #
     # Check to see if the user must obtain a Trust Token Id in order to complete a change password request.
     # When a user has enabled Two-Factor authentication, before you are allowed to use the Change Password API to change
-    # your password, you must obtain a Truest Token by completing a Two-Factor Step-Up authentication.
+    # your password, you must obtain a Trust Token by completing a Two-Factor Step-Up authentication.
     # 
-    # An HTTP status code of 412 indicates that a Trust Token is required to make a POST request to this API.
+    # An HTTP status code of 400 with a general error code of [TrustTokenRequired] indicates that a Trust Token is required to make a POST request to this API.
     #
     # @param encoded_jwt [string] The encoded JWT (access token).
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
@@ -162,9 +162,9 @@ module FusionAuth
     #
     # Check to see if the user must obtain a Trust Request Id in order to complete a change password request.
     # When a user has enabled Two-Factor authentication, before you are allowed to use the Change Password API to change
-    # your password, you must obtain a Truest Request Id by completing a Two-Factor Step-Up authentication.
+    # your password, you must obtain a Trust Request Id by completing a Two-Factor Step-Up authentication.
     # 
-    # An HTTP status code of 412 indicates that a Trust Token is required to make a POST request to this API.
+    # An HTTP status code of 400 with a general error code of [TrustTokenRequired] indicates that a Trust Token is required to make a POST request to this API.
     #
     # @param login_id [string] The loginId of the User that you intend to change the password for.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
@@ -1511,6 +1511,21 @@ module FusionAuth
           .go()
     end
 
+    #
+    # Sends a ping to FusionAuth indicating that the user was automatically logged into an application. When using
+    # FusionAuth's SSO or your own, you should call this if the user is already logged in centrally, but accesses an
+    # application where they no longer have a session. This helps correctly track login counts, times and helps with
+    # reporting.
+    #
+    # @param request [OpenStruct, Hash] The login request that contains the user credentials used to log them in.
+    # @return [FusionAuth::ClientResponse] The ClientResponse object.
+    def login_ping_with_request(request)
+      start.uri('/api/login')
+          .body_handler(FusionAuth::JSONBodyHandler.new(request))
+          .put()
+          .go()
+    end
+
     #
     # The Logout API is intended to be used to remove the refresh token and access token cookies if they exist on the
     # client and revoke the refresh token stored. This API does nothing if the request does not contain an access
@@ -2076,7 +2091,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the actions for the user with the given Id. This will return all time based actions that are active,
+    # Retrieves all the actions for the user with the given Id. This will return all time based actions that are active,
     # and inactive as well as non-time based actions.
     #
     # @param user_id [string] The Id of the user to fetch the actions for.
@@ -2089,7 +2104,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the actions for the user with the given Id that are currently preventing the User from logging in.
+    # Retrieves all the actions for the user with the given Id that are currently preventing the User from logging in.
     #
     # @param user_id [string] The Id of the user to fetch the actions for.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
@@ -2102,7 +2117,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the actions for the user with the given Id that are currently active.
+    # Retrieves all the actions for the user with the given Id that are currently active.
     # An active action means one that is time based and has not been canceled, and has not ended.
     #
     # @param user_id [string] The Id of the user to fetch the actions for.
@@ -2128,7 +2143,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the applications.
+    # Retrieves all the applications.
     #
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def retrieve_applications()
@@ -2162,7 +2177,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the connectors.
+    # Retrieves all the connectors.
     #
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def retrieve_connectors()
@@ -2184,7 +2199,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the consent.
+    # Retrieves all the consent.
     #
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def retrieve_consents()
@@ -2237,7 +2252,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the email templates.
+    # Retrieves all the email templates.
     #
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def retrieve_email_templates()
@@ -2288,7 +2303,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the Entity Types.
+    # Retrieves all the Entity Types.
     #
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def retrieve_entity_types()
@@ -2310,7 +2325,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the families that a user belongs to.
+    # Retrieves all the families that a user belongs to.
     #
     # @param user_id [string] The User's id
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
@@ -2322,7 +2337,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the members of a family by the unique Family Id.
+    # Retrieves all the members of a family by the unique Family Id.
     #
     # @param family_id [string] The unique Id of the Family.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
@@ -2358,7 +2373,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the forms fields
+    # Retrieves all the forms fields
     #
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def retrieve_form_fields()
@@ -2368,7 +2383,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the forms.
+    # Retrieves all the forms.
     #
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def retrieve_forms()
@@ -2390,7 +2405,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the groups.
+    # Retrieves all the groups.
     #
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def retrieve_groups()
@@ -2438,7 +2453,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the identity providers.
+    # Retrieves all the identity providers.
     #
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def retrieve_identity_providers()
@@ -2448,7 +2463,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the actions for the user with the given Id that are currently inactive.
+    # Retrieves all the actions for the user with the given Id that are currently inactive.
     # An inactive action means one that is time based and has been canceled or has expired, or is not time based.
     #
     # @param user_id [string] The Id of the user to fetch the actions for.
@@ -2462,7 +2477,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the applications that are currently inactive.
+    # Retrieves all the applications that are currently inactive.
     #
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def retrieve_inactive_applications()
@@ -2473,7 +2488,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the user actions that are currently inactive.
+    # Retrieves all the user actions that are currently inactive.
     #
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def retrieve_inactive_user_actions()
@@ -2550,7 +2565,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the keys.
+    # Retrieves all the keys.
     #
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def retrieve_keys()
@@ -2572,7 +2587,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the lambdas.
+    # Retrieves all the lambdas.
     #
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def retrieve_lambdas()
@@ -2582,7 +2597,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the lambdas for the provided type.
+    # Retrieves all the lambdas for the provided type.
     #
     # @param type [OpenStruct, Hash] The type of the lambda to return.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
@@ -2635,7 +2650,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the message templates.
+    # Retrieves all the message templates.
     #
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def retrieve_message_templates()
@@ -2657,7 +2672,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the messengers.
+    # Retrieves all the messengers.
     #
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def retrieve_messengers()
@@ -2734,7 +2749,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the children for the given parent email address.
+    # Retrieves all the children for the given parent email address.
     #
     # @param parent_email [string] The email of the parent.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
@@ -2780,13 +2795,13 @@ module FusionAuth
     end
 
     #
-    # Retrieves a single refresh token by unique Id. This is not the same thing as the string value of the refresh token, if you have that, you already have what you need..
+    # Retrieves a single refresh token by unique Id. This is not the same thing as the string value of the refresh token. If you have that, you already have what you need.
     #
-    # @param user_id [string] The Id of the user.
+    # @param token_id [string] The Id of the token.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
-    def retrieve_refresh_token_by_id(user_id)
+    def retrieve_refresh_token_by_id(token_id)
       start.uri('/api/jwt/refresh')
-          .url_segment(user_id)
+          .url_segment(token_id)
           .get()
           .go()
     end
@@ -2868,7 +2883,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the tenants.
+    # Retrieves all the tenants.
     #
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def retrieve_tenants()
@@ -2890,7 +2905,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the themes.
+    # Retrieves all the themes.
     #
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def retrieve_themes()
@@ -2922,6 +2937,25 @@ module FusionAuth
           .go()
     end
 
+    #
+    # Retrieve a user's two-factor status.
+    # 
+    # This can be used to see if a user will need to complete a two-factor challenge to complete a login,
+    # and optionally identify the state of the two-factor trust across various applications.
+    #
+    # @param user_id [string] The user Id to retrieve the Two-Factor status.
+    # @param application_id [string] The optional applicationId to verify.
+    # @param two_factor_trust_id [string] The optional two-factor trust Id to verify.
+    # @return [FusionAuth::ClientResponse] The ClientResponse object.
+    def retrieve_two_factor_status(user_id, application_id, two_factor_trust_id)
+      start.uri('/api/two-factor/status')
+          .url_parameter('userId', user_id)
+          .url_parameter('applicationId', application_id)
+          .url_segment(two_factor_trust_id)
+          .get()
+          .go()
+    end
+
     #
     # Retrieves the user for the given Id.
     #
@@ -2971,7 +3005,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the user actions.
+    # Retrieves all the user actions.
     #
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
     def retrieve_user_actions()
@@ -3043,7 +3077,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the comments for the user with the given Id.
+    # Retrieves all the comments for the user with the given Id.
     #
     # @param user_id [string] The Id of the user.
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
@@ -3067,7 +3101,7 @@ module FusionAuth
     end
 
     #
-    # Retrieves all of the consents for a User.
+    # Retrieves all the consents for a User.
     #
     # @param user_id [string] The User's Id
     # @return [FusionAuth::ClientResponse] The ClientResponse object.
@@ -3416,6 +3450,18 @@ module FusionAuth
           .go()
     end
 
+    #
+    # Searches group members with the specified criteria and pagination.
+    #
+    # @param request [OpenStruct, Hash] The search criteria and pagination information.
+    # @return [FusionAuth::ClientResponse] The ClientResponse object.
+    def search_group_members(request)
+      start.uri('/api/group/member/search')
+          .body_handler(FusionAuth::JSONBodyHandler.new(request))
+          .post()
+          .go()
+    end
+
     #
     # Searches the IP Access Control Lists with the specified criteria and pagination.
     #
@@ -3812,6 +3858,18 @@ module FusionAuth
           .go()
     end
 
+    #
+    # Creates a member in a group.
+    #
+    # @param request [OpenStruct, Hash] The request object that contains all the information used to create the group member(s).
+    # @return [FusionAuth::ClientResponse] The ClientResponse object.
+    def update_group_members(request)
+      start.uri('/api/group/member')
+          .body_handler(FusionAuth::JSONBodyHandler.new(request))
+          .put()
+          .go()
+    end
+
     #
     # Updates the IP Access Control List with the given Id.
     #
@@ -4127,6 +4185,20 @@ module FusionAuth
           .go()
     end
 
+    #
+    # Administratively verify a user's email address. Use this method to bypass email verification for the user.
+    # 
+    # The request body will contain the userId to be verified. An API key is required when sending the userId in the request body.
+    #
+    # @param request [OpenStruct, Hash] The request that contains the userId to verify.
+    # @return [FusionAuth::ClientResponse] The ClientResponse object.
+    def verify_email_address_by_user_id(request)
+      start.uri('/api/user/verify-email')
+          .body_handler(FusionAuth::JSONBodyHandler.new(request))
+          .post()
+          .go()
+    end
+
     #
     # Confirms an application registration. The Id given is usually from an email sent to the user.
     #

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fusionauth_client
 version: !ruby/object:Gem::Version
-  version: 1.34.0
+  version: 1.38.0
 platform: ruby
 authors:
 - Brian Pontarelli
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-02-22 00:00:00.000000000 Z
+date: 2022-08-17 00:00:00.000000000 Z
 dependencies: []
 description: This library contains the Ruby client library that helps you connect
   your application to FusionAuth.
@@ -28,6 +28,8 @@ files:
 - README.md
 - Rakefile
 - build.savant
+- examples/create_user.rb
+- examples/login.rb
 - fusionauth-ruby-client.iml
 - fusionauth_client.gemspec
 - lib/fusionauth/fusionauth_client.rb