postgarnet 1.0.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 271a04be208146d3bb3c4e705d049d02ccdf6fbd104d171ff83ad548379bfc18
+  data.tar.gz: 1b9b7ff07abe7f4314321409c8726cc433e11349c5727b424400ca48991c5988
+SHA512:
+  metadata.gz: 1c89bef7166ffbd7ca165c08f1842944b62a8d5ea001d7865a568599f273108641ed35cfe571f3008b1221250723181a2be864daa9f225eaf490c784283b77b2
+  data.tar.gz: c1093b6c03e7d6303b5990d5a813e6e4278ca6e2946e2efb0e2a5dba48e759f006d3bdac77681f24acf993314d254b92628f679cae5cf76438370086aec70af5

data/lib/postgarnet.rb

@@ -0,0 +1,175 @@
+require 'net/smtp'
+
+class FormatError < StandardError
+  def initialize(msg)
+    super
+  end
+end
+
+class TransactionError < StandardError
+  def initialize(msg)
+    super
+  end
+end
+
+class Postgarnet
+  @@version = "1.0.3"
+  
+  def initialize(username:, password:)
+    @username, @password, @subject, @content, @recipient, @author = @username, @smtp = nil
+    login(username, password)
+    @headers = {
+      "mime-version" => "1",
+      "content-type" => "text/html"
+    }
+  end
+  
+  def subject(text=nil, payload=nil)
+    unless text.nil? || text.is_a?(String)
+      raise FormatError, "Subject must be a string"
+    end
+    unless payload.nil? || payload.is_a?(Hash)
+      raise FormatError, "Payload must be a hash"
+    end
+    if text.nil?
+      return @subject
+    else
+      @subject = payload.nil? ? text : use_payload(payload, text)
+    end
+  end
+  
+  def content(text=nil, payload=nil)
+    unless text.nil? || text.is_a?(String)
+      raise FormatError, "Subject must be a string"
+    end
+    unless payload.nil? || payload.is_a?(Hash)
+      raise FormatError, "Payload must be a hash"
+    end
+    if text.nil?
+      return @content
+    else
+      @content = payload.nil? ? text : use_payload(payload, text)
+    end
+  end
+  
+  def to(recipient=nil)
+    unless recipient.nil? || recipient.is_a?(String)
+      raise FormatError, "Recipient (to) must be a string"
+    end
+    if recipient.nil?
+      return @recipient
+    else
+      @recipient = recipient
+    end
+  end
+  
+  def from(author=nil)
+    unless author.nil? || author.is_a?(String)
+      raise FormatError, "Author (from) must be a string"
+    end
+    if author.nil?
+      return @author
+    else
+      @author = author
+    end
+  end
+  
+  def header(key, value=nil)
+    unless key.is_a?(String) || key.is_a?(Symbol)
+      raise FormatError, "Header key must be a string or a symbol"
+    end
+    unless value.nil? || value.is_a?(String)
+      raise FormatError, "Header value must be a string"
+    end
+    if value.nil?
+      return @headers[key]
+    else
+      @headers[key] = value
+    end
+  end
+  
+  def headers(value=nil)
+    unless value.nil? || value.is_a?(Hash)
+      raise FormatError, "Header value must be a hash"
+    end
+    if value.nil?
+      return @headers.clone
+    else
+      @headers = value.clone
+    end
+  end
+  
+  def connect(host: "smtp.gmail.com", port: 587)
+    begin
+      @smtp = Net::SMTP.new(host, port)
+      @smtp.enable_starttls
+    rescue Exception => e
+      raise TransactionError, "Error when connecting: #{e}"
+    else
+      true
+    end
+  end
+  
+  def login(username:, password:)
+    unless @smtp.nil?
+      raise TransactionError, "A connection already exists. Disconnect to the server first to login a new account."
+    end
+    if username.include?("@")
+      username = username.split("@")[0]
+    end
+    @username = "#{username}@gmail.com"
+    @password = password
+    return @username.clone
+  end
+  
+  def disconnect
+    if @smtp.nil?
+      raise TransactionError, "No connection to disconnect"
+    end
+    @smtp.finish
+    @smtp = nil
+  end
+  
+  def smtp
+    if @smtp.nil?
+      raise TransactionError, "Connect to the server first"
+    end
+    return @smtp
+  end
+  
+  def send(client="localhost")
+    if [@username, @password, @author, @recipient, @subject, @content].any?(&:nil?)
+      raise FormatError, "Incomplete parameters"
+    end
+    if @smtp.nil?
+      raise TransactionError, "Connect to the server first"
+    end
+    begin
+      message = self.create_msg
+      @smtp.start(client, @username, @password, :plain) do
+        @smtp.send_message(message, @username, @recipient)
+      end
+    rescue Exception => e
+      raise TransactionError, "Error when sending: #{e}"
+    end
+  end
+  
+  private
+  def use_payload(payload, content)
+    params = payload.clone
+    params.merge!({
+      from: @author,
+      to: @recipient,
+      author: @author,
+      recipient: @recipient
+    })
+    content.gsub(/\{(.+?)\}/) do
+      params[$1.to_s] || params[$1.to_sym] || "{#{$1}}"
+    end
+  end
+  
+  def create_msg
+    headers = @headers.map { |key, value| "#{key}: #{value}" }.join("\n")
+    return "From: #{@author} <#{@username}>\nTo: #{@recipient} <#{@recipient}>\nSubject: #{@subject}\n#{headers}\n\n<html><body>#{@content}</body></html>"
+  end
+end

metadata

@@ -0,0 +1,59 @@
+--- !ruby/object:Gem::Specification
+name: postgarnet
+version: !ruby/object:Gem::Version
+  version: 1.0.3
+platform: ruby
+authors:
+- trulyursdelv
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: net-smtp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.1
+description: 'Postgarnet is a lightweight SMTP client for sending emails through Gmail
+  using Ruby. It allows full control over server connection and message headers, supports
+  templates with dynamic payloads, and works out of the box with minimal setup. Designed
+  with simplicity in mind, it''s ideal for quick and flexible email sending in Ruby
+  scripts and applications.
+
+  '
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/postgarnet.rb
+homepage: https://rubygems.org/gems/postgarnet
+licenses:
+- CC0-1.0
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.8
+specification_version: 4
+summary: Lightweight, on-the-go Gmail SMTP client for Ruby
+test_files: []