telegrama 0.1.3 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a091a95e5e3a04865deef8b71ecf50da3f947026c0a1ad411d7d5827a5b6cc34
-  data.tar.gz: 2029971f6180699d8efba99814ed5305103f23a52507f2b0be3a452c0e8f0f9a
+  metadata.gz: dc97c0b840468fc67d8be828329aa6b99df3f3a785c9b24ccdd5f508777ea4aa
+  data.tar.gz: 3e68d1a677c64f60efdef48c93d14925ba16286388031b6585c0a328f7466f8b
 SHA512:
-  metadata.gz: '048dee76d2c78e1813abf08a19524388983edb40fee8a0f53f274d92aa37e8f032e0149cf3b0628edb24bc8e94a4d0428f96565570c2ac5ff30db52b7944ca6d'
-  data.tar.gz: 1703bd66425bb79171a64626da8d08bad982f0d1536846c9bc2b215bd5e06e6c3086fe0366003ee1f5c5319c32e5e69fe22e368025eb99f776e43ed24936456d
+  metadata.gz: 85b746d44608935c125176f96c36216963d196b7665d3f5ecbd5b0855fd168d7979ed17f772d4a64ad728cf2a935373a7009a1a9c982d7d5de8bae90b4271e62
+  data.tar.gz: 3e0df23462571c09f43df2adaa38d68dcfd70476b87d02d5f7eb68a0163d180bc592f08869c092f3936922fea7542b0e8be2fe512ec485e7cef521e9f79f5d9b

data/.simplecov

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+# SimpleCov configuration file (auto-loaded before test suite)
+# This keeps test_helper.rb clean and follows best practices
+
+SimpleCov.start do
+  # Use SimpleFormatter for terminal-only output (no HTML generation)
+  formatter SimpleCov::Formatter::SimpleFormatter
+
+  # Track coverage for the lib directory (gem source code)
+  add_filter "/test/"
+
+  # Track the lib and app directories
+  track_files "{lib,app}/**/*.rb"
+
+  # Enable branch coverage for more detailed metrics
+  enable_coverage :branch
+
+  # Set minimum coverage threshold to prevent coverage regression
+  minimum_coverage line: 80, branch: 75
+
+  # Disambiguate parallel test runs
+  command_name "Job #{ENV['TEST_ENV_NUMBER']}" if ENV['TEST_ENV_NUMBER']
+end
+
+# Print coverage summary to terminal after tests complete
+SimpleCov.at_exit do
+  SimpleCov.result.format!
+  puts "\n" + "=" * 60
+  puts "COVERAGE SUMMARY"
+  puts "=" * 60
+  puts "Line Coverage:   #{SimpleCov.result.covered_percent.round(2)}%"
+  puts "Branch Coverage: #{SimpleCov.result.coverage_statistics[:branch]&.percent&.round(2) || 'N/A'}%"
+  puts "=" * 60
+end

data/AGENTS.md

@@ -0,0 +1,5 @@
+# AGENTS.md
+
+This file provides guidance to AI Agents (like OpenAI's Codex, Cursor Agent, Claude Code, etc) when working with code in this repository.
+
+Please go ahead and read the full context for this project at `.cursor/rules/0-overview.mdc` and `.cursor/rules/1-quality.mdc` now. Also read the README for a good overview of the project.

data/Appraisals

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# Note: Rails < 7.2 is not compatible with Ruby 3.4
+# (Logger became a bundled gem in Ruby 3.4, and only Rails 7.2+ handles this)
+# See: https://stdgems.org/logger/
+
+# Test against Rails 7.2 (minimum version compatible with Ruby 3.4)
+appraise "rails-7.2" do
+  gem "rails", "~> 7.2.0"
+end
+
+# Test against Rails 8.0
+appraise "rails-8.0" do
+  gem "rails", "~> 8.0.0"
+end
+
+# Test against Rails 8.1 (latest)
+appraise "rails-8.1" do
+  gem "rails", "~> 8.1.0"
+end

data/CHANGELOG.md

@@ -1,3 +1,13 @@
+## [0.2.0] - 2026-01-17
+
+- Added Minitest test suite
+- Fixed duplicate Error class definition causing conflicts
+- Fixed missing `log_info` method
+- Fixed `parse_mode: nil` handling to properly respect explicit nil override
+- Fixed `strip_markdown` method to correctly strip markdown characters
+- Fixed `retry_delay` validation to accept float values (e.g., 0.5 seconds)
+- Added Ruby 3.5+ compatibility with `ostruct` dependency
+
 ## [0.1.3] - 2025-02-28
 
 - Added client options for retries and timeout

data/CLAUDE.md

@@ -0,0 +1,5 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+Please go ahead and read the full context for this project at `.cursor/rules/0-overview.mdc` and `.cursor/rules/1-quality.mdc` now. Also read the README for a good overview of the project.

data/README.md

@@ -1,8 +1,11 @@
-# 💬 `telegrama` – a tiny wrapper to send admin Telegram messages
+# 💬 `telegrama` – Send Telegram admin notifications in your Rails app
 
-[![Gem Version](https://badge.fury.io/rb/telegrama.svg?v=0.1.1)](https://badge.fury.io/rb/telegrama?v=0.1.1)
+[![Gem Version](https://badge.fury.io/rb/telegrama.svg)](https://badge.fury.io/rb/telegrama) [![Build Status](https://github.com/rameerez/telegrama/workflows/Tests/badge.svg)](https://github.com/rameerez/telegrama/actions)
 
-Send quick, simple admin / logging Telegram messages via a Telegram bot.
+> [!TIP]
+> **🚀 Ship your next Rails app 10x faster!** I've built **[RailsFast](https://railsfast.com/?ref=telegrama)**, a production-ready Rails boilerplate template that comes with everything you need to launch a software business in days, not weeks. Go [check it out](https://railsfast.com/?ref=telegrama)!
+
+`telegrama` lets you send quick, simple admin / logging Telegram messages via a Telegram bot.
 
 Useful for Rails developers using Telegram messages for notifications, admin alerts, errors, logs, daily summaries, and status updates, like:
 
@@ -264,7 +267,7 @@ Telegrama includes a sophisticated state machine-based markdown formatter that p
 
 The formatter is designed to be robust even with complex inputs, ensuring your messages always look great in Telegram:
 
-```ruby
+````ruby
 # Complex formatting example that works perfectly
 message = <<~MSG
   📊 *Monthly Report*
@@ -287,20 +290,18 @@ message = <<~MSG
 MSG
 
 Telegrama.send_message(message)
+````
 
 ## Testing
 
-The gem includes a comprehensive test suite.
+The gem includes a Minitest test suite.
 
 To run the tests:
 
 ```bash
-bundle install
 bundle exec rake test
 ```
 
-The test suite uses SQLite3 in-memory database and requires no additional setup.
-
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
@@ -313,4 +314,4 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/rameer
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/gemfiles/rails_7.2.gemfile

@@ -0,0 +1,19 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "irb"
+gem "rake", "~> 13.0"
+gem "rails", "~> 7.2.0"
+
+group :test do
+  gem "appraisal"
+  gem "minitest", "~> 6.0"
+  gem "minitest-mock"
+  gem "minitest-reporters", "~> 1.6"
+  gem "rack-test"
+  gem "simplecov", require: false
+  gem "webmock", "~> 3.23"
+end
+
+gemspec path: "../"

data/gemfiles/rails_8.0.gemfile

@@ -0,0 +1,19 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "irb"
+gem "rake", "~> 13.0"
+gem "rails", "~> 8.0.0"
+
+group :test do
+  gem "appraisal"
+  gem "minitest", "~> 6.0"
+  gem "minitest-mock"
+  gem "minitest-reporters", "~> 1.6"
+  gem "rack-test"
+  gem "simplecov", require: false
+  gem "webmock", "~> 3.23"
+end
+
+gemspec path: "../"

data/gemfiles/rails_8.1.gemfile

@@ -0,0 +1,19 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "irb"
+gem "rake", "~> 13.0"
+gem "rails", "~> 8.1.0"
+
+group :test do
+  gem "appraisal"
+  gem "minitest", "~> 6.0"
+  gem "minitest-mock"
+  gem "minitest-reporters", "~> 1.6"
+  gem "rack-test"
+  gem "simplecov", require: false
+  gem "webmock", "~> 3.23"
+end
+
+gemspec path: "../"

data/lib/telegrama/client.rb

@@ -21,7 +21,8 @@ module Telegrama
       client_opts = client_opts.merge(@config)
 
       # Default to MarkdownV2 parse mode unless explicitly overridden
-      parse_mode = options[:parse_mode] || Telegrama.configuration.default_parse_mode
+      # Use key? to allow explicit nil override (for plain text without formatting)
+      parse_mode = options.key?(:parse_mode) ? options[:parse_mode] : Telegrama.configuration.default_parse_mode
 
       # Allow runtime formatting options, merging with configured defaults
       formatting_opts = options.delete(:formatting) || {}
@@ -159,6 +160,4 @@ module Telegrama
       defined?(Rails) && Rails.respond_to?(:logger) ? Rails.logger : Logger.new($stdout)
     end
   end
-
-  class Error < StandardError; end
 end

data/lib/telegrama/configuration.rb

@@ -134,7 +134,8 @@ module Telegrama
         raise ArgumentError, "Telegrama configuration error: client_options must be a hash."
       end
 
-      [:timeout, :retry_count, :retry_delay].each do |key|
+      # timeout and retry_count must be positive integers
+      [:timeout, :retry_count].each do |key|
         if client_options.key?(key)
           val = client_options[key]
           unless val.is_a?(Integer) && val.positive?
@@ -142,6 +143,14 @@ module Telegrama
           end
         end
       end
+
+      # retry_delay can be a positive integer or float (e.g., 0.5 seconds)
+      if client_options.key?(:retry_delay)
+        val = client_options[:retry_delay]
+        unless val.is_a?(Numeric) && val.positive?
+          raise ArgumentError, "Telegrama configuration error: client_options[:retry_delay] must be a positive number."
+        end
+      end
     end
   end
 end

data/lib/telegrama/formatter.rb

@@ -473,8 +473,34 @@ module Telegrama
     # @param text [String] The text with markdown formatting
     # @return [String] The text with markdown formatting removed
     def self.strip_markdown(text)
-      # Remove all markdown syntax for plain text delivery
-      text.gsub(/[*_~`]|\[.*?\]\(.*?\)/, '')
+      result = text.dup
+
+      # Remove markdown links [text](url) -> text
+      result.gsub!(/\[([^\]]*)\]\([^)]*\)/, '\1')
+
+      # Remove triple backtick code blocks (preserve content)
+      result.gsub!(/```[a-z]*\n?(.*?)```/m, '\1')
+
+      # Remove inline code backticks (preserve content)
+      result.gsub!(/`([^`]*)`/, '\1')
+
+      # Remove bold formatting (both ** and *)
+      result.gsub!(/\*\*([^*]*)\*\*/, '\1')
+      result.gsub!(/\*([^*]*)\*/, '\1')
+
+      # Remove italic formatting (both __ and _)
+      result.gsub!(/__([^_]*)__/, '\1')
+      result.gsub!(/(?<![\\])_([^_]*)_/, '\1')
+
+      # Remove strikethrough
+      result.gsub!(/~~([^~]*)~~/, '\1')
+      result.gsub!(/~([^~]*)~/, '\1')
+
+      # Remove any remaining unmatched formatting characters at word boundaries
+      # but preserve them in the middle of words (like file_name)
+      result.gsub!(/(?<=\s)[*_~`]+|[*_~`]+(?=\s|$)/, '')
+
+      result
     end
 
     # Convert HTML to Telegram MarkdownV2 format

data/lib/telegrama/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Telegrama
-  VERSION = "0.1.3"
+  VERSION = "0.2.0"
 end

data/lib/telegrama.rb

@@ -40,11 +40,20 @@ module Telegrama
 
     # Helper method for logging errors
     def log_error(message)
-      if defined?(Rails)
+      if defined?(Rails) && Rails.respond_to?(:logger)
         Rails.logger.error("[Telegrama] #{message}")
       else
         warn("[Telegrama] #{message}")
       end
     end
+
+    # Helper method for logging info messages
+    def log_info(message)
+      if defined?(Rails) && Rails.respond_to?(:logger)
+        Rails.logger.info("[Telegrama] #{message}")
+      else
+        puts("[Telegrama] #{message}")
+      end
+    end
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: telegrama
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.0
 platform: ruby
 authors:
 - Javi R
 bindir: exe
 cert_chain: []
-date: 2025-02-28 00:00:00.000000000 Z
+date: 2026-01-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -23,6 +23,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 6.0.0
+- !ruby/object:Gem::Dependency
+  name: ostruct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.5'
 description: Send quick, simple admin / logging Telegram messages via a Telegram bot.
   Useful for Rails developers using Telegram messages for notifications, admin alerts,
   daily summaries, and status updates. Parses and escapes Markdown for beautifully
@@ -34,10 +48,17 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".simplecov"
+- AGENTS.md
+- Appraisals
 - CHANGELOG.md
+- CLAUDE.md
 - LICENSE.txt
 - README.md
 - Rakefile
+- gemfiles/rails_7.2.gemfile
+- gemfiles/rails_8.0.gemfile
+- gemfiles/rails_8.1.gemfile
 - lib/telegrama.rb
 - lib/telegrama/client.rb
 - lib/telegrama/configuration.rb