raw_smtp 0.1.0.test

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b4bab05e57ccbc3dc65140a633d9755f2e983114
+  data.tar.gz: 77079197c46a3dec4f1c9f7bcf451e43f56a2555
+SHA512:
+  metadata.gz: 9cef5fe9530f822384addb2cb5f5e409dccf2e726f5ed7f887a3a628d2fc09957b617421644a7860444309d3b012d36eae827f8bb5ad94dd15d60fc79cfcd739
+  data.tar.gz: 9ec39d4952460a42466046cb2c81c8bd50e1f216b7bc31d4aa8ae62852b22b1623e3d7d4acb5f224b2babd644e684e675756d4c3967f86e76d9703d6fbe2cafd

data/.gitignore

@@ -0,0 +1,18 @@
+# Editor/OS-specific
+.DS_Store
+.swp
+
+# Bundler/Rubygems
+*.gem
+.bundle
+pkg/*
+tags
+Gemfile.lock
+
+# RDoc
+/doc
+/html
+
+# Vagrant
+.vagrant
+/Vagrantfile*

data/.rubocop.yml

@@ -0,0 +1,5 @@
+inherit_from: .rubocop_todo.yml
+
+# Disable string literals cop
+Style/StringLiterals:
+  Enabled: false

data/.rubocop_todo.yml

@@ -0,0 +1,40 @@
+# This configuration was generated by `rubocop --auto-gen-config`
+# on 2015-07-03 10:01:10 +0200 using RuboCop version 0.32.1.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 1
+# Configuration parameters: AllowSafeAssignment.
+Lint/AssignmentInCondition:
+  Enabled: false
+
+# Offense count: 7
+# Configuration parameters: AllowURI, URISchemes.
+Metrics/LineLength:
+  Max: 132
+
+# Offense count: 2
+# Configuration parameters: CountComments.
+Metrics/MethodLength:
+  Max: 25
+
+# Offense count: 1
+# Configuration parameters: CountKeywordArgs.
+Metrics/ParameterLists:
+  Max: 7
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+Style/EmptyElse:
+  Enabled: false
+
+# Offense count: 1
+Style/UnlessElse:
+  Enabled: false
+
+# Turnining
+Documentation:
+  Enabled: false

data/.ruby-version

@@ -0,0 +1 @@
+2.1.5

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+gemspec
+
+gem 'raw_smtp', path: '.'

data/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Artem Yakimenko
+
+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,2 @@
+# raw_smtp
+Simple SMTP client. An experiment in raw sockets in Ruby.

data/README.rdoc

@@ -0,0 +1,5 @@
+= \Raw_smtp - Simple SMTP client.
+
+== Description
+
+This is an experiment in raw sockets in Ruby to eventually produce an SMTP debugger.

data/Rakefile

@@ -0,0 +1,17 @@
+require 'bundler/setup'
+
+# Immediately sync all stdout so that tools like buildbot can
+# immediately load in the output.
+$stdout.sync = true
+$stderr.sync = true
+
+# Load all the rake tasks from the "tasks" folder. This folder
+# allows us to nicely separate rake tasks into individual files
+# based on their role, which makes development and debugging easier
+# than one monolithic file.
+task_dir = File.expand_path("../tasks", __FILE__)
+Dir["#{task_dir}/**/*.rake"].each do |task_file|
+  load task_file
+end
+
+task default: "test:unit"

data/bin/console

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "raw_smtp"
+
+require "pry"
+Pry.start

data/exe/raw_smtp

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby
+
+require 'trollop'
+require 'raw_smtp'
+require 'raw_smtp/smtp'
+require 'raw_smtp/validator'
+
+opts = Trollop.options do
+  version "raw_smtp #{RawSmtp::VERSION} (c) 2015 Artem Yakimenko"
+  banner <<-EOS
+Simple SMTP client for Ruby using raw sockets.
+Usage:
+       raw_smtp [options]
+where [options] are:
+EOS
+
+  opt :server, "Smtp server hostname or IP address", type: String
+  opt :sending_server, "Sending server name for EHLO", type: String
+  opt :mail_rcpt_to, "Message recepient in RCPT_TO", type: String
+  opt :mail_subject, "Message subject", type: String
+end
+
+Trollop.die :server, "Server and recepient must be specified" unless opts[:server]
+Trollop.die :mail_rcpt_to, "Server and recepient must be specified" unless opts[:mail_rcpt_to]
+Trollop.die :server, "Server must be a valid IP address or hostname" unless validate_address(opts[:server]) if opts[:server]
+
+m = SMTP.new(server: opts[:server],
+             mail_rcpt_to: opts[:mail_rcpt_to],
+             mail_subject: opts[:mail_subject]
+            )
+m.connect!

data/lib/raw_smtp.rb

@@ -0,0 +1,7 @@
+require 'raw_smtp/version'
+
+# Main module stub
+module RawSmtp
+  require 'raw_smtp/validator'
+  require 'raw_smtp/smtp'
+end

data/lib/raw_smtp/smtp.rb

@@ -0,0 +1,76 @@
+require 'socket'
+require 'uri'
+require 'digest/sha2'
+
+# The program uses raw TCP sockets to send a sequence of
+# SMTP messages to a mail server.
+#
+# Author::    Artem Yakimenko (mailto:dave@x.y)
+# Copyright:: Copyright (c) 2015 Artem Yakimenko
+# License::   MIT
+
+# This is the main class that performs the connection.
+class SMTP
+  # * server: server to attempt an SMTP connection to.
+  # * mail_from: sender, what to populate MAIL_FROM headers with.
+  # * mail_rcpt_to: recepient, what to populate RCPT_TO headers with.
+  # * mail_headers: custom headers. Need to be specified fully in a tabulated
+  #   string format. Overrides all header parameters!
+  # * mail_subject: email subject to be inserted into headers.
+  # * mail_body: email body in a tabulated string format.
+  def initialize(server:,
+                 sending_server: "mail.example.com",
+                 mail_from: "user@example.com",
+                 mail_rcpt_to:,
+                 mail_headers: nil,
+                 mail_subject: "This is a test message",
+                 mail_body: "This is a test message.\nRegards,\nraw_smtp"
+                )
+    @server = server
+    @sending_server = sending_server
+    @mail_from = mail_from
+    @mail_rcpt_to = mail_rcpt_to
+    @mail_subject = mail_subject
+    @mail_body = mail_body
+
+    unless mail_headers
+      @mail_headers = <<-EOH.gsub(/^\s+/, "")
+      \tMIME-Version: 1.0
+      \tMessage-ID: #{Digest::SHA2.hexdigest(Time.now.to_i.to_s)}@#{@sending_server}
+      \tDate: #{DateTime.now.rfc822.to_s}
+      \tSubject: #{@mail_subject}
+      \tFrom: #{@mail_from}
+      \tTo: #{@mail_rcpt_to}
+      \t
+      EOH
+    else
+      @mail_headers = mail_headers
+    end
+  end
+
+  def connect!
+    puts "Trying to open an SMTP session..."
+    connection = TCPSocket.new @server, 25
+
+    mail_data_chunk = @mail_headers + @mail_body + "\n."
+
+    protocol_queue = [
+      "EHLO #{@sending_server}",
+      "MAIL FROM:<#{@mail_from}>",
+      "RCPT TO:<#{@mail_rcpt_to}>",
+      "DATA",
+      "#{mail_data_chunk}",
+      "QUIT"
+    ]
+
+    while message = protocol_queue.shift
+      connection.puts(message)
+      puts message
+      sleep 1
+      puts connection.recv(2048)
+    end
+
+    puts "Session closed."
+    connection.close
+  end
+end

data/lib/raw_smtp/validator.rb

@@ -0,0 +1,12 @@
+require 'resolv'
+
+# Regex to verify a valid hostname per RFC 1123.
+VALID_HOSTNAME_REGEX = "^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\-]*[A-Za-z0-9])$"
+
+def validate_address(input)
+  if input.match(VALID_HOSTNAME_REGEX) || input.match(Resolv::IPv4::Regex)
+    input
+  else
+    nil
+  end
+end

data/lib/raw_smtp/version.rb

@@ -0,0 +1,4 @@
+# Standard versioning stub
+module RawSmtp
+  VERSION = "0.1.0.test"
+end

data/raw_smtp.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'raw_smtp/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'raw_smtp'
+  s.version     = RawSmtp::VERSION
+  s.authors     = ["Artem Yakimenko"]
+  s.email       = ["code@temik.me"]
+  s.homepage    = "http://rubygems.org/gems/raw-smtp"
+  s.license     = "MIT"
+
+  s.summary     = "SMTP using raw sockets"
+  s.description = "A simple experimental SMTP client"
+
+  s.files       = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  s.bindir      = "exe"
+  s.executables = s.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_runtime_dependency 'trollop', '~> 2.1'
+
+  s.add_development_dependency 'pry', '~> 0'
+  s.add_development_dependency 'pry-byebug', '~> 3.1'
+  s.add_development_dependency 'rubocop', '~> 0.32.1'
+  s.add_development_dependency 'rake', '~> 10.4'
+  s.add_development_dependency 'bundler', '~> 1.10'
+  s.add_development_dependency 'rdoc', '~> 4.2'
+end

data/tasks/bundler.rake

@@ -0,0 +1,3 @@
+# This installs the tasks that help with gem creation and
+# publishing.
+Bundler::GemHelper.install_tasks

data/tasks/lint.rake

@@ -0,0 +1,3 @@
+require 'rubocop/rake_task'
+
+RuboCop::RakeTask.new(:lint)

data/tasks/rdoc.rake

@@ -0,0 +1,6 @@
+require 'rdoc/task'
+
+RDoc::Task.new do |rd|
+  rd.main = "README.rdoc"
+  rd.rdoc_files.include("README.rdoc", "lib/**/*.rb")
+end

metadata

@@ -0,0 +1,163 @@
+--- !ruby/object:Gem::Specification
+name: raw_smtp
+version: !ruby/object:Gem::Version
+  version: 0.1.0.test
+platform: ruby
+authors:
+- Artem Yakimenko
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2015-08-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: trollop
+  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: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.32.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.32.1
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+description: A simple experimental SMTP client
+email:
+- code@temik.me
+executables:
+- raw_smtp
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- ".rubocop_todo.yml"
+- ".ruby-version"
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- README.rdoc
+- Rakefile
+- bin/console
+- exe/raw_smtp
+- lib/raw_smtp.rb
+- lib/raw_smtp/smtp.rb
+- lib/raw_smtp/validator.rb
+- lib/raw_smtp/version.rb
+- raw_smtp.gemspec
+- tasks/bundler.rake
+- tasks/lint.rake
+- tasks/rdoc.rake
+homepage: http://rubygems.org/gems/raw-smtp
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">"
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: SMTP using raw sockets
+test_files: []