Add #as_app method to API

README.md

@@ -266,6 +266,16 @@ For configuring a connection through proxy, you can pass `proxy_host`, `proxy_po
 client = Shikimori::API::Client.new(proxy_host: 'http://my-proxy', proxy_port: 8080, proxy_user: 'my_proxy_user', proxy_password: 'my_proxy_password')
 ```
 
+You can also using client as application:
+
+```ruby
+Shikimori::API::Client.as_app(access_token: 'access-token') do |client|
+   animes = client.animes
+   mangas = client.mangas
+   # some logic ...
+end
+```
+
 ## Supported Ruby Versions
 This library aims to support and is tested against the following Ruby implementations:
 * Ruby 3.0

lib/shikimori/api/client.rb

@@ -32,6 +32,25 @@ def initialize(site = DEFAULT_SITE_URL, **options)
         @v1 = V1.new(base_url: base_uri.join('api/'), rest: rest)
         @v2 = V2.new(base_url: base_uri.join('api/v2/'), rest: rest)
       end
+
+      # Using shikimori client as application
+      #
+      # @yield [Client] client instance
+      # @example Usage example
+      #   Shikimori::API::Client.as_app(access_token: 'my-access-token') do |client|
+      #     animes = client.v1.animes
+      #     mangas = client.v1.mangas
+      #     # some logic ...
+      #   end
+      #
+      # @see #initialize
+      def self.as_app(site = DEFAULT_SITE_URL, **options)
+        client = new(site, **options)
+
+        yield client
+
+        client
+      end
     end
   end
 end

sig/shikimori/api/client.rbs

@@ -7,6 +7,8 @@ module Shikimori
       attr_reader v2: V2
 
       def initialize: (?String site, **untyped) -> void
+
+      def self.as_app: (?String site, **untyped) { (Shikimori::API::Client) -> void } -> Shikimori::API::Client
     end
   end
 end

spec/shikimori/api/client_spec.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+RSpec.describe Shikimori::API::Client do
+  describe '#as_app' do
+    it 'yields the client object' do
+      described_class.as_app do |client|
+        expect(client).to be_an_instance_of(described_class)
+      end
+    end
+  end
+end