crawlora-lolesports 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 60d1de8b0560079907e22e752a8c6859850dea1fa0aa5b6237d4d31ac6882433
+  data.tar.gz: 24c68a8dca459cabb467dd1bca80951a23938cafef36bff18980ed33f84623b4
+SHA512:
+  metadata.gz: cc9f9be8c0dccb9f136699dec21481d9d5e42aee2d0630c4eb1900681db1c332a614fdddc6891e1703587b92a9cb7d629128ee7456f32c3f0a5589616869df5b
+  data.tar.gz: 7c8eb1ae533fec5b8b3742fd83375e64970ee4e92668c0a233c38923138aff4e026dee28b7172eca245e720da915681cf17e678243aa110c6886a00b4e636b3f

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 0.1.0
+
+- Initial focused LoL Esports Ruby client for Crawlora's hosted API.

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Crawlora
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,53 @@
+# Crawlora LoL Esports API client for Ruby (`crawlora-lolesports`)
+
+This Ruby gem calls Crawlora's hosted LoL Esports API at `https://api.crawlora.net/api/v1`. It exposes 13 endpoints covering leagues, schedules, live and completed events, teams, players, and game details; it does not call or scrape LoL Esports directly. Requests require your Crawlora API key and use your account's service plan.
+
+## Install
+
+```ruby
+gem "crawlora-lolesports"
+```
+
+Create an account at [crawlora.net](https://crawlora.net/signup?utm_source=rubygems&utm_medium=referral&utm_campaign=platform-clients&utm_content=lolesports-ruby-signup), open the [Crawlora console](https://crawlora.net/app?utm_source=rubygems&utm_medium=referral&utm_campaign=platform-clients&utm_content=lolesports-ruby-console) to get an API key, and set `CRAWLORA_API_KEY` before running the client:
+
+```ruby
+require "json"
+require "crawlora/lolesports"
+
+client = Crawlora::Lolesports::Client.new
+result = client.request("lolesports-completed-events", JSON.parse("{\"tournament_id\": \"sample\"}"))
+puts result
+client.close
+```
+
+Use an operation-specific method for normal calls. `request(operation_id, params = {}, response_type: :auto)` is available for every operation. `response_type: :text` returns raw response text. This gem includes 13 API operations.
+
+```ruby
+client = Crawlora::Lolesports::Client.new(api_key: ENV.fetch("CRAWLORA_API_KEY"), timeout: 30)
+# client.<operation_method>(<endpoint parameters>)
+client.close
+```
+
+Client options include `api_key`, `base_url`, and `timeout`. Ruby stdlib provides the HTTP and JSON support.
+
+## Supported LoL Esports API endpoints
+
+Browse every route included in this gem. The [endpoint reference](https://github.com/Crawlora-org/crawlora-lolesports/blob/main/docs/usage.md) includes parameter and response details.
+
+| Method | Endpoint | API operation | Description |
+| --- | --- | --- | --- |
+| `GET` | `/lolesports/completed-events` | `lolesports-completed-events` | League of Legends Esports completed matches |
+| `GET` | `/lolesports/event` | `lolesports-event` | League of Legends Esports match detail |
+| `GET` | `/lolesports/game-details` | `lolesports-game-details` | League of Legends Esports player game details |
+| `GET` | `/lolesports/game-window` | `lolesports-game-window` | League of Legends Esports live game window |
+| `GET` | `/lolesports/gpr` | `lolesports-gpr` | League of Legends Global Power Rankings |
+| `GET` | `/lolesports/leagues` | `lolesports-leagues` | League of Legends Esports leagues |
+| `GET` | `/lolesports/live` | `lolesports-live` | League of Legends Esports live matches |
+| `GET` | `/lolesports/news` | `lolesports-news` | League of Legends Esports news |
+| `GET` | `/lolesports/schedule` | `lolesports-schedule` | League of Legends Esports schedule |
+| `GET` | `/lolesports/seasons` | `lolesports-seasons` | League of Legends Esports seasons and splits |
+| `GET` | `/lolesports/standings` | `lolesports-standings` | League of Legends Esports standings |
+| `GET` | `/lolesports/teams` | `lolesports-teams` | League of Legends Esports teams and rosters |
+| `GET` | `/lolesports/tournaments` | `lolesports-tournaments` | League of Legends Esports tournaments |
+
+See [Crawlora](https://crawlora.net/?utm_source=rubygems&utm_medium=referral&utm_campaign=platform-clients&utm_content=lolesports-ruby-homepage), the [API documentation](https://crawlora.net/docs?utm_source=rubygems&utm_medium=referral&utm_campaign=platform-clients&utm_content=lolesports-ruby-api-docs), and [the package repository](https://github.com/Crawlora-org/crawlora-lolesports) for account setup, the API operation reference, and release history.

data/lib/crawlora/lolesports/client.rb

@@ -0,0 +1,248 @@
+require "json"
+require "net/http"
+require "uri"
+
+module Crawlora
+  module Lolesports
+    module Errors
+      class Error < StandardError
+        attr_reader :status, :operation_id, :body
+
+        def initialize(message, status: nil, operation_id: nil, body: nil)
+          super(message)
+          @status, @operation_id, @body = status, operation_id, body
+        end
+      end
+      class ClientError < Error; end
+      class ServerError < Error; end
+      class NetworkError < Error; end
+    end
+
+    OPERATIONS = JSON.parse(<<~'JSON').freeze
+      {"lolesports-completed-events": {"bodyParam": null, "bodyRequired": false, "id": "lolesports-completed-events", "method": "GET", "params": [{"description": "Language for names and labels; one of cs-CZ, de-DE, en-US, es-ES, es-MX, fr-FR, hu-HU, ja-JP, ko-KR, pl-PL, pt-BR, th-TH, tr-TR, vi-VN, zh-TW; defaults to en-US", "enum": ["cs-CZ", "de-DE", "en-US", "es-ES", "es-MX", "fr-FR", "hu-HU", "ja-JP", "ko-KR", "pl-PL", "pt-BR", "th-TH", "tr-TR", "vi-VN", "zh-TW"], "in": "query", "name": "hl", "type": "string"}, {"description": "Numeric tournament id from lolesports-tournaments", "in": "query", "name": "tournament_id", "required": true, "type": "string", "x-example": "115548681802226458"}], "path": "/lolesports/completed-events", "pathParams": [], "produces": ["application/json"], "queryParams": [{"enum": ["cs-CZ", "de-DE", "en-US", "es-ES", "es-MX", "fr-FR", "hu-HU", "ja-JP", "ko-KR", "pl-PL", "pt-BR", "th-TH", "tr-TR", "vi-VN", "zh-TW"], "in": "query", "name": "hl", "type": "string"}, {"in": "query", "name": "tournament_id", "required": true, "type": "string"}], "security": ["ApiKeyAuth"]}, "lolesports-event": {"bodyParam": null, "bodyRequired": false, "id": "lolesports-event", "method": "GET", "params": [{"description": "Language for names and labels; one of cs-CZ, de-DE, en-US, es-ES, es-MX, fr-FR, hu-HU, ja-JP, ko-KR, pl-PL, pt-BR, th-TH, tr-TR, vi-VN, zh-TW; defaults to en-US", "enum": ["cs-CZ", "de-DE", "en-US", "es-ES", "es-MX", "fr-FR", "hu-HU", "ja-JP", "ko-KR", "pl-PL", "pt-BR", "th-TH", "tr-TR", "vi-VN", "zh-TW"], "in": "query", "name": "hl", "type": "string"}, {"description": "Numeric match id from lolesports-schedule, lolesports-live or lolesports-standings", "in": "query", "name": "match_id", "required": true, "type": "string", "x-example": "117133816701918802"}], "path": "/lolesports/event", "pathParams": [], "produces": ["application/json"], "queryParams": [{"enum": ["cs-CZ", "de-DE", "en-US", "es-ES", "es-MX", "fr-FR", "hu-HU", "ja-JP", "ko-KR", "pl-PL", "pt-BR", "th-TH", "tr-TR", "vi-VN", "zh-TW"], "in": "query", "name": "hl", "type": "string"}, {"in": "query", "name": "match_id", "required": true, "type": "string"}], "security": ["ApiKeyAuth"]}, "lolesports-game-details": {"bodyParam": null, "bodyRequired": false, "id": "lolesports-game-details", "method": "GET", "params": [{"description": "Numeric game id from lolesports-event", "in": "query", "name": "game_id", "required": true, "type": "string", "x-example": "117133816701918803"}, {"description": "RFC 3339 UTC timestamp whose seconds are divisible by 10; frames begin there", "in": "query", "name": "starting_time", "type": "string", "x-example": "2026-10-07T11:30:00.000Z"}, {"description": "Participant numbers 1 to 10 joined by underscores, for example 1_2_3", "in": "query", "name": "participant_ids", "type": "string", "x-example": "1_2"}], "path": "/lolesports/game-details", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "game_id", "required": true, "type": "string"}, {"in": "query", "name": "starting_time", "type": "string"}, {"in": "query", "name": "participant_ids", "type": "string"}], "security": ["ApiKeyAuth"]}, "lolesports-game-window": {"bodyParam": null, "bodyRequired": false, "id": "lolesports-game-window", "method": "GET", "params": [{"description": "Numeric game id from lolesports-event", "in": "query", "name": "game_id", "required": true, "type": "string", "x-example": "117133816701918803"}, {"description": "RFC 3339 UTC timestamp whose seconds are divisible by 10; frames begin there", "in": "query", "name": "starting_time", "type": "string", "x-example": "2026-10-07T10:20:00.000Z"}], "path": "/lolesports/game-window", "pathParams": [], "produces": ["application/json"], "queryParams": [{"in": "query", "name": "game_id", "required": true, "type": "string"}, {"in": "query", "name": "starting_time", "type": "string"}], "security": ["ApiKeyAuth"]}, "lolesports-gpr": {"bodyParam": null, "bodyRequired": false, "id": "lolesports-gpr", "method": "GET", "params": [{"description": "Ranking snapshot; one of current, 2025, 2024; defaults to current", "enum": ["current", "2025", "2024"], "in": "query", "name": "season", "type": "string"}, {"description": "Home league slug from the leagues list of the response, for example lck", "in": "query", "name": "league", "type": "string"}, {"description": "Number of teams to return, 1 to 200, best rank first; defaults to all", "in": "query", "maximum": 200, "minimum": 1, "name": "limit", "type": "integer"}, {"description": "Add each team's GPR history points", "in": "query", "name": "history", "type": "boolean"}], "path": "/lolesports/gpr", "pathParams": [], "produces": ["application/json"], "queryParams": [{"enum": ["current", "2025", "2024"], "in": "query", "name": "season", "type": "string"}, {"in": "query", "name": "league", "type": "string"}, {"in": "query", "name": "limit", "type": "integer"}, {"in": "query", "name": "history", "type": "boolean"}], "security": ["ApiKeyAuth"]}, "lolesports-leagues": {"bodyParam": null, "bodyRequired": false, "id": "lolesports-leagues", "method": "GET", "params": [{"description": "Language for names and labels; one of cs-CZ, de-DE, en-US, es-ES, es-MX, fr-FR, hu-HU, ja-JP, ko-KR, pl-PL, pt-BR, th-TH, tr-TR, vi-VN, zh-TW; defaults to en-US", "enum": ["cs-CZ", "de-DE", "en-US", "es-ES", "es-MX", "fr-FR", "hu-HU", "ja-JP", "ko-KR", "pl-PL", "pt-BR", "th-TH", "tr-TR", "vi-VN", "zh-TW"], "in": "query", "name": "hl", "type": "string"}], "path": "/lolesports/leagues", "pathParams": [], "produces": ["application/json"], "queryParams": [{"enum": ["cs-CZ", "de-DE", "en-US", "es-ES", "es-MX", "fr-FR", "hu-HU", "ja-JP", "ko-KR", "pl-PL", "pt-BR", "th-TH", "tr-TR", "vi-VN", "zh-TW"], "in": "query", "name": "hl", "type": "string"}], "security": ["ApiKeyAuth"]}, "lolesports-live": {"bodyParam": null, "bodyRequired": false, "id": "lolesports-live", "method": "GET", "params": [{"description": "Language for names and labels; one of cs-CZ, de-DE, en-US, es-ES, es-MX, fr-FR, hu-HU, ja-JP, ko-KR, pl-PL, pt-BR, th-TH, tr-TR, vi-VN, zh-TW; defaults to en-US", "enum": ["cs-CZ", "de-DE", "en-US", "es-ES", "es-MX", "fr-FR", "hu-HU", "ja-JP", "ko-KR", "pl-PL", "pt-BR", "th-TH", "tr-TR", "vi-VN", "zh-TW"], "in": "query", "name": "hl", "type": "string"}], "path": "/lolesports/live", "pathParams": [], "produces": ["application/json"], "queryParams": [{"enum": ["cs-CZ", "de-DE", "en-US", "es-ES", "es-MX", "fr-FR", "hu-HU", "ja-JP", "ko-KR", "pl-PL", "pt-BR", "th-TH", "tr-TR", "vi-VN", "zh-TW"], "in": "query", "name": "hl", "type": "string"}], "security": ["ApiKeyAuth"]}, "lolesports-news": {"bodyParam": null, "bodyRequired": false, "id": "lolesports-news", "method": "GET", "params": [{"description": "Site language; one of cs-CZ, de-DE, el-GR, en-AU, en-GB, en-PH, en-SG, en-US, es-ES, es-MX, fr-FR, hu-HU, id-ID, it-IT, ja-JP, ko-KR, pl-PL, pt-BR, ro-RO, ru-RU, th-TH, tr-TR, vi-VN, zh-TW; defaults to en-US", "enum": ["cs-CZ", "de-DE", "el-GR", "en-AU", "en-GB", "en-PH", "en-SG", "en-US", "es-ES", "es-MX", "fr-FR", "hu-HU", "id-ID", "it-IT", "ja-JP", "ko-KR", "pl-PL", "pt-BR", "ro-RO", "ru-RU", "th-TH", "tr-TR", "vi-VN", "zh-TW"], "in": "query", "name": "hl", "type": "string"}, {"description": "Number of newest articles to return, 1 to 100; defaults to all the page lists", "in": "query", "maximum": 100, "minimum": 1, "name": "limit", "type": "integer"}], "path": "/lolesports/news", "pathParams": [], "produces": ["application/json"], "queryParams": [{"enum": ["cs-CZ", "de-DE", "el-GR", "en-AU", "en-GB", "en-PH", "en-SG", "en-US", "es-ES", "es-MX", "fr-FR", "hu-HU", "id-ID", "it-IT", "ja-JP", "ko-KR", "pl-PL", "pt-BR", "ro-RO", "ru-RU", "th-TH", "tr-TR", "vi-VN", "zh-TW"], "in": "query", "name": "hl", "type": "string"}, {"in": "query", "name": "limit", "type": "integer"}], "security": ["ApiKeyAuth"]}, "lolesports-schedule": {"bodyParam": null, "bodyRequired": false, "id": "lolesports-schedule", "method": "GET", "params": [{"description": "Language for names and labels; one of cs-CZ, de-DE, en-US, es-ES, es-MX, fr-FR, hu-HU, ja-JP, ko-KR, pl-PL, pt-BR, th-TH, tr-TR, vi-VN, zh-TW; defaults to en-US", "enum": ["cs-CZ", "de-DE", "en-US", "es-ES", "es-MX", "fr-FR", "hu-HU", "ja-JP", "ko-KR", "pl-PL", "pt-BR", "th-TH", "tr-TR", "vi-VN", "zh-TW"], "in": "query", "name": "hl", "type": "string"}, {"description": "Numeric league id from lolesports-leagues, or up to 10 comma-separated ids to combine leagues; omit for all leagues", "in": "query", "name": "league_id", "type": "string", "x-example": "98767991302996019"}, {"description": "older_page_token or newer_page_token copied from a previous response", "in": "query", "name": "page_token", "type": "string"}], "path": "/lolesports/schedule", "pathParams": [], "produces": ["application/json"], "queryParams": [{"enum": ["cs-CZ", "de-DE", "en-US", "es-ES", "es-MX", "fr-FR", "hu-HU", "ja-JP", "ko-KR", "pl-PL", "pt-BR", "th-TH", "tr-TR", "vi-VN", "zh-TW"], "in": "query", "name": "hl", "type": "string"}, {"in": "query", "name": "league_id", "type": "string"}, {"in": "query", "name": "page_token", "type": "string"}], "security": ["ApiKeyAuth"]}, "lolesports-seasons": {"bodyParam": null, "bodyRequired": false, "id": "lolesports-seasons", "method": "GET", "params": [{"description": "Language for names and labels; one of cs-CZ, de-DE, en-US, es-ES, es-MX, fr-FR, hu-HU, ja-JP, ko-KR, pl-PL, pt-BR, th-TH, tr-TR, vi-VN, zh-TW; defaults to en-US", "enum": ["cs-CZ", "de-DE", "en-US", "es-ES", "es-MX", "fr-FR", "hu-HU", "ja-JP", "ko-KR", "pl-PL", "pt-BR", "th-TH", "tr-TR", "vi-VN", "zh-TW"], "in": "query", "name": "hl", "type": "string"}, {"description": "Numeric season id from an earlier lolesports-seasons response; omit for every season", "in": "query", "name": "season_id", "type": "string", "x-example": "115547545029543948"}, {"description": "Split region, case-insensitive; one of AMERICAS, BRAZIL, CHINA, COMMONWEALTH OF INDEPENDENT STATES, EMEA, EUROPE, GLOBAL, HONG KONG, MACAU, TAIWAN, INTERNATIONAL, JAPAN, KOREA, LATIN AMERICA, LATIN AMERICA NORTH, LATIN AMERICA SOUTH, NORTH AMERICA, OCEANIA, REGIONAL, SOUTHEAST ASIA, TURKEY, VIETNAM", "in": "query", "name": "region", "type": "string", "x-example": "KOREA"}, {"description": "Numeric league id from lolesports-leagues; keeps only that league's tournaments", "in": "query", "name": "league_id", "type": "string", "x-example": "98767991302996019"}], "path": "/lolesports/seasons", "pathParams": [], "produces": ["application/json"], "queryParams": [{"enum": ["cs-CZ", "de-DE", "en-US", "es-ES", "es-MX", "fr-FR", "hu-HU", "ja-JP", "ko-KR", "pl-PL", "pt-BR", "th-TH", "tr-TR", "vi-VN", "zh-TW"], "in": "query", "name": "hl", "type": "string"}, {"in": "query", "name": "season_id", "type": "string"}, {"in": "query", "name": "region", "type": "string"}, {"in": "query", "name": "league_id", "type": "string"}], "security": ["ApiKeyAuth"]}, "lolesports-standings": {"bodyParam": null, "bodyRequired": false, "id": "lolesports-standings", "method": "GET", "params": [{"description": "Language for names and labels; one of cs-CZ, de-DE, en-US, es-ES, es-MX, fr-FR, hu-HU, ja-JP, ko-KR, pl-PL, pt-BR, th-TH, tr-TR, vi-VN, zh-TW; defaults to en-US", "enum": ["cs-CZ", "de-DE", "en-US", "es-ES", "es-MX", "fr-FR", "hu-HU", "ja-JP", "ko-KR", "pl-PL", "pt-BR", "th-TH", "tr-TR", "vi-VN", "zh-TW"], "in": "query", "name": "hl", "type": "string"}, {"description": "Numeric tournament id from lolesports-tournaments", "in": "query", "name": "tournament_id", "required": true, "type": "string", "x-example": "115548681802226458"}, {"description": "true adds each section's id and type (group or bracket) and bracket round names with their match ids; costs a second upstream call; false or omitted keeps the default response", "enum": [true, false], "in": "query", "name": "rounds", "type": "boolean"}], "path": "/lolesports/standings", "pathParams": [], "produces": ["application/json"], "queryParams": [{"enum": ["cs-CZ", "de-DE", "en-US", "es-ES", "es-MX", "fr-FR", "hu-HU", "ja-JP", "ko-KR", "pl-PL", "pt-BR", "th-TH", "tr-TR", "vi-VN", "zh-TW"], "in": "query", "name": "hl", "type": "string"}, {"in": "query", "name": "tournament_id", "required": true, "type": "string"}, {"enum": ["True", "False"], "in": "query", "name": "rounds", "type": "boolean"}], "security": ["ApiKeyAuth"]}, "lolesports-teams": {"bodyParam": null, "bodyRequired": false, "id": "lolesports-teams", "method": "GET", "params": [{"description": "Language for names and labels; one of cs-CZ, de-DE, en-US, es-ES, es-MX, fr-FR, hu-HU, ja-JP, ko-KR, pl-PL, pt-BR, th-TH, tr-TR, vi-VN, zh-TW; defaults to en-US", "enum": ["cs-CZ", "de-DE", "en-US", "es-ES", "es-MX", "fr-FR", "hu-HU", "ja-JP", "ko-KR", "pl-PL", "pt-BR", "th-TH", "tr-TR", "vi-VN", "zh-TW"], "in": "query", "name": "hl", "type": "string"}, {"description": "Exact team slug such as t1 or g2-esports; takes precedence over q", "in": "query", "name": "slug", "type": "string", "x-example": "t1"}, {"description": "Case-insensitive substring of team name, code or slug", "in": "query", "name": "q", "type": "string"}, {"description": "Team status filter: active or archived", "enum": ["active", "archived"], "in": "query", "name": "status", "type": "string"}, {"description": "1-based page number; defaults to 1", "in": "query", "minimum": 1, "name": "page", "type": "integer"}, {"description": "Page size 1 to 100; defaults to 25", "in": "query", "maximum": 100, "minimum": 1, "name": "limit", "type": "integer"}], "path": "/lolesports/teams", "pathParams": [], "produces": ["application/json"], "queryParams": [{"enum": ["cs-CZ", "de-DE", "en-US", "es-ES", "es-MX", "fr-FR", "hu-HU", "ja-JP", "ko-KR", "pl-PL", "pt-BR", "th-TH", "tr-TR", "vi-VN", "zh-TW"], "in": "query", "name": "hl", "type": "string"}, {"in": "query", "name": "slug", "type": "string"}, {"in": "query", "name": "q", "type": "string"}, {"enum": ["active", "archived"], "in": "query", "name": "status", "type": "string"}, {"in": "query", "name": "page", "type": "integer"}, {"in": "query", "name": "limit", "type": "integer"}], "security": ["ApiKeyAuth"]}, "lolesports-tournaments": {"bodyParam": null, "bodyRequired": false, "id": "lolesports-tournaments", "method": "GET", "params": [{"description": "Language for names and labels; one of cs-CZ, de-DE, en-US, es-ES, es-MX, fr-FR, hu-HU, ja-JP, ko-KR, pl-PL, pt-BR, th-TH, tr-TR, vi-VN, zh-TW; defaults to en-US", "enum": ["cs-CZ", "de-DE", "en-US", "es-ES", "es-MX", "fr-FR", "hu-HU", "ja-JP", "ko-KR", "pl-PL", "pt-BR", "th-TH", "tr-TR", "vi-VN", "zh-TW"], "in": "query", "name": "hl", "type": "string"}, {"description": "Numeric league id from lolesports-leagues", "in": "query", "name": "league_id", "required": true, "type": "string", "x-example": "98767991302996019"}], "path": "/lolesports/tournaments", "pathParams": [], "produces": ["application/json"], "queryParams": [{"enum": ["cs-CZ", "de-DE", "en-US", "es-ES", "es-MX", "fr-FR", "hu-HU", "ja-JP", "ko-KR", "pl-PL", "pt-BR", "th-TH", "tr-TR", "vi-VN", "zh-TW"], "in": "query", "name": "hl", "type": "string"}, {"in": "query", "name": "league_id", "required": true, "type": "string"}], "security": ["ApiKeyAuth"]}}
+    JSON
+    OPERATION_IDS = JSON.parse(<<~'JSON').freeze
+      ["lolesports-completed-events", "lolesports-event", "lolesports-game-details", "lolesports-game-window", "lolesports-gpr", "lolesports-leagues", "lolesports-live", "lolesports-news", "lolesports-schedule", "lolesports-seasons", "lolesports-standings", "lolesports-teams", "lolesports-tournaments"]
+    JSON
+    OPERATION_COUNT = OPERATION_IDS.length
+
+    class Client
+      attr_reader :base_url
+
+      def initialize(api_key: ENV["CRAWLORA_API_KEY"], base_url: "https://api.crawlora.net/api/v1", timeout: 30, user_agent: "crawlora-lolesports-ruby/0.1.0", transport: nil)
+        @api_key = api_key
+        @base_url = base_url.to_s.sub(%r{/+$}, "")
+        @timeout = Float(timeout)
+        @user_agent = user_agent
+        @transport = transport
+        @closed = false
+      end
+
+      def request(operation_id, params = {}, response_type: :auto)
+        raise Errors::ClientError, "client is closed" if @closed
+        operation_id = operation_id.to_s
+        operation = OPERATIONS[operation_id]
+        raise Errors::ClientError.new("unknown operation: #{operation_id}", operation_id: operation_id) unless operation
+        raise Errors::ClientError.new("Crawlora API key is required", operation_id: operation_id) if @api_key.nil? || @api_key.to_s.empty?
+        normalized = params.each_with_object({}) { |(key, value), out| out[key.to_s] = value }
+        payload = request_body(operation, normalized)
+        url = build_url(operation, normalized)
+        uri = URI.parse(url)
+        request = operation["method"] == "POST" ? Net::HTTP::Post.new(uri) : Net::HTTP::Get.new(uri)
+        unless payload.nil?
+          request.body = payload
+          request["Content-Type"] = "application/json"
+        end
+        request["x-api-key"] = @api_key
+        request["User-Agent"] = @user_agent
+        request["Accept"] = operation["produces"].include?("text/plain") ? "application/json, text/plain" : "application/json"
+        begin
+          if @transport
+            response = if operation["method"] == "POST"
+              @transport.call(url, request.to_hash, @timeout, "POST", payload)
+            else
+              @transport.call(url, request.to_hash, @timeout)
+            end
+            status = Integer(response.fetch(:status) { response.fetch("status") })
+            body = response.fetch(:body) { response.fetch("body", "") }
+            headers = response.fetch(:headers) { response.fetch("headers", {}) }
+            content_type = headers["content-type"] || headers["Content-Type"]
+          else
+            http = Net::HTTP.new(uri.host, uri.port)
+            http.use_ssl = uri.scheme == "https"
+            http.open_timeout = @timeout
+            http.read_timeout = @timeout
+            response = http.start { |connection| connection.request(request) }
+            status = response.code.to_i
+            body = response.body
+            content_type = response["content-type"]
+          end
+        rescue Timeout::Error, SocketError, SystemCallError, IOError, EOFError, Net::HTTPBadResponse, Net::ProtocolError, OpenSSL::SSL::SSLError => error
+          raise Errors::NetworkError.new("Crawlora request failed: #{error.message}", operation_id: operation_id)
+        end
+        unless status >= 200 && status < 300
+          klass = status >= 500 ? Errors::ServerError : Errors::ClientError
+          raise klass.new("Crawlora returned HTTP #{status}", status: status, operation_id: operation_id, body: body)
+        end
+        parse_response(body, content_type, operation, normalized, response_type)
+      end
+
+      def close
+        @closed = true
+      end
+
+      def closed?
+        @closed
+      end
+
+      def with
+        return self unless block_given?
+        yield self
+      ensure
+        close if block_given?
+      end
+
+      def self.operation_count
+        OPERATION_COUNT
+      end
+
+      def self.operation_ids
+        OPERATION_IDS
+      end
+
+      def self.operations
+        OPERATIONS
+      end
+
+            define_method('completed_events') do |**params|
+        response_type = params.delete(:response_type) || params.delete(:_response_type) || :auto
+        request('lolesports-completed-events', params, response_type: response_type)
+      end
+      define_method('event') do |**params|
+        response_type = params.delete(:response_type) || params.delete(:_response_type) || :auto
+        request('lolesports-event', params, response_type: response_type)
+      end
+      define_method('game_details') do |**params|
+        response_type = params.delete(:response_type) || params.delete(:_response_type) || :auto
+        request('lolesports-game-details', params, response_type: response_type)
+      end
+      define_method('game_window') do |**params|
+        response_type = params.delete(:response_type) || params.delete(:_response_type) || :auto
+        request('lolesports-game-window', params, response_type: response_type)
+      end
+      define_method('gpr') do |**params|
+        response_type = params.delete(:response_type) || params.delete(:_response_type) || :auto
+        request('lolesports-gpr', params, response_type: response_type)
+      end
+      define_method('leagues') do |**params|
+        response_type = params.delete(:response_type) || params.delete(:_response_type) || :auto
+        request('lolesports-leagues', params, response_type: response_type)
+      end
+      define_method('live') do |**params|
+        response_type = params.delete(:response_type) || params.delete(:_response_type) || :auto
+        request('lolesports-live', params, response_type: response_type)
+      end
+      define_method('news') do |**params|
+        response_type = params.delete(:response_type) || params.delete(:_response_type) || :auto
+        request('lolesports-news', params, response_type: response_type)
+      end
+      define_method('schedule') do |**params|
+        response_type = params.delete(:response_type) || params.delete(:_response_type) || :auto
+        request('lolesports-schedule', params, response_type: response_type)
+      end
+      define_method('seasons') do |**params|
+        response_type = params.delete(:response_type) || params.delete(:_response_type) || :auto
+        request('lolesports-seasons', params, response_type: response_type)
+      end
+      define_method('standings') do |**params|
+        response_type = params.delete(:response_type) || params.delete(:_response_type) || :auto
+        request('lolesports-standings', params, response_type: response_type)
+      end
+      define_method('teams') do |**params|
+        response_type = params.delete(:response_type) || params.delete(:_response_type) || :auto
+        request('lolesports-teams', params, response_type: response_type)
+      end
+      define_method('tournaments') do |**params|
+        response_type = params.delete(:response_type) || params.delete(:_response_type) || :auto
+        request('lolesports-tournaments', params, response_type: response_type)
+      end
+
+      private
+
+      # POST operations take their JSON body under the body parameter name or "body".
+      def request_body(operation, params)
+        name = operation["bodyParam"]
+        return nil if name.nil?
+        value = params.key?(name) ? params[name] : params["body"]
+        if value.nil?
+          raise Errors::ClientError.new("missing request body: #{name}", operation_id: operation["id"]) if operation["bodyRequired"]
+          return nil
+        end
+        value.is_a?(String) ? value : JSON.generate(value)
+      end
+
+      def build_url(operation, params)
+        known = operation["params"].map { |param| param["name"] }
+        known << "body" if operation["bodyParam"]
+        unknown = params.keys - known
+        raise Errors::ClientError.new("unknown parameters: #{unknown.join(', ')}", operation_id: operation["id"]) unless unknown.empty?
+        path = operation["path"].dup
+        operation["params"].select { |param| param["in"] == "path" }.each do |param|
+          value = params[param["name"]]
+          raise Errors::ClientError.new("missing path parameter: #{param['name']}", operation_id: operation["id"]) if value.nil?
+          path.sub!("{" + param["name"] + "}", percent_encode(value.to_s))
+        end
+        pairs = []
+        operation["queryParams"].each do |param|
+          name = param["name"]
+          value = params.key?(name) ? params[name] : param["default"]
+          if value.nil?
+            raise Errors::ClientError.new("missing query parameter: #{name}", operation_id: operation["id"]) if param["required"]
+            next
+          end
+          enum_values = param["enum"] || (param["items"] && param["items"]["enum"])
+          if enum_values && !(value.is_a?(Array) ? value : [value]).all? { |item| enum_values.map(&:to_s).include?(item.to_s) }
+            raise Errors::ClientError.new("invalid value for #{name}", operation_id: operation["id"])
+          end
+          if value.is_a?(Array)
+            format = param["collectionFormat"] || "csv"
+            if format == "multi"
+              value.each { |item| pairs << [name, scalar(item)] }
+            else
+              separator = {"csv" => ",", "ssv" => " ", "tsv" => "\t", "pipes" => "|"}[format] || ","
+              pairs << [name, value.map { |item| scalar(item) }.join(separator)]
+            end
+          else
+            pairs << [name, scalar(value)]
+          end
+        end
+        query = pairs.map { |name, value| "#{percent_encode(name)}=#{percent_encode(value)}" }.join("&")
+        @base_url + path + (query.empty? ? "" : "?" + query)
+      end
+
+      def scalar(value)
+        value == true ? "true" : (value == false ? "false" : value.to_s)
+      end
+
+      def percent_encode(value)
+        URI::DEFAULT_PARSER.escape(value.to_s, /[^A-Za-z0-9\-._~]/)
+      end
+
+      def parse_response(body, content_type, operation, params, response_type)
+        type = response_type.to_s
+        raise Errors::ClientError.new("response_type must be auto, json, or text", operation_id: operation["id"]) unless %w[auto json text].include?(type)
+        format = operation["params"].find { |param| param["name"] == "format" }
+        text_formats = format && format["enum"] ? format["enum"].reject { |value| %w[json application/json].include?(value.to_s.downcase) } : []
+        raw_format = params["format"] && text_formats.include?(params["format"].to_s)
+        json_format = format && format["enum"] && format["enum"].any? { |value| %w[json application/json].include?(value.to_s.downcase) } && %w[json application/json].include?(params["format"].to_s.downcase)
+        is_json = json_format || content_type.to_s.downcase.include?("json") || operation["produces"] == ["application/json"]
+        return body if type == "text" || raw_format || (type == "auto" && !is_json)
+        JSON.parse(body)
+      rescue JSON::ParserError => error
+        raise Errors::Error.new("invalid JSON response from Crawlora: #{error.message}", operation_id: operation["id"], body: body)
+      end
+
+      public
+    end
+  end
+end

data/lib/crawlora/lolesports/version.rb

@@ -0,0 +1,5 @@
+module Crawlora
+  module Lolesports
+    VERSION = "0.1.0"
+  end
+end

data/lib/crawlora/lolesports.rb

@@ -0,0 +1,2 @@
+require_relative "lolesports/version"
+require_relative "lolesports/client"

metadata

@@ -0,0 +1,52 @@
+--- !ruby/object:Gem::Specification
+name: crawlora-lolesports
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Crawlora
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-11-04 00:00:00.000000000 Z
+dependencies: []
+description: Ruby client for Crawlora's hosted LoL Esports API. Covers leagues, schedules,
+  live and completed events, teams, players, and game details across 13 endpoints.
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/crawlora/lolesports.rb
+- lib/crawlora/lolesports/client.rb
+- lib/crawlora/lolesports/version.rb
+homepage: https://crawlora.net/?utm_source=rubygems&utm_medium=referral&utm_campaign=platform-clients&utm_content=lolesports-ruby-homepage
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/Crawlora-org/crawlora-lolesports
+  documentation_uri: https://github.com/Crawlora-org/crawlora-lolesports/blob/main/ruby/README.md
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.6'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.19
+signing_key:
+specification_version: 4
+summary: LoL Esports API client for Crawlora (13 endpoints)
+test_files: []