telegram-bot-ruby 2.4.0 → 2.6.0

data/rakelib/parsers/methods_parser.rb

@@ -0,0 +1,115 @@
+# frozen_string_literal: true
+
+require 'nokogiri'
+require 'net/http'
+
+module Parsers
+  class MethodsParser
+    API_URL = 'https://core.telegram.org/bots/api'
+
+    def parse
+      doc = fetch_document
+      result = {}
+
+      method_headers(doc).each do |header|
+        method_name = extract_method_name(header)
+        next unless method_name
+
+        return_type = extract_return_type(header)
+        result[method_name] = return_type if return_type
+      end
+
+      result
+    end
+
+    private
+
+    def fetch_document
+      uri = URI.parse(API_URL)
+      response = Net::HTTP.get(uri)
+      Nokogiri::HTML(response)
+    end
+
+    def method_headers(doc)
+      doc.css('h4')
+    end
+
+    def extract_method_name(header)
+      name = header.text.strip
+      # Methods start with lowercase letter (camelCase)
+      # Types start with uppercase (PascalCase) - skip those
+      return nil unless name.match?(/\A[a-z][a-zA-Z0-9]*\z/)
+
+      name
+    end
+
+    def extract_return_type(header)
+      # Find description paragraphs after the header
+      sibling = header.next_element
+
+      while sibling
+        break if sibling.name == 'h4' # Next section
+
+        if sibling.name == 'p'
+          return_type = parse_return_statement(sibling)
+          return return_type if return_type
+        end
+
+        sibling = sibling.next_element
+      end
+
+      nil
+    end
+
+    def parse_return_statement(paragraph)
+      html = paragraph.inner_html
+
+      # Pattern: Returns an Array of <a>Type</a>
+      if (match = html.match(%r{Returns an Array of <a[^>]*>([^<]+)</a>}i))
+        return "Array<#{match[1]}>"
+      end
+
+      # Pattern: On success, an array of <a>Type</a> (lowercase)
+      if (match = html.match(%r{On success,? an array of <a[^>]*>([^<]+)</a>}i))
+        return "Array<#{match[1]}>"
+      end
+
+      # Pattern: Returns a <a>Type</a> or Returns the <a>Type</a>
+      if (match = html.match(%r{Returns (?:a |the )?.*?<a[^>]*>([^<]+)</a>}i))
+        return match[1]
+      end
+
+      # Pattern: Returns basic information ... in form of a <a>Type</a>
+      if (match = html.match(%r{in form of a <a[^>]*>([^<]+)</a>}i))
+        return match[1]
+      end
+
+      # Pattern: <a>Type</a> is returned, otherwise True is returned (union type)
+      # e.g., "the edited Message is returned, otherwise True is returned"
+      if (match = html.match(%r{<a[^>]*>([^<]+)</a> is returned,? otherwise <em>True</em> is returned}i))
+        return "#{match[1]} | Boolean"
+      end
+
+      # Pattern: Returns <em>True</em> or On success, <em>True</em> is returned
+      return 'Boolean' if html.match?(%r{<em>True</em>(?:\s+(?:is|on)|\s*\.)}i)
+
+      # Pattern: On success, a <a>Type</a> object is returned
+      if (match = html.match(%r{On success,? a <a[^>]*>([^<]+)</a> object is returned}i))
+        return match[1]
+      end
+
+      # Pattern: On success, the <a>Type</a> is returned / the edited/sent/stopped <a>X</a> is returned
+      if (match = html.match(%r{the (?:sent |edited |stopped )?<a[^>]*>([^<]+)</a> is returned}i))
+        return match[1]
+      end
+
+      # Pattern: Returns <em>Int</em> or Integer
+      return 'Integer' if html.match?(%r{Returns <em>Int</em>}i)
+
+      # Pattern: Returns ... as <em>String</em>
+      return 'String' if html.match?(%r{as <em>String</em>}i)
+
+      nil
+    end
+  end
+end

data/rakelib/parsers/types_parser.rb

@@ -0,0 +1,273 @@
+# frozen_string_literal: true
+
+require 'nokogiri'
+require 'net/http'
+
+module Parsers
+  class TypesParser
+    API_URL = 'https://core.telegram.org/bots/api'
+
+    PRIMITIVE_TYPES = {
+      'String' => 'string',
+      'Integer' => 'integer',
+      'Boolean' => 'boolean',
+      'Float' => 'number',
+      'True' => 'boolean'
+    }.freeze
+
+    def parse
+      doc = fetch_document
+      result = {}
+
+      type_headers(doc).each do |header|
+        type_name = extract_type_name(header)
+        next unless type_name
+
+        type_data = parse_type(header, type_name)
+        result[type_name] = type_data if type_data
+      end
+
+      result
+    end
+
+    private
+
+    def fetch_document
+      uri = URI.parse(API_URL)
+      response = Net::HTTP.get(uri)
+      Nokogiri::HTML(response)
+    end
+
+    def type_headers(doc)
+      doc.css('h4')
+    end
+
+    def extract_type_name(header)
+      name = header.text.strip
+      # Types start with uppercase letter (CapitalCase)
+      # Methods start with lowercase (camelCase) - skip those
+      return nil unless name.match?(/\A[A-Z][a-zA-Z0-9]*\z/)
+
+      name
+    end
+
+    def parse_type(header, _type_name)
+      # Check if this is a union type (list of types without a table)
+      next_sibling = find_next_significant_sibling(header)
+
+      if union_type?(next_sibling)
+        parse_union_type(next_sibling)
+      else
+        parse_table_type(header)
+      end
+    end
+
+    def find_next_significant_sibling(header)
+      sibling = header.next_element
+      # Skip description paragraphs
+      sibling = sibling.next_element while sibling && sibling.name == 'p'
+      sibling
+    end
+
+    def union_type?(element)
+      element&.name == 'ul'
+    end
+
+    def parse_union_type(ul_element)
+      types = ul_element.css('li a').map { |a| a.text.strip }
+      { 'type' => types }
+    end
+
+    def parse_table_type(header)
+      table = find_attribute_table(header)
+      return {} unless table
+
+      attributes = {}
+      table.css('tbody tr').each do |row|
+        cells = row.css('td')
+        next unless cells.length >= 3
+
+        field_name = cells[0].text.strip
+        type_info = cells[1]
+        description_cell = cells[2]
+
+        attributes[field_name] = parse_attribute(type_info, description_cell)
+      end
+
+      attributes
+    end
+
+    def find_attribute_table(header)
+      sibling = header.next_element
+      while sibling
+        return sibling if sibling.name == 'table'
+        # Stop if we hit another h4 (next type/method)
+        break if sibling.name == 'h4'
+
+        sibling = sibling.next_element
+      end
+      nil
+    end
+
+    def parse_attribute(type_cell, description_cell)
+      attribute = {}
+      raw_type = type_cell.text.strip
+      description = description_cell.text.strip
+      description_html = description_cell.inner_html
+
+      # Parse type
+      type_value = parse_type_value(type_cell)
+      if type_value.is_a?(Hash)
+        attribute.merge!(type_value)
+      else
+        attribute['type'] = type_value
+      end
+
+      # Parse required (absence of "Optional" at start of description)
+      attribute['required'] = true unless description.start_with?('Optional')
+
+      # Parse required_value (always "X" or must be <em>X</em>)
+      required_value = extract_required_value(description, description_html)
+      if required_value
+        attribute['required_value'] = required_value
+        attribute['default'] = required_value
+      end
+
+      # Parse size constraints (N-M characters or must be between)
+      min_size, max_size = extract_size_constraints(description)
+      attribute['min_size'] = min_size if min_size
+      attribute['max_size'] = max_size if max_size
+
+      # Parse default value (Defaults to X)
+      # If HTML type is 'True' (not 'Boolean'), it means the field only exists when true
+      if raw_type == 'True' && !attribute.key?('default')
+        attribute['default'] = true
+      elsif !attribute.key?('default')
+        default = extract_default_value(description, description_html, attribute['type'])
+        attribute['default'] = default unless default.nil?
+      end
+
+      # Clean up: remove required if false
+      attribute.delete('required') unless attribute['required']
+
+      attribute
+    end
+
+    def parse_type_value(type_cell)
+      text = type_cell.text.strip
+      links = type_cell.css('a')
+
+      # Check for "Array of X"
+      if text.start_with?('Array of')
+        items_type = parse_array_items(type_cell, text)
+        return { 'type' => 'array', 'items' => items_type }
+      end
+
+      # Check for union type "X or Y"
+      if text.include?(' or ')
+        types = parse_union_types(type_cell, text)
+        return types.length == 1 ? normalize_type(types.first) : types.map { |t| normalize_type(t) }
+      end
+
+      # Single type
+      if links.any?
+        normalize_type(links.first.text.strip)
+      else
+        normalize_type(text)
+      end
+    end
+
+    def parse_array_items(type_cell, text)
+      # Handle "Array of Array of X"
+      if text.include?('Array of Array of')
+        inner_type = type_cell.css('a').last&.text&.strip || text.split('Array of Array of').last.strip
+        return { 'type' => 'array', 'items' => normalize_type(inner_type) }
+      end
+
+      # Regular "Array of X"
+      link = type_cell.css('a').first
+      if link
+        normalize_type(link.text.strip)
+      else
+        # Primitive array like "Array of String"
+        items_text = text.sub('Array of ', '').strip
+        normalize_type(items_text)
+      end
+    end
+
+    def parse_union_types(type_cell, text)
+      links = type_cell.css('a')
+      if links.any?
+        links.map { |l| l.text.strip }
+      else
+        text.split(' or ').map(&:strip)
+      end
+    end
+
+    def normalize_type(type)
+      PRIMITIVE_TYPES[type] || type
+    end
+
+    def extract_required_value(description, description_html)
+      # Pattern: always "X" or always "X" (smart quotes)
+      match = description.match(/always ["\u201c]([^"\u201d]+)["\u201d]/i)
+      return match[1].delete('\\') if match
+
+      # Pattern: must be <em>X</em> (check inner HTML)
+      match = description_html.match(%r{must be <em>([^<]+)</em>}i)
+      return match[1] if match
+
+      nil
+    end
+
+    def extract_size_constraints(description)
+      min_size = nil
+      max_size = nil
+
+      # Pattern: N-M characters (covers 0-N and 1-N cases)
+      if (match = description.match(/(\d+)-(\d+) characters/))
+        min_val = match[1].to_i
+        max_size = match[2].to_i
+        min_size = min_val if min_val.positive?
+      # Pattern: must be between N and M
+      elsif (match = description.match(/must be between (\d+) and (\d+)/))
+        min_size = match[1].to_i
+        max_size = match[2].to_i
+      end
+
+      [min_size, max_size]
+    end
+
+    def extract_default_value(description, description_html, type)
+      # Pattern: Defaults to "X" (with smart quotes U+201C/U+201D)
+      if (match = description.match(/Defaults to \u201c([^\u201d]+)\u201d/i))
+        return cast_default_value(match[1], type)
+      end
+
+      # Pattern: Defaults to <em>X</em> (check inner HTML for em-wrapped values)
+      if (match = description_html.match(%r{Defaults to <em>([^<]+)</em>}i))
+        return cast_default_value(match[1], type)
+      end
+
+      # Pattern: Defaults to <number> (plain numeric values)
+      if (match = description.match(/Defaults to (\d+)/i))
+        return cast_default_value(match[1], type)
+      end
+
+      nil
+    end
+
+    def cast_default_value(value, type)
+      case type
+      when 'integer'
+        value.to_i
+      when 'boolean'
+        value.downcase == 'true'
+      when 'number'
+        value.to_f
+      else
+        value
+      end
+    end
+  end
+end

data/rakelib/rebuild.rake

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require 'json'
+require_relative 'builders/type_builder'
+require_relative 'builders/endpoints_builder'
+
+namespace :rebuild do
+  desc 'Rebuild types from type_attributes.json'
+  task :types do
+    types = JSON.parse(File.read("#{__dir__}/../data/types.json"), symbolize_names: true)
+    templates_dir = "#{__dir__}/templates"
+
+    types.each_pair do |name, attributes|
+      builder = Builders::TypeBuilder.new(name.to_s, attributes, templates_dir: templates_dir)
+      output_path = "#{__dir__}/../lib/telegram/bot/types/#{Builders::TypeBuilder.underscore(name)}.rb"
+
+      File.write(output_path, builder.build)
+    end
+  end
+
+  desc 'Rebuild API endpoints from method_return_types.json'
+  task :methods do
+    methods = JSON.parse(File.read("#{__dir__}/../data/methods.json"))
+    templates_dir = "#{__dir__}/templates"
+
+    builder = Builders::EndpointsBuilder.new(methods, templates_dir: templates_dir)
+
+    File.write "#{__dir__}/../lib/telegram/bot/api/endpoints.rb", builder.build
+  end
+end

data/rakelib/templates/endpoints.erb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Telegram
+  module Bot
+    class Api
+      ENDPOINTS = {
+<%- methods.each_with_index do |(name, return_type), index| -%>
+        '<%= name %>' => <%= return_type %><%= index == methods.size - 1 ? '' : ',' %>
+<%- end -%>
+      }.freeze
+    end
+  end
+end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: telegram-bot-ruby
 version: !ruby/object:Gem::Version
-  version: 2.4.0
+  version: 2.6.0
 platform: ruby
 authors:
 - Alexander Tipugin
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-02-13 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-struct
@@ -66,13 +65,13 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.6'
-description:
 email:
 - atipugin@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".claude/skills/update-api/SKILL.md"
 - ".editorconfig"
 - ".env.sample"
 - ".github/workflows/ci.yml"
@@ -97,6 +96,7 @@ files:
 - lib/telegram/bot/exceptions/response_error.rb
 - lib/telegram/bot/null_logger.rb
 - lib/telegram/bot/types.rb
+- lib/telegram/bot/types/accepted_gift_types.rb
 - lib/telegram/bot/types/affiliate_info.rb
 - lib/telegram/bot/types/animation.rb
 - lib/telegram/bot/types/audio.rb
@@ -123,6 +123,7 @@ files:
 - lib/telegram/bot/types/bot_description.rb
 - lib/telegram/bot/types/bot_name.rb
 - lib/telegram/bot/types/bot_short_description.rb
+- lib/telegram/bot/types/business_bot_rights.rb
 - lib/telegram/bot/types/business_connection.rb
 - lib/telegram/bot/types/business_intro.rb
 - lib/telegram/bot/types/business_location.rb
@@ -154,14 +155,22 @@ files:
 - lib/telegram/bot/types/chat_member_owner.rb
 - lib/telegram/bot/types/chat_member_restricted.rb
 - lib/telegram/bot/types/chat_member_updated.rb
+- lib/telegram/bot/types/chat_owner_changed.rb
+- lib/telegram/bot/types/chat_owner_left.rb
 - lib/telegram/bot/types/chat_permissions.rb
 - lib/telegram/bot/types/chat_photo.rb
 - lib/telegram/bot/types/chat_shared.rb
+- lib/telegram/bot/types/checklist.rb
+- lib/telegram/bot/types/checklist_task.rb
+- lib/telegram/bot/types/checklist_tasks_added.rb
+- lib/telegram/bot/types/checklist_tasks_done.rb
 - lib/telegram/bot/types/chosen_inline_result.rb
 - lib/telegram/bot/types/compactable.rb
 - lib/telegram/bot/types/contact.rb
 - lib/telegram/bot/types/copy_text_button.rb
 - lib/telegram/bot/types/dice.rb
+- lib/telegram/bot/types/direct_message_price_changed.rb
+- lib/telegram/bot/types/direct_messages_topic.rb
 - lib/telegram/bot/types/document.rb
 - lib/telegram/bot/types/encrypted_credentials.rb
 - lib/telegram/bot/types/encrypted_passport_element.rb
@@ -179,6 +188,8 @@ files:
 - lib/telegram/bot/types/general_forum_topic_hidden.rb
 - lib/telegram/bot/types/general_forum_topic_unhidden.rb
 - lib/telegram/bot/types/gift.rb
+- lib/telegram/bot/types/gift_background.rb
+- lib/telegram/bot/types/gift_info.rb
 - lib/telegram/bot/types/gifts.rb
 - lib/telegram/bot/types/giveaway.rb
 - lib/telegram/bot/types/giveaway_completed.rb
@@ -210,7 +221,10 @@ files:
 - lib/telegram/bot/types/inline_query_result_video.rb
 - lib/telegram/bot/types/inline_query_result_voice.rb
 - lib/telegram/bot/types/inline_query_results_button.rb
+- lib/telegram/bot/types/input_checklist.rb
+- lib/telegram/bot/types/input_checklist_task.rb
 - lib/telegram/bot/types/input_contact_message_content.rb
+- lib/telegram/bot/types/input_file.rb
 - lib/telegram/bot/types/input_invoice_message_content.rb
 - lib/telegram/bot/types/input_location_message_content.rb
 - lib/telegram/bot/types/input_media.rb
@@ -224,7 +238,13 @@ files:
 - lib/telegram/bot/types/input_paid_media_photo.rb
 - lib/telegram/bot/types/input_paid_media_video.rb
 - lib/telegram/bot/types/input_poll_option.rb
+- lib/telegram/bot/types/input_profile_photo.rb
+- lib/telegram/bot/types/input_profile_photo_animated.rb
+- lib/telegram/bot/types/input_profile_photo_static.rb
 - lib/telegram/bot/types/input_sticker.rb
+- lib/telegram/bot/types/input_story_content.rb
+- lib/telegram/bot/types/input_story_content_photo.rb
+- lib/telegram/bot/types/input_story_content_video.rb
 - lib/telegram/bot/types/input_text_message_content.rb
 - lib/telegram/bot/types/input_venue_message_content.rb
 - lib/telegram/bot/types/invoice.rb
@@ -235,6 +255,7 @@ files:
 - lib/telegram/bot/types/labeled_price.rb
 - lib/telegram/bot/types/link_preview_options.rb
 - lib/telegram/bot/types/location.rb
+- lib/telegram/bot/types/location_address.rb
 - lib/telegram/bot/types/login_url.rb
 - lib/telegram/bot/types/mask_position.rb
 - lib/telegram/bot/types/maybe_inaccessible_message.rb
@@ -254,12 +275,17 @@ files:
 - lib/telegram/bot/types/message_reaction_count_updated.rb
 - lib/telegram/bot/types/message_reaction_updated.rb
 - lib/telegram/bot/types/order_info.rb
+- lib/telegram/bot/types/owned_gift.rb
+- lib/telegram/bot/types/owned_gift_regular.rb
+- lib/telegram/bot/types/owned_gift_unique.rb
+- lib/telegram/bot/types/owned_gifts.rb
 - lib/telegram/bot/types/paid_media.rb
 - lib/telegram/bot/types/paid_media_info.rb
 - lib/telegram/bot/types/paid_media_photo.rb
 - lib/telegram/bot/types/paid_media_preview.rb
 - lib/telegram/bot/types/paid_media_purchased.rb
 - lib/telegram/bot/types/paid_media_video.rb
+- lib/telegram/bot/types/paid_message_price_changed.rb
 - lib/telegram/bot/types/passport_data.rb
 - lib/telegram/bot/types/passport_element_error.rb
 - lib/telegram/bot/types/passport_element_error_data_field.rb
@@ -299,12 +325,29 @@ files:
 - lib/telegram/bot/types/shipping_address.rb
 - lib/telegram/bot/types/shipping_option.rb
 - lib/telegram/bot/types/shipping_query.rb
+- lib/telegram/bot/types/star_amount.rb
 - lib/telegram/bot/types/star_transaction.rb
 - lib/telegram/bot/types/star_transactions.rb
 - lib/telegram/bot/types/sticker.rb
 - lib/telegram/bot/types/sticker_set.rb
 - lib/telegram/bot/types/story.rb
+- lib/telegram/bot/types/story_area.rb
+- lib/telegram/bot/types/story_area_position.rb
+- lib/telegram/bot/types/story_area_type.rb
+- lib/telegram/bot/types/story_area_type_link.rb
+- lib/telegram/bot/types/story_area_type_location.rb
+- lib/telegram/bot/types/story_area_type_suggested_reaction.rb
+- lib/telegram/bot/types/story_area_type_unique_gift.rb
+- lib/telegram/bot/types/story_area_type_weather.rb
 - lib/telegram/bot/types/successful_payment.rb
+- lib/telegram/bot/types/suggested_post_approval_failed.rb
+- lib/telegram/bot/types/suggested_post_approved.rb
+- lib/telegram/bot/types/suggested_post_declined.rb
+- lib/telegram/bot/types/suggested_post_info.rb
+- lib/telegram/bot/types/suggested_post_paid.rb
+- lib/telegram/bot/types/suggested_post_parameters.rb
+- lib/telegram/bot/types/suggested_post_price.rb
+- lib/telegram/bot/types/suggested_post_refunded.rb
 - lib/telegram/bot/types/switch_inline_query_chosen_chat.rb
 - lib/telegram/bot/types/text_quote.rb
 - lib/telegram/bot/types/transaction_partner.rb
@@ -315,10 +358,19 @@ files:
 - lib/telegram/bot/types/transaction_partner_telegram_ads.rb
 - lib/telegram/bot/types/transaction_partner_telegram_api.rb
 - lib/telegram/bot/types/transaction_partner_user.rb
+- lib/telegram/bot/types/unique_gift.rb
+- lib/telegram/bot/types/unique_gift_backdrop.rb
+- lib/telegram/bot/types/unique_gift_backdrop_colors.rb
+- lib/telegram/bot/types/unique_gift_colors.rb
+- lib/telegram/bot/types/unique_gift_info.rb
+- lib/telegram/bot/types/unique_gift_model.rb
+- lib/telegram/bot/types/unique_gift_symbol.rb
 - lib/telegram/bot/types/update.rb
 - lib/telegram/bot/types/user.rb
 - lib/telegram/bot/types/user_chat_boosts.rb
+- lib/telegram/bot/types/user_profile_audios.rb
 - lib/telegram/bot/types/user_profile_photos.rb
+- lib/telegram/bot/types/user_rating.rb
 - lib/telegram/bot/types/users_shared.rb
 - lib/telegram/bot/types/venue.rb
 - lib/telegram/bot/types/video.rb
@@ -327,22 +379,27 @@ files:
 - lib/telegram/bot/types/video_chat_scheduled.rb
 - lib/telegram/bot/types/video_chat_started.rb
 - lib/telegram/bot/types/video_note.rb
+- lib/telegram/bot/types/video_quality.rb
 - lib/telegram/bot/types/voice.rb
 - lib/telegram/bot/types/web_app_data.rb
 - lib/telegram/bot/types/web_app_info.rb
 - lib/telegram/bot/types/webhook_info.rb
 - lib/telegram/bot/types/write_access_allowed.rb
 - lib/telegram/bot/version.rb
-- rakelib/parse_schema.rake
-- rakelib/rebuild_types.rake
+- rakelib/builders/endpoints_builder.rb
+- rakelib/builders/type_builder.rb
+- rakelib/parse.rake
+- rakelib/parsers/methods_parser.rb
+- rakelib/parsers/types_parser.rb
+- rakelib/rebuild.rake
 - rakelib/templates/empty_type.erb
+- rakelib/templates/endpoints.erb
 - rakelib/templates/type.erb
 - telegram-bot-ruby.gemspec
 homepage: https://github.com/atipugin/telegram-bot
 licenses: []
 metadata:
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -357,8 +414,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.16
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Ruby wrapper for Telegram's Bot API
 test_files: []