telepost 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1ce7fcf4f1c91fc69b689ecc87f50b6e73148288151135c0da1c1bbd7bdae8ff
-  data.tar.gz: 4b4daa207bf50cc80e85a71f2ce646c1915d41026b8f04ff8bad7e5ec9f9f663
+  metadata.gz: 847510fbfea002fc65ee0a20dbc39dd2c5ede53aab590c5a8aa2ed66f2bdc50e
+  data.tar.gz: '086d01f73bff093ef51dbbcb67757d48d21a37211131ca6522e5b2f25901345b'
 SHA512:
-  metadata.gz: 9e34a5b2bf917792c5ace84e188e1403b59b3dfd6ac018f7cee1cc676870ad78f70c2420bcd8eadc6064cd15caadcfdacbc4f66376367e4212dd498dee37f5ec
-  data.tar.gz: 9c22f5ec9c6c372a611dcd5f468a74d46a0f2b191e87626b3945764fd59953a1b8bb92d9aaef8cb54850e0a43baa582e88bcf02c1ab97fd1dcb584e25a5f0760
+  metadata.gz: 77b5815fcaa702a9a0c422b7633e4992cb7824d79e0c0eb0a77ce03bd4e58464463eab5a3a154e47c4aad0704601d9fc7fa43c1c3fb2656401e88d1d4bd4df04
+  data.tar.gz: 4e9334873a9a5e0e9e7c92828b657fbc00b9f822e6c471f6c57bc7b582e3a54b6c6dde6a3c332de43614cffe7c31485678f8206f8fff7ee185ba9c6dc1f65142

data/Gemfile

@@ -10,6 +10,7 @@ gem 'minitest', '~>6.0', require: false
 gem 'minitest-reporters', '~>1.7', require: false
 gem 'rake', '~>13.2', require: false
 gem 'rubocop', '~>1.71', require: false
+gem 'rubocop-elegant', '>=0.0.20', require: false
 gem 'rubocop-minitest', '~>0.38', require: false
 gem 'rubocop-performance', '~>1.25', require: false
 gem 'rubocop-rake', '~>0.7', require: false

data/Gemfile.lock

@@ -11,25 +11,25 @@ GEM
       public_suffix (>= 2.0.2, < 8.0)
     ansi (1.6.0)
     ast (2.4.3)
-    bigdecimal (4.1.0)
+    bigdecimal (4.1.2)
     builder (3.3.0)
-    concurrent-ruby (1.3.5)
+    concurrent-ruby (1.3.6)
     crack (1.0.1)
       bigdecimal
       rexml
     docile (1.4.1)
     drb (2.2.3)
-    dry-core (1.1.0)
+    dry-core (1.2.0)
       concurrent-ruby (~> 1.0)
       logger
       zeitwerk (~> 2.6)
-    dry-inflector (1.2.0)
+    dry-inflector (1.3.1)
     dry-logic (1.6.0)
       bigdecimal
       concurrent-ruby (~> 1.0)
       dry-core (~> 1.1)
       zeitwerk (~> 2.6)
-    dry-struct (1.8.0)
+    dry-struct (1.8.1)
       dry-core (~> 1.1)
       dry-types (~> 1.8, >= 1.8.2)
       ice_nine (~> 0.11)
@@ -41,26 +41,21 @@ GEM
       dry-inflector (~> 1.0)
       dry-logic (~> 1.4)
       zeitwerk (~> 2.6)
-    faraday (2.13.2)
+    faraday (2.14.2)
       faraday-net_http (>= 2.0, < 3.5)
       json
       logger
-    faraday-multipart (1.1.1)
+    faraday-multipart (1.2.0)
       multipart-post (~> 2.0)
-    faraday-net_http (3.4.1)
-      net-http (>= 0.5.0)
+    faraday-net_http (3.4.3)
+      net-http (~> 0.5)
     hashdiff (1.2.1)
     ice_nine (0.11.2)
-    json (2.19.2)
-    json-schema (6.2.0)
-      addressable (~> 2.8)
-      bigdecimal (>= 3.1, < 5)
+    json (2.19.5)
     language_server-protocol (3.17.0.5)
     lint_roller (1.1.0)
     logger (1.7.0)
-    mcp (0.9.2)
-      json-schema (>= 4.1)
-    minitest (6.0.5)
+    minitest (6.0.6)
       drb (~> 2.0)
       prism (~> 1.5)
     minitest-reporters (1.8.0)
@@ -69,10 +64,10 @@ GEM
       minitest (>= 5.0, < 7)
       ruby-progressbar
     multipart-post (2.4.1)
-    net-http (0.6.0)
-      uri
-    parallel (1.27.0)
-    parser (3.3.10.2)
+    net-http (0.9.1)
+      uri (>= 0.11.1)
+    parallel (2.1.0)
+    parser (3.3.11.1)
       ast (~> 2.4.1)
       racc
     prism (1.9.0)
@@ -80,14 +75,13 @@ GEM
     racc (1.8.1)
     rainbow (3.1.1)
     rake (13.4.2)
-    regexp_parser (2.11.3)
+    regexp_parser (2.12.0)
     rexml (3.4.4)
-    rubocop (1.85.1)
+    rubocop (1.86.2)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
-      mcp (~> 0.6)
-      parallel (~> 1.10)
+      parallel (>= 1.10)
       parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 2.9.3, < 3.0)
@@ -97,6 +91,9 @@ GEM
     rubocop-ast (1.49.1)
       parser (>= 3.3.7.2)
       prism (~> 1.7)
+    rubocop-elegant (0.5.1)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.75)
     rubocop-minitest (0.39.1)
       lint_roller (~> 1.1)
       rubocop (>= 1.75.0, < 2.0)
@@ -126,13 +123,13 @@ GEM
     unicode-display_width (3.2.0)
       unicode-emoji (~> 4.1)
     unicode-emoji (4.2.0)
-    uri (1.0.4)
+    uri (1.1.1)
     webmock (3.26.2)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
-    yard (0.9.43)
-    zeitwerk (2.7.3)
+    yard (0.9.44)
+    zeitwerk (2.8.2)
 
 PLATFORMS
   arm64-darwin-22
@@ -146,6 +143,7 @@ DEPENDENCIES
   minitest-reporters (~> 1.7)
   rake (~> 13.2)
   rubocop (~> 1.71)
+  rubocop-elegant (>= 0.0.20)
   rubocop-minitest (~> 0.38)
   rubocop-performance (~> 1.25)
   rubocop-rake (~> 0.7)

data/README.md

@@ -37,7 +37,7 @@ tp.post(12345, 'How are you?', 'How are you doing?')
 All lines you provide to the `post()` method will be concatenated
 with a space between them.
 
-Or you can pre-configure it to talk to certain list of chats.
+Or you can pre-configure it to talk to a certain list of chats.
 Your bot has to be an admin of the channel, in order to post there.
 Here is how you "spam":
 
@@ -55,6 +55,16 @@ tp = Telepost.new('..token..')
 tp.attach(12345, '/tmp/dump.sql', caption: 'Today is dump')
 ```
 
+You can also pass an array of files, to post them all as a single
+grouped message (a Telegram "album"). Files with an image extension
+are sent as photos, the rest as documents, and the `caption:` is
+shown once, on the first item:
+
+```ruby
+tp = Telepost.new('..token..')
+tp.attach(12345, ['/tmp/a.png', '/tmp/b.png'], caption: 'Two shots')
+```
+
 That's it.
 
 ## How to contribute

data/Rakefile

@@ -3,9 +3,9 @@
 # SPDX-FileCopyrightText: Copyright (c) 2018-2026 Yegor Bugayenko
 # SPDX-License-Identifier: MIT
 
-require 'rubygems'
 require 'rake'
 require 'rake/clean'
+require 'rubygems'
 
 CLEAN = FileList['coverage']
 

data/lib/telepost.rb

@@ -31,9 +31,7 @@ class Telepost
       @sent = []
     end
 
-    def run
-      # Nothing to do here
-    end
+    def run; end
 
     def spam(*lines)
       post(0, lines)
@@ -44,9 +42,22 @@ class Telepost
     end
 
     def attach(chat, file, caption: nil)
-      path = file.is_a?(String) ? file : file.path
-      tail = caption.nil? ? '' : " caption=#{caption}"
-      @sent << "#{chat}: [attach:#{File.basename(path)}#{tail}]"
+      @sent <<
+        if file.is_a?(Array)
+          "#{chat}: [attach-group:#{names(file)}#{cap(caption)}]"
+        else
+          "#{chat}: [attach:#{names([file])}#{cap(caption)}]"
+        end
+    end
+
+    private
+
+    def names(files)
+      files.map { |f| File.basename(f.is_a?(String) ? f : f.path) }.join(',')
+    end
+
+    def cap(caption)
+      caption.nil? ? '' : " caption=#{caption}"
     end
   end
 
@@ -55,9 +66,6 @@ class Telepost
   # @note Raised when message posting fails
   class CantPost < StandardError; end
 
-  # To make it possible to get the client.
-  #
-  # @return [Telegram::Bot::Client] The Telegram bot client
   attr_reader :client
 
   # Makes a new object. To obtain a token you should talk
@@ -78,8 +86,10 @@ class Telepost
   # @return [void]
   # @raise [RuntimeError] If no block is given
   def run
-    raise 'Block must be given' unless block_given?
+    raise(RuntimeError, 'Block must be given') unless block_given?
     @bot.listen do |message|
+      next unless message.respond_to?(:chat)
+      next if message.chat.nil?
       yield(message.chat.id, message.respond_to?(:text) ? message.text : '')
     end
   rescue Net::OpenTimeout
@@ -108,35 +118,66 @@ class Telepost
   # @param lines [Array<String>] Message lines to send
   # @return [Telegram::Bot::Types::Message] The sent message object
   def post(chat, *lines, parse_mode: 'Markdown')
-    @bot.api.send_message(
-      chat_id: chat,
-      parse_mode:,
-      disable_web_page_preview: true,
-      text: lines.join(' ')
-    )
+    @bot.api.send_message(chat_id: chat, parse_mode:, disable_web_page_preview: true, text: lines.join(' '))
   end
 
   # Attach a file (as a Telegram document) to the chat. The file
   # argument can either be a path (String) or an open IO/File. The
   # filename shown in Telegram comes from the basename of the path.
   #
+  # When +file+ is an +Array+, all of its items are posted as a single
+  # grouped message (a Telegram "album") via +sendMediaGroup+. Items
+  # with an image extension are wrapped in +InputMediaPhoto+, the rest
+  # in +InputMediaDocument+. The +caption+ is attached to the first
+  # item only, so the album shows one caption.
+  #
   # @param chat [Integer, String] Chat ID or channel name
-  # @param file [String, File, IO] Path to the file or an open IO
+  # @param file [String, File, IO, Array] File (or array of files) to attach
   # @param caption [String, nil] Optional caption for the attachment
   # @param parse_mode [String] Parse mode used for the caption
   # @return [Telegram::Bot::Types::Message] The sent message object
   def attach(chat, file, caption: nil, parse_mode: 'Markdown')
-    document =
-      if file.is_a?(String)
-        Faraday::UploadIO.new(file, 'application/octet-stream', File.basename(file))
-      else
-        file
+    return album(chat, file, caption:, parse_mode:) if file.is_a?(Array)
+    io = upload(file)
+    @bot.api.send_document(chat_id: chat, document: io, caption:, parse_mode:)
+  ensure
+    io.close if file.is_a?(String) && io.respond_to?(:close)
+  end
+
+  PHOTO_EXTENSIONS = %w[.jpg .jpeg .png .gif .webp].freeze
+
+  private
+
+  def album(chat, files, caption: nil, parse_mode: 'Markdown')
+    opened = []
+    params = { chat_id: chat }
+    params[:media] =
+      files.each_with_index.map do |file, idx|
+        io = upload(file)
+        opened << io if file.is_a?(String)
+        params[:"file#{idx}"] = io
+        attrs = { media: "attach://file#{idx}" }
+        if idx.zero? && !caption.nil?
+          attrs[:caption] = caption
+          attrs[:parse_mode] = parse_mode
+        end
+        klass(file).new(**attrs)
       end
-    @bot.api.send_document(
-      chat_id: chat,
-      document:,
-      caption:,
-      parse_mode:
-    )
+    @bot.api.send_media_group(**params)
+  ensure
+    opened.each(&:close)
+  end
+
+  def upload(file)
+    return file unless file.is_a?(String)
+    Faraday::UploadIO.new(file, 'application/octet-stream', File.basename(file))
+  end
+
+  def klass(file)
+    photo?(file) ? Telegram::Bot::Types::InputMediaPhoto : Telegram::Bot::Types::InputMediaDocument
+  end
+
+  def photo?(file)
+    PHOTO_EXTENSIONS.include?(File.extname(file.is_a?(String) ? file : file.path).downcase)
   end
 end

data/telepost.gemspec

@@ -6,10 +6,10 @@
 require 'English'
 
 Gem::Specification.new do |s|
-  s.required_rubygems_version = Gem::Requirement.new('>= 0') if s.respond_to? :required_rubygems_version=
+  s.required_rubygems_version = Gem::Requirement.new('>= 0') if s.respond_to?(:required_rubygems_version=)
   s.required_ruby_version = '>=3.2'
   s.name = 'telepost'
-  s.version = '0.8.0'
+  s.version = '0.9.0'
   s.license = 'MIT'
   s.summary = 'Simple Telegram posting Ruby gem'
   s.description = 'Simple Telegram posting Ruby gem'
@@ -19,6 +19,6 @@ Gem::Specification.new do |s|
   s.files = `git ls-files | grep -v -E '^(test/|\\.|renovate)'`.split($RS)
   s.rdoc_options = ['--charset=UTF-8']
   s.extra_rdoc_files = ['README.md']
-  s.add_dependency 'telegram-bot-ruby', '~> 1.0'
+  s.add_dependency('telegram-bot-ruby', '~> 1.0')
   s.metadata['rubygems_mfa_required'] = 'true'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: telepost
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Yegor Bugayenko