telefy 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 45ba5021039d010c2c7497ca017512df821f4c3d14b335fb58ae17bc077274e3
+  data.tar.gz: b6144c0ab2818568e48f5d313976b933462706cd753833c6cd58f317d7853ba5
+SHA512:
+  metadata.gz: 409853abfe3fa7d2fae1e9f89d90c8aa5f73ddbb35553436ad366b67e3ba473491f1681573e507d732a1ddfa0555ee305ddbc55db59fb0c4bb84f95d94d5cae0
+  data.tar.gz: 1db9e7fc42ad644148d5b1e9f2d149cfe1b466a1ee9febd6bf587fbe0aea1f88b493958485177bcdc6fa8ba7382b9c5c05c015611ed3639108124f7e4609951d

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2026-02-26
+
+- Initial release

data/CLAUDE.md

@@ -0,0 +1,31 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+- `bundle exec rake` — run tests + lint (default task)
+- `bundle exec rake test` — tests only (minitest)
+- `bundle exec rake standard` — lint only (StandardRB)
+- `bin/console` — IRB REPL with gem loaded
+
+## Architecture
+
+Ruby gem (no runtime deps, stdlib only) for sending Telegram messages via Bot API.
+
+**Entry point**: `exe/telefy` → `Telefy::CLI.new(ARGV).run`
+
+**Core classes** (all under `lib/telefy/`):
+- `Config` — YAML persistence at `~/.config/telefy/config.yml` (XDG-aware). Lazy load/save of `bot_token` and `chat_id`.
+- `Client` — Telegram Bot API HTTP wrapper using `net/http`. `send_message` and `resolve_chat_id`.
+- `CLI` — Arg parsing. `--setup` for config, otherwise joins args as message text and sends.
+
+**Public API**: `Telefy.send_message(text, config:)` in `lib/telefy.rb` for library use.
+
+## Testing
+
+Minitest in `test/`. Uses `Dir.mktmpdir` for filesystem isolation and inline `.stub` for HTTP mocking. No fixtures or factories.
+
+## Style
+
+StandardRB (`.standard.yml`, targets Ruby 3.2). No custom RuboCop overrides.

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,10 @@
+# Code of Conduct
+
+"telefy" follows [The Ruby Community Conduct Guideline](https://www.ruby-lang.org/en/conduct) in all "collaborative space", which is defined as community communications channels (such as mailing lists, submitted patches, commit comments, etc.):
+
+* Participants will be tolerant of opposing views.
+* Participants must ensure that their language and actions are free of personal attacks and disparaging personal remarks.
+* When interpreting the words and actions of others, participants should always assume good intentions.
+* Behaviour which can be reasonably considered harassment will not be tolerated.
+
+If you have any concerns about behaviour within this project, please contact us at ["arzezak@gmail.com"](mailto:"arzezak@gmail.com").

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Ariel Rzezak
+
+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,67 @@
+# Telefy
+
+Minimal CLI and Ruby library for sending Telegram messages via the Bot API. Config stored in `~/.config/telefy/config.yml` (XDG). Chat ID auto-resolved on first send.
+
+## Installation
+
+```bash
+gem install telefy
+```
+
+## Setup
+
+1. Create a bot with [@BotFather](https://t.me/BotFather) and copy the token.
+2. Run setup:
+
+```bash
+telefy --setup
+```
+
+3. Send any message to your bot on Telegram.
+4. Send your first message:
+
+```bash
+telefy "Hello from the terminal"
+```
+
+The chat ID is resolved automatically and saved for future use.
+
+## Usage
+
+```bash
+telefy "Deploy finished"     # send a message
+telefy --setup               # configure bot token
+telefy --help                # show usage
+```
+
+### As a library
+
+```ruby
+require "telefy"
+
+Telefy.send_message("deploy finished")
+```
+
+## Config
+
+Stored at `~/.config/telefy/config.yml` (respects `XDG_CONFIG_HOME`):
+
+```yaml
+bot_token: "123456:ABC-DEF..."
+chat_id: "789012345"
+```
+
+## Development
+
+```bash
+bin/setup           # install deps
+bundle exec rake    # tests + linter
+```
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the Telefy project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/arzezak/telefy/blob/main/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+require "standard/rake"
+
+task default: %i[test standard]

data/exe/telefy

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+# frozen_string_literal: true
+
+require "telefy"
+
+Telefy::CLI.new(ARGV).run

data/lib/telefy/cli.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Telefy
+  class CLI
+    USAGE = <<~TEXT
+      Usage: telefy [options] [message]
+
+        telefy --setup    Configure bot token
+        telefy "message"  Send a message (auto-resolves chat ID on first use)
+        telefy --help     Show this help
+    TEXT
+
+    def initialize(argv, config: Config.new)
+      @argv = argv
+      @config = config
+    end
+
+    def run
+      case @argv.first
+      when "--setup" then setup
+      when "--help", nil then puts USAGE
+      else send_message(@argv.join(" "))
+      end
+    end
+
+    private
+
+    def setup
+      print "Bot token: "
+      token = $stdin.gets&.strip
+      abort "Aborted." if token.nil? || token.empty?
+
+      @config.bot_token = token
+      puts "Saved to #{@config.path}"
+    end
+
+    def send_message(text)
+      client = Client.new(@config.bot_token)
+
+      unless @config.chat_id
+        chat_id = client.resolve_chat_id
+        @config.chat_id = chat_id
+        puts "Chat ID resolved and saved: #{chat_id}"
+      end
+
+      client.send_message(chat_id: @config.chat_id, text: text)
+    end
+  end
+end

data/lib/telefy/client.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+require "uri"
+
+module Telefy
+  class Client
+    def initialize(bot_token)
+      raise Error, "Bot token not configured. Run: telefy --setup" unless bot_token
+
+      @bot_token = bot_token
+    end
+
+    def send_message(chat_id:, text:)
+      response = post("sendMessage", chat_id: chat_id, text: text)
+      raise Error, "Failed to send message: #{response.body}" unless response.is_a?(Net::HTTPSuccess)
+
+      JSON.parse(response.body)
+    end
+
+    def resolve_chat_id
+      uri = api_uri("getUpdates")
+      body = JSON.parse(Net::HTTP.get(uri))
+      chat = body.dig("result", 0, "message", "chat", "id")
+      raise Error, "No messages found. Message your bot first, then retry." unless chat
+
+      chat
+    end
+
+    private
+
+    def post(method, params)
+      Net::HTTP.post_form(api_uri(method), params)
+    end
+
+    def api_uri(method)
+      URI("https://api.telegram.org/bot#{@bot_token}/#{method}")
+    end
+  end
+end

data/lib/telefy/config.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require "yaml"
+require "fileutils"
+
+module Telefy
+  class Config
+    DEFAULT_DIR = File.join(ENV.fetch("XDG_CONFIG_HOME", File.expand_path("~/.config")), "telefy")
+    DEFAULT_PATH = File.join(DEFAULT_DIR, "config.yml")
+
+    attr_reader :path
+
+    def initialize(path: DEFAULT_PATH)
+      @path = path
+    end
+
+    def load
+      return {} unless File.exist?(path)
+
+      YAML.safe_load_file(path, symbolize_names: true) || {}
+    end
+
+    def save(data)
+      FileUtils.mkdir_p(File.dirname(path))
+      File.write(path, YAML.dump(data.transform_keys(&:to_s)))
+    end
+
+    def bot_token
+      load[:bot_token]
+    end
+
+    def chat_id
+      load[:chat_id]
+    end
+
+    def bot_token=(value)
+      save(load.merge(bot_token: value))
+    end
+
+    def chat_id=(value)
+      save(load.merge(chat_id: value))
+    end
+  end
+end

data/lib/telefy/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Telefy
+  VERSION = "0.1.0"
+end

data/lib/telefy.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require_relative "telefy/version"
+require_relative "telefy/config"
+require_relative "telefy/client"
+require_relative "telefy/cli"
+
+module Telefy
+  class Error < StandardError; end
+
+  def self.send_message(text, config: Config.new)
+    client = Client.new(config.bot_token)
+
+    unless config.chat_id
+      chat_id = client.resolve_chat_id
+      config.chat_id = chat_id
+    end
+
+    client.send_message(chat_id: config.chat_id, text: text)
+  end
+end

data/sig/telefy.rbs

@@ -0,0 +1,4 @@
+module Telefy
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,57 @@
+--- !ruby/object:Gem::Specification
+name: telefy
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ariel Rzezak
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: Minimal CLI and library for sending Telegram messages via the Bot API
+email:
+- arzezak@gmail.com
+executables:
+- telefy
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- CLAUDE.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- exe/telefy
+- lib/telefy.rb
+- lib/telefy/cli.rb
+- lib/telefy/client.rb
+- lib/telefy/config.rb
+- lib/telefy/version.rb
+- sig/telefy.rbs
+homepage: https://github.com/arzezak/telefy
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/arzezak/telefy
+  source_code_uri: https://github.com/arzezak/telefy
+  changelog_uri: https://github.com/arzezak/telefy/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: Send Telegram messages from the command line
+test_files: []