school21_api_sdk 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2950a193b5d022a8dfb23e709e288945870b3832abde0dc22f22703f43ee54c1
-  data.tar.gz: 6aa77ab9e31bf92bd292d55a1299179e60ead0458e8f64c6b1e6c2065e80ed13
+  metadata.gz: 99a326f17590996f1a32f8b90e1d33e24bb3f4c4af407246b183cbf36a373f1c
+  data.tar.gz: 0feee0967bc7bfc04e4858dfe760d0e9d8b3ce8ee01c37c3e697108aad3570d5
 SHA512:
-  metadata.gz: 4d8868c9698e3d051260c0deafb4f9e499f07fbaafd8f4b6f4f426edf8cb1176b607a225623eb98671c7cfe93529e27ec42960e2488ec89e9dbd5c5800a983ef
-  data.tar.gz: ab328077173d485143a794a66ad4aaae303e856e0341102071126cca6139ad6f59162a0b38b8c9b983fe053a778df2ea8387f0ca45e6f2ed840b436faf3066d8
+  metadata.gz: 7fe2674e37b676d1a875eb28a29cbcf6ce6adc8de67bfddc9d87c36d132b40b7c5d90c87a6ab51112b72738b03fde0cb243387253bceaabacb2cd7014452809f
+  data.tar.gz: e0c4d8d7b09d4aaec925ab242a4ff9f3d56cd937e407156cff2b8d6ff75bdaa5799eff03430bc3254b6d8b0c7c594754bc54844515f30f8a75370526f0ee24ca

data/README.md

@@ -13,7 +13,6 @@
 > you're using for the school everyday tasks.
 > As soon as other types of authorization will be added (such as using API token), they'll be implemented for this gem as well.
 
-
 ## Installation
 
 Install the gem and add to the application's Gemfile by executing:
@@ -28,11 +27,17 @@ If bundler is not being used to manage dependencies, install the gem by executin
 gem install school21_api_sdk
 ```
 
-## Usage
+## Setup
 
 Please check [docs](https://edu.21-school.ru/docs) for more information.
 
-- Require the gem and configure client object
+- Rails:
+
+```bash
+rails generate school21:install
+```
+
+- Manual:
 
 ```ruby
 require 'school21'
@@ -48,6 +53,8 @@ School21.configure do |config|
 end
 ```
 
+## Usage
+
 - Select the domain specific API that you want to use. This API has all endpoints related to that domain. Here's an example of `Participant API` and a call to `/participants/:login`
 
 ```ruby

data/lib/generators/school21/install/install_generator.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module School21
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path('templates', __dir__)
+
+      desc 'Creates a School21 initializer'
+
+      def copy_initializer
+        template 'school21.rb.tt', 'config/initializers/school21.rb'
+      end
+    end
+  end
+end

data/lib/generators/school21/install/templates/school21.rb.tt

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require 'school21'
+
+School21.configure do |config|
+  config.credentials = {
+    login: Rails.application.credentials.dig(:school21, :login) || ENV['SCHOOL21_LOGIN'],
+    password: Rails.application.credentials.dig(:school21, :password) || ENV['SCHOOL21_PASSWORD']
+  }
+
+  config.enable_logging = Rails.env.development?
+end

data/lib/school21/api/participants_api.rb

@@ -27,5 +27,12 @@ module School21
 
       execute_request(new_request)
     end
+
+    def participant_skills(login)
+      path = ['/participants/', login, '/skills'].join
+      new_request = request_with_auth_participant(HttpMethod::GET, path, :api_v1)
+
+      execute_request(new_request)
+    end
   end
 end

data/lib/school21/auth/authenticator.rb

@@ -4,22 +4,28 @@ module School21
   class AccessTokenError < StandardError; end
 
   module Authenticator
+    MUTEX = Mutex.new
+
     def self.call
       return unless School21.config.access_token.expired?
 
-      auth_api_response = School21.auth_api.token(
-        login: School21.config.credentials[:login],
-        password: School21.config.credentials[:password]
-      )
+      MUTEX.synchronize do
+        return unless School21.config.access_token.expired?
+
+        auth_api_response = School21.auth_api.token(
+          login: School21.config.credentials[:login],
+          password: School21.config.credentials[:password]
+        )
 
-      raise AccessTokenError unless auth_api_response.success?
+        raise AccessTokenError unless auth_api_response.success?
 
-      access_token = AccessToken.new(*auth_api_response.data.values_at(:access_token, :expires_in))
-      bearer_auth_credentials = BearerAuthCredentials.new(access_token:)
-      auth_header = AuthorizationHeader.new(bearer_auth_credentials)
+        access_token = AccessToken.new(*auth_api_response.data.values_at(:access_token, :expires_in))
+        bearer_auth_credentials = BearerAuthCredentials.new(access_token:)
+        auth_header = AuthorizationHeader.new(bearer_auth_credentials)
 
-      School21.config.access_token = access_token
-      School21.config.auth_managers[BaseApi::PLATFORM_AUTH_PARTICIPANT] = auth_header
+        School21.config.access_token = access_token
+        School21.config.auth_managers[BaseApi::PLATFORM_AUTH_PARTICIPANT] = auth_header
+      end
     end
   end
 end

data/lib/school21/auth/bearer_auth_credentials.rb

@@ -5,9 +5,12 @@ module School21
     attr_reader :access_token
 
     def initialize(access_token:)
-      raise ArgumentError, 'access_token cannot be nil' if access_token.nil?
-
-      @access_token = access_token.access_token
+      case access_token
+      in String
+        @access_token = access_token
+      in AccessToken
+        @access_token = access_token.access_token
+      end
     end
   end
 end

data/lib/school21/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module School21
-  VERSION = '0.6.0'
+  VERSION = '0.7.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: school21_api_sdk
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Anton Yudin
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-09-21 00:00:00.000000000 Z
+date: 2026-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -105,6 +105,8 @@ files:
 - README.md
 - bin/console
 - bin/setup
+- lib/generators/school21/install/install_generator.rb
+- lib/generators/school21/install/templates/school21.rb.tt
 - lib/school21.rb
 - lib/school21/api/auth_api.rb
 - lib/school21/api/base_api.rb