RubyGems - telegem - Versions diffs - 2.1.0 → 3.0.1 - Mend

telegem 2.1.0 → 3.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (34) hide show

checksums.yaml +4 -4
data/Readme.md +2 -2
data/Starts_HallofFame.md +65 -0
data/Test-Projects/bot.md +145 -0
data/Test-Projects/bot1.rb +91 -0
data/bin/telegem-ssl +44 -0
data/docs-src/Bot-registration_.PNG +0 -0
data/docs-src/bot.md +349 -180
data/docs-src/ctx.md +399 -0
data/docs-src/webhook.md +341 -0
data/lib/api/client.rb +72 -27
data/lib/core/bot.rb +81 -149
data/lib/telegem.rb +1 -1
data/lib/webhook/server.rb +149 -290
data/public/index.html +481 -0
metadata +32 -24
data/Test-Projects/Movie-tracker-bot/Gemfile +0 -2
data/Test-Projects/Movie-tracker-bot/bot.rb +0 -62
data/Test-Projects/Movie-tracker-bot/handlers/.gitkeep +0 -0
data/Test-Projects/Movie-tracker-bot/handlers/add_1_.rb +0 -160
data/Test-Projects/Movie-tracker-bot/handlers/add_2_.rb +0 -139
data/Test-Projects/Movie-tracker-bot/handlers/premium.rb +0 -13
data/Test-Projects/Movie-tracker-bot/handlers/report.rb +0 -31
data/Test-Projects/Movie-tracker-bot/handlers/search.rb +0 -150
data/Test-Projects/Movie-tracker-bot/handlers/sponsor.rb +0 -14
data/Test-Projects/Movie-tracker-bot/handlers/start.rb +0 -48
data/Test-Projects/Movie-tracker-bot/handlers/watch.rb +0 -210
data/Test-Projects/Test-submitted-by-marvel/.gitkeep +0 -0
data/Test-Projects/Test-submitted-by-marvel/Marvel-bot.md +0 -3
data/Test-Projects/bot_test1.rb +0 -75
data/Test-Projects/pizza_test_bot_guide.md +0 -163
data/docs-src/understanding-ctx.md +0 -581
/data/{Test-Projects → bin}/.gitkeep +0 -0
/data/{Test-Projects/Movie-tracker-bot → public}/.gitkeep +0 -0

data/public/index.html ADDED Viewed

@@ -0,0 +1,481 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Telegem Docs - Telegram Bot Framework for Ruby</title>
+    <style>
+        * {
+            margin: 0;
+            padding: 0;
+            box-sizing: border-box;
+        }
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+            line-height: 1.6;
+            color: #1a1a1a;
+            background: #fafafa;
+            padding: 0;
+        }
+        .container {
+            max-width: 900px;
+            margin: 0 auto;
+            padding: 2rem 1.5rem;
+        }
+        .header {
+            padding-bottom: 2rem;
+            margin-bottom: 2rem;
+            border-bottom: 1px solid #eaeaea;
+        }
+        .header h1 {
+            font-size: 2.2rem;
+            color: #2c3e50;
+            margin-bottom: 0.25rem;
+        }
+        .tagline {
+            font-size: 1.1rem;
+            color: #7f8c8d;
+            margin-bottom: 1.5rem;
+        }
+        .stats {
+            display: flex;
+            gap: 1.5rem;
+            margin-top: 1rem;
+        }
+        .stat {
+            background: white;
+            padding: 0.75rem 1rem;
+            border-radius: 6px;
+            border: 1px solid #eaeaea;
+            min-width: 120px;
+        }
+        .stat-label {
+            font-size: 0.8rem;
+            color: #95a5a6;
+            text-transform: uppercase;
+            letter-spacing: 0.5px;
+            margin-bottom: 0.25rem;
+        }
+        .stat-value {
+            font-size: 1.1rem;
+            font-weight: 600;
+            color: #2c3e50;
+        }
+        .doc-nav {
+            display: flex;
+            gap: 0.5rem;
+            margin: 2rem 0;
+            flex-wrap: wrap;
+        }
+        .nav-btn {
+            background: white;
+            border: 1px solid #ddd;
+            padding: 0.5rem 1rem;
+            border-radius: 4px;
+            font-size: 0.9rem;
+            color: #555;
+            cursor: pointer;
+            transition: all 0.2s;
+        }
+        .nav-btn:hover {
+            border-color: #3498db;
+            color: #3498db;
+        }
+        .nav-btn.active {
+            background: #3498db;
+            border-color: #3498db;
+            color: white;
+        }
+        .doc-section {
+            background: white;
+            border-radius: 8px;
+            padding: 2rem;
+            margin-bottom: 1.5rem;
+            border: 1px solid #eaeaea;
+        }
+        .doc-section h2 {
+            font-size: 1.5rem;
+            color: #2c3e50;
+            margin-bottom: 1rem;
+            padding-bottom: 0.5rem;
+            border-bottom: 2px solid #f0f0f0;
+        }
+        .doc-section h3 {
+            font-size: 1.1rem;
+            color: #34495e;
+            margin: 1.5rem 0 0.75rem;
+        }
+        .doc-section p {
+            margin-bottom: 1rem;
+            color: #555;
+        }
+        .method-list {
+            list-style: none;
+            margin: 1rem 0;
+        }
+        .method-item {
+            margin-bottom: 0.75rem;
+            padding: 0.75rem;
+            background: #f8f9fa;
+            border-radius: 4px;
+            border-left: 3px solid #3498db;
+        }
+        .method-name {
+            font-family: 'SF Mono', Monaco, Consolas, monospace;
+            font-weight: 600;
+            color: #2c3e50;
+            margin-bottom: 0.25rem;
+        }
+        .method-desc {
+            color: #7f8c8d;
+            font-size: 0.9rem;
+        }
+        .code-block {
+            background: #2c3e50;
+            color: #ecf0f1;
+            padding: 1.25rem;
+            border-radius: 6px;
+            margin: 1rem 0;
+            font-family: 'SF Mono', Monaco, Consolas, monospace;
+            font-size: 0.9rem;
+            line-height: 1.5;
+            overflow-x: auto;
+        }
+        .code-block::selection {
+            background: #3498db;
+        }
+        .links {
+            display: flex;
+            gap: 1rem;
+            margin-top: 2rem;
+            padding-top: 1.5rem;
+            border-top: 1px solid #eaeaea;
+            flex-wrap: wrap;
+        }
+        .link-btn {
+            display: inline-flex;
+            align-items: center;
+            gap: 0.5rem;
+            padding: 0.6rem 1.2rem;
+            background: #3498db;
+            color: white;
+            text-decoration: none;
+            border-radius: 4px;
+            font-size: 0.9rem;
+            transition: background 0.2s;
+        }
+        .link-btn:hover {
+            background: #2980b9;
+        }
+        .link-btn.secondary {
+            background: white;
+            color: #555;
+            border: 1px solid #ddd;
+        }
+        .link-btn.secondary:hover {
+            background: #f8f9fa;
+        }
+        .note {
+            background: #f8f9fa;
+            padding: 1rem;
+            border-left: 3px solid #3498db;
+            margin: 1rem 0;
+            border-radius: 0 4px 4px 0;
+        }
+        @media (max-width: 768px) {
+            .container {
+                padding: 1rem;
+            }
+            .doc-section {
+                padding: 1.5rem;
+            }
+            .stats {
+                flex-direction: column;
+                gap: 0.75rem;
+            }
+            .stat {
+                min-width: auto;
+            }
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <header class="header">
+            <div>
+                <h1>Telegem</h1>
+                <p class="tagline">Telegram Bot Framework for Ruby</p>
+            </div>
+            <div class="stats">
+                <div class="stat">
+                    <div class="stat-label">Version</div>
+                    <div class="stat-value" id="gem-version">Loading...</div>
+                </div>
+                <div class="stat">
+                    <div class="stat-label">Downloads</div>
+                    <div class="stat-value" id="gem-downloads">Loading...</div>
+                </div>
+            </div>
+            <div class="doc-nav">
+                <button class="nav-btn active" onclick="showDoc('quickstart')">Quick Start</button>
+                <button class="nav-btn" onclick="showDoc('ctx')">Context API</button>
+                <button class="nav-btn" onclick="showDoc('bot')">Bot API</button>
+                <button class="nav-btn" onclick="showDoc('scenes')">Scenes</button>
+                <button class="nav-btn" onclick="showDoc('webhook')">Webhook</button>
+            </div>
+        </header>
+        <!-- Quick Start -->
+        <section id="quickstart-doc" class="doc-section">
+            <h2>Quick Start</h2>
+            <h3>Installation</h3>
+            <div class="code-block">
+# Add to Gemfile
+gem 'telegem'
+# Or install directly
+$ gem install telegem
+            </div>
+            <h3>Basic Usage</h3>
+            <div class="code-block">
+require 'telegem'
+bot = Telegem.new("YOUR_BOT_TOKEN")
+bot.command('start') do |ctx|
+  ctx.reply("Welcome to Telegem!")
+end
+bot.command('help') do |ctx|
+  ctx.reply("Available commands: /start, /help")
+end
+# Start the bot
+bot.start_polling
+            </div>
+            <div class="note">
+                Replace <code>YOUR_BOT_TOKEN</code> with your actual Telegram Bot token from @BotFather
+            </div>
+            <div class="links">
+                <a href="https://rubygems.org/gems/telegem" class="link-btn">📦 View on RubyGems</a>
+                <a href="https://gitlab.com/ruby-telegem/telegem" class="link-btn secondary">🐱 GitLab Repository</a>
+            </div>
+        </section>
+        <!-- ctx API -->
+        <section id="ctx-doc" class="doc-section" style="display: none;">
+            <h2>Context API</h2>
+            <p>The context object provides access to the current update and response methods.</p>
+            <h3>Properties</h3>
+            <ul class="method-list">
+                <li class="method-item">
+                    <div class="method-name">ctx.message</div>
+                    <div class="method-desc">Current message object</div>
+                </li>
+                <li class="method-item">
+                    <div class="method-name">ctx.from</div>
+                    <div class="method-desc">User who sent the message</div>
+                </li>
+                <li class="method-item">
+                    <div class="method-name">ctx.chat</div>
+                    <div class="method-desc">Chat information</div>
+                </li>
+                <li class="method-item">
+                    <div class="method-name">ctx.session</div>
+                    <div class="method-desc">Persistent user storage</div>
+                </li>
+            </ul>
+            <h3>Methods</h3>
+            <div class="code-block">
+# Send message
+ctx.reply("Hello!")
+# Send photo
+ctx.photo("photo.jpg", caption: "My photo")
+# Edit message
+ctx.edit_message_text("Updated text")
+# Delete message
+ctx.delete_message(message_id)
+            </div>
+            <div class="links">
+                <a href="https://gitlab.com/ruby-telegem/telegem/-/tree/main/docs/context.md" class="link-btn">📄 Full Context Docs</a>
+            </div>
+        </section>
+        <!-- Bot API -->
+        <section id="bot-doc" class="doc-section" style="display: none;">
+            <h2>Bot API</h2>
+            <p>Configure handlers and control bot lifecycle.</p>
+            <div class="code-block">
+# Handle commands
+bot.command('start') { |ctx| ctx.reply("Welcome") }
+# Handle text patterns
+bot.hears(/hello/i) { |ctx| ctx.reply("Hi there!") }
+# Handle specific update types
+bot.on(:photo) { |ctx| ctx.reply("Nice photo!") }
+bot.on(:callback_query) { |ctx| ctx.answer_callback_query }
+# Start bot
+bot.start_polling
+# or
+bot.webhook.run
+            </div>
+            <div class="links">
+                <a href="https://gitlab.com/ruby-telegem/telegem/-/tree/main/docs/bot.md" class="link-btn">📄 Bot API Reference</a>
+            </div>
+        </section>
+        <!-- Scenes -->
+        <section id="scenes-doc" class="doc-section" style="display: none;">
+            <h2>Scenes</h2>
+            <p>Multi-step conversations for complex interactions.</p>
+            <div class="code-block">
+bot.scene :registration do
+  step :ask_name do |ctx|
+    ctx.reply("What is your name?")
+  end
+  step :save_name do |ctx|
+    ctx.session[:name] = ctx.message.text
+    ctx.reply("Hello #{ctx.session[:name]}!")
+    ctx.leave_scene
+  end
+end
+# Enter scene
+bot.command('register') { |ctx| ctx.enter_scene(:registration) }
+            </div>
+            <div class="links">
+                <a href="https://gitlab.com/ruby-telegem/telegem/-/tree/main/docs/scenes.md" class="link-btn">📄 Scenes Guide</a>
+            </div>
+        </section>
+        <!-- Webhook -->
+        <section id="webhook-doc" class="doc-section" style="display: none;">
+            <h2>Webhook Deployment</h2>
+            <p>Production deployment with webhooks.</p>
+            <div class="code-block">
+# Production setup
+bot = Telegem.new("TOKEN")
+# Configure webhook
+bot.webhook(
+  url: 'https://your-domain.com/webhook',
+  port: 3000
+).run
+# For cloud platforms
+bot.webhook.run # Auto-detects platform
+            </div>
+            <div class="note">
+                Webhook mode is recommended for production. Uses less resources than polling.
+            </div>
+            <div class="links">
+                <a href="https://gitlab.com/ruby-telegem/telegem/-/tree/main/docs/deployment.md" class="link-btn">📄 Deployment Guide</a>
+            </div>
+        </section>
+        <!-- Footer -->
+        <div class="doc-section">
+            <div class="links">
+                <a href="https://gitlab.com/ruby-telegem/telegem" class="link-btn">🏠 Main Repository</a>
+                <a href="https://rubygems.org/gems/telegem" class="link-btn secondary">💎 RubyGems</a>
+                <a href="https://gitlab.com/ruby-telegem/telegem/-/issues" class="link-btn secondary">🐛 Issue Tracker</a>
+            </div>
+        </div>
+    </div>
+    <script>
+        async function fetchGemStats() {
+            try {
+                const response = await fetch('https://rubygems.org/api/v1/gems/telegem.json');
+                const data = await response.json();
+                if (data.version) {
+                    document.getElementById('gem-version').textContent = `v${data.version}`;
+                }
+                if (data.downloads) {
+                    document.getElementById('gem-downloads').textContent =
+                        data.downloads.toLocaleString();
+                }
+            } catch (error) {
+                document.getElementById('gem-version').textContent = 'v3.0.0';
+                document.getElementById('gem-downloads').textContent = 'N/A';
+            }
+        }
+        function showDoc(section) {
+            document.querySelectorAll('.doc-section').forEach(el => {
+                el.style.display = 'none';
+            });
+            document.getElementById(`${section}-doc`).style.display = 'block';
+            document.querySelectorAll('.nav-btn').forEach(btn => {
+                btn.classList.remove('active');
+            });
+            event.target.classList.add('active');
+            window.scrollTo(0, 0);
+        }
+        document.addEventListener('DOMContentLoaded', () => {
+            fetchGemStats();
+        });
+    </script>
+</body>
+</html>

metadata CHANGED Viewed

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: telegem
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 3.0.1
 platform: ruby
 authors:
 - sick_phantom
-bindir: exe
+bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
@@ -77,6 +77,20 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: async
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -153,7 +167,8 @@ description: |
   and a clean DSL. Perfect for building scalable Telegram bots.
 email:
 - ynwghosted@icloud.com
-executables: []
+executables:
+- telegem-ssl
 extensions: []
 extra_rdoc_files: []
 files:
@@ -163,31 +178,20 @@ files:
 - Gemfile.lock
 - LICENSE
 - Readme.md
-- Test-Projects/.gitkeep
-- Test-Projects/Movie-tracker-bot/.gitkeep
-- Test-Projects/Movie-tracker-bot/Gemfile
-- Test-Projects/Movie-tracker-bot/bot.rb
-- Test-Projects/Movie-tracker-bot/handlers/.gitkeep
-- Test-Projects/Movie-tracker-bot/handlers/add_1_.rb
-- Test-Projects/Movie-tracker-bot/handlers/add_2_.rb
-- Test-Projects/Movie-tracker-bot/handlers/premium.rb
-- Test-Projects/Movie-tracker-bot/handlers/report.rb
-- Test-Projects/Movie-tracker-bot/handlers/search.rb
-- Test-Projects/Movie-tracker-bot/handlers/sponsor.rb
-- Test-Projects/Movie-tracker-bot/handlers/start.rb
-- Test-Projects/Movie-tracker-bot/handlers/watch.rb
-- Test-Projects/Test-submitted-by-marvel/.gitkeep
-- Test-Projects/Test-submitted-by-marvel/Marvel-bot.md
-- Test-Projects/bot_test1.rb
-- Test-Projects/pizza_test_bot_guide.md
+- Starts_HallofFame.md
+- Test-Projects/bot.md
+- Test-Projects/bot1.rb
+- bin/.gitkeep
+- bin/telegem-ssl
 - docs-src/.gitkeep
 - docs-src/Bot-registration_.PNG
 - docs-src/bot.md
 - docs-src/context|ctx|.md
+- docs-src/ctx.md
 - docs-src/getting-started.md
 - docs-src/keyboard_inline.md
 - docs-src/scene.md
-- docs-src/understanding-ctx.md
+- docs-src/webhook.md
 - lib/api/client.rb
 - lib/api/types.rb
 - lib/core/bot.rb
@@ -201,6 +205,8 @@ files:
 - lib/telegem.rb
 - lib/webhook/.gitkeep
 - lib/webhook/server.rb
+- public/.gitkeep
+- public/index.html
 homepage: https://gitlab.com/ruby-telegem/telegem
 licenses:
 - MIT
@@ -211,8 +217,10 @@ metadata:
   bug_tracker_uri: https://gitlab.com/ruby-telegem/telegem/-/issues
   documentation_uri: https://gitlab.com/ruby-telegem/telegem/-/tree/main/docs-src?ref_type=heads
   rubygems_mfa_required: 'false'
-post_install_message: "Thanks for installing Telegem 2.1.0!\nDocumentation: https://gitlab.com/ruby-telegem/telegem\nHappy
-  bot building! \U0001F916\n"
+post_install_message: "Thanks for installing Telegem 3.0.1!\n\n\U0001F4DA Documentation:
+  https://gitlab.com/ruby-telegem/telegem\n\n\U0001F510 For SSL Webhooks:\nRun: telegem-ssl
+  your-domain.com\nThis sets up Let's Encrypt certificates automatically.\n\n\U0001F916
+  Happy bot building!\n"
 rdoc_options: []
 require_paths:
 - lib
@@ -227,7 +235,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.6.7
 specification_version: 4
 summary: Modern, fast Telegram Bot Framework for Ruby
 test_files: []

data/Test-Projects/Movie-tracker-bot/Gemfile DELETED Viewed

	@@ -1,2 +0,0 @@
1	-
2	- ruby "3.1.0"

data/Test-Projects/Movie-tracker-bot/bot.rb DELETED Viewed

@@ -1,62 +0,0 @@
-require 'json'
-require 'telegem'
-require 'sqlite3'
-require 'fileutils'
-require_relative './handlers/start'
-require_relative './handlers/add_1_'
-require_relative './handlers/premium'
-require_relative './handlers/add_2_'
-require_relative './handlers/sponsor'
-require_relative './handlers/watch'
-require_relative './handlers/report'
-require_relative './handlers/search'
-bot_token = ENV['BOT_TOKEN']
-  bot = Telegem.new(ENV['BOT_TOKEN'])
- puts "token is #{bot_token[0..10]}"
- # In your code:
- db = SQLite3::Database.new "movieflix.db"
-puts "started sqlite"
-StartHandler.new(bot, db)
-SearchHandler.new(bot, db)
-WatchHandler.new(bot, db)
-HelpHandler.new(bot)
-PremiumHandler.new(bot)
-SponsorHandler.new(bot)
-AddHandler.new(bot, db)
-AddHears.new(bot, db)
-  port = (ENV['PORT'] || 3000).to_i
-  puts "  📍 Using port: #{port}"
-  puts "  🌐 Bind host: 0.0.0.0"
-  # Start polling
-  bot.start_polling
-  puts " started polling"
-  # Minimal health check server
-  Thread.new do
-    require 'socket'
-    server = TCPServer.new('0.0.0.0', port || 10000)
-    puts "✅ Health check server listening on port #{ENV['PORT'] || 10000}"
-    loop do
-      client = server.accept
-      request = client.gets
-      # Simple response for any request
-      client.puts "HTTP/1.1 200 OK\r\n"
-      client.puts "Content-Type: text/plain\r\n"
-      client.puts "\r\n"
-      client.puts "Telegram Bot is running"
-      client.close
-    end
-    puts "bot is running "
-  end
-   sleep
-   puts "bot is running alive now "

data/Test-Projects/Movie-tracker-bot/handlers/.gitkeep DELETED Viewed

File without changes