ez-email 0.2.2 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a5b839b7d0ac396082469090ad98e7d9b2954b0c4dcb1cb2cc8cb81e67d3020c
-  data.tar.gz: 600749723b6e24831befe266f209b68372a2ba367284dfcb59a0065bd45ad998
+  metadata.gz: ac9476958dae126c2767f7c6a70c970ffeae5eca5613590864c69be364931497
+  data.tar.gz: f722d3d6d4f5baf6eed6d79d9a9514f0cfdbe7b29a3e57c615895daada5854ba
 SHA512:
-  metadata.gz: 8c47ad3b37aa37b3e4b825daee056a2a37b0262f8d6bc593f89cd32b8ccd6a71655ba64552d084cf5ccc3b42d1730b275e91f086cba579817430d65cf100ec9d
-  data.tar.gz: a8eda9d72ae00fc67e6e084f01c9f0361cdca89808e9af5ab592a1c48bf6eff8bde3bd7c0a4db632c793f1ff53fdd0cec9a2703e52ce886adb490e0244498327
+  metadata.gz: ba03fd9ede7a2e96bd6d8399d907357949e1c011d85cd0e56ddbd7dea3f8ba0e58a670b96c8caf2476d13405c6002ec4bb829f3cca4c946f8f7eb88f8260fff2
+  data.tar.gz: 0f4bf7d4fc3a76f3fa17a74c4866f25577a59240209d21d87bc5822e867c4b34aa3ddddb69c829fb47a5a4dadb7e14a11884dca31e38b7899757588abda03848

data/CHANGES.md

@@ -1,3 +1,9 @@
+## 0.4.0 - 13-Jul-2025
+- Add support for email attachments.
+
+## 0.3.0 - 20-Oct-2020
+- Switch test suite from test-unit to rspec.
+
 ## 0.2.2 - 3-Aug-2020
 - Switch README, CHANGES and MANIFEST files to markdown format.
 

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org' do
+  gemspec
+end

data/MANIFEST.md

@@ -3,8 +3,9 @@
 - MANIFEST.md
 - README.md
 - Rakefile
+- docker-compose.yml
 - ez-email.gemspec
 - certs/djberg96_pub.pem
 - lib/ez-email.rb
 - lib/ez/email.rb
-- test/test_ez_email.rb
+- spec/ez_email_spec.rb

data/README.md

@@ -1,44 +1,93 @@
 ### Description
-   A very easy interface for sending simple text based emails.
+A very easy interface for sending simple text based emails.
 
 ### Installation
-   gem install ez-email
+`gem install ez-email`
+
+### Adding the trusted cert
+`gem cert --add <(curl -Ls https://raw.githubusercontent.com/djberg96/ez-email/main/certs/djberg96_pub.pem)`
 
 ### Synopsis
+```ruby
+require 'ez-email'
+
+# Simple email
+EZ::Email.deliver(
+  :to      => 'your_friend@hotstuff.com',
+  :from    => 'you@blah.com',
+  :subject => 'Hello',
+  :body    => 'How are you?'
+)
+
+# Email with attachments
+EZ::Email.deliver(
+  :to          => 'your_friend@hotstuff.com',
+  :from        => 'you@blah.com',
+  :subject     => 'Files attached',
+  :body        => 'Please find the attached files.',
+  :attachments => ['/path/to/file1.pdf', '/path/to/file2.txt']
+)
 ```
-   require 'ez-email'
-   
-   EZ::Email.deliver(
-     :to      => 'your_friend@hotstuff.com',
-     :from    => 'you@blah.com',
-     :subject => 'Hello',
-     :body    => 'How are you?'
-   )
-```
-   
+
 ### Rationale
 
 When I originally created this library the existing list of email handling
 libraries were either not designed for sending email, were extremely cumbersome,
 had lousy interfaces, or were no longer maintained.
-   
+
 I just wanted to send a flippin' email! This library scratched that itch.
 Hopefully you will find its simplicity useful, too.
 
+### Features
+
+* Simple interface for sending text emails
+* Support for multiple recipients
+* File attachments support
+* Automatic MIME type detection for attachments
+* Minimal dependencies
+
+### API
+
+The library supports these options:
+
+* `:to` - Email address(es) of recipient(s). Can be a string or array. (Required)
+* `:from` - Email address of sender. Defaults to user@hostname if not specified.
+* `:subject` - Subject line of the email. (Required)
+* `:body` - Body text of the email. (Required)
+* `:attachments` - Array of file paths to attach. (Optional)
+
+All file attachments are automatically base64 encoded and sent with appropriate MIME types.
+
+### Local Testing
+To run the specs you will need a mail server running locally. If you do not
+already have a mail server running on port 1025 then install docker and run
+the following command:
+
+`docker compose run mailhog`
+
+Once the mailhog docker image is installed and a container is running, you
+can run the specs. You can also view the emails that were generated by pointing
+your web browser at http://localhost:8025 after running the specs for visual
+verification.
+
 ### Bugs
 
 None that I'm aware of. Please log any bug reports on the project page at
 
 https://github.com/djberg96/ez-email.
 
+### See Also
+
+The "pony" gem at https://github.com/benprew/pony.
+
 ### License
 
 Apache-2.0
 
 ### Copyright
 
-(C) 2009-2020, Daniel J. Berger, All Rights Reserved
-   
+(C) 2009-2023, Daniel J. Berger, All Rights Reserved
+
 ### Author
 
 Daniel Berger

data/Rakefile

@@ -1,16 +1,16 @@
 require 'rake'
 require 'rake/clean'
-require 'rake/testtask'
+require 'rspec/core/rake_task'
 
-CLEAN.include("**/*.gem", "**/*.rbc")
+CLEAN.include("**/*.gem", "**/*.rbc", "**/*.lock")
 
 namespace :gem do
   desc 'Build the ez-email gem'
   task :create => [:clean] do
     require 'rubygems/package'
-    spec = eval(IO.read('ez-email.gemspec'))
+    spec = Gem::Specification.load('ez-email.gemspec')
     spec.signing_key = File.join(Dir.home, '.ssh', 'gem-private_key.pem')
-    Gem::Package.build(spec, true)
+    Gem::Package.build(spec)
   end
 
   desc "Install the ez-email package as a gem"
@@ -20,9 +20,19 @@ namespace :gem do
   end
 end
 
-Rake::TestTask.new do |t|
-  t.warning = true
-  t.verbose = true
+namespace :mailhog do
+  desc 'Start a local mailhog server'
+  task :start do
+    system('docker compose up -d')
+  end
+
+  desc 'Stop the local mail server'
+  task :stop do
+    system('docker compose down')
+  end
 end
 
-task :default => :test
+desc "Run the test suite"
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/docker-compose.yml

@@ -0,0 +1,9 @@
+services:
+  mailhog:
+    image: mailhog/mailhog:latest
+    restart: always
+    logging:
+      driver: 'none' # disable saving logs
+    ports:
+      - 1025:1025 # smtp server
+      - 8025:8025 # web ui

data/ez-email.gemspec

@@ -2,27 +2,35 @@ require 'rubygems'
 
 Gem::Specification.new do |spec|
   spec.name        = 'ez-email'
-  spec.version     = '0.2.2'
+  spec.version     = '0.4.0'
   spec.license     = 'Apache-2.0'
   spec.summary     = 'Really easy emails'
   spec.description = 'A very simple interface for sending email'
   spec.author      = 'Daniel Berger'
   spec.email       = 'djberg96@gmail.com'
   spec.homepage    = 'https://github.com/djberg96/ez-email'
-  spec.test_file   = 'test/test_ez_email.rb'
+  spec.test_file   = 'spec/ez_email_spec.rb'
   spec.files       = Dir['**/*'].reject{ |f| f.include?('git') }
   spec.cert_chain  = Dir['certs/*']
-  
+
   spec.extra_rdoc_files  = ['README.md', 'CHANGES.md', 'MANIFEST.md']
 
-  spec.add_development_dependency('test-unit')
+  spec.add_development_dependency('rake')
+  spec.add_development_dependency('rspec', '~> 3.9')
+
+  spec.add_runtime_dependency('mime-types', '~> 3.0')
+  spec.add_runtime_dependency('net-smtp')
+  spec.add_runtime_dependency('base64')
 
   spec.metadata = {
-    'homepage_uri'      => 'https://github.com/djberg96/ez-email',
-    'bug_tracker_uri'   => 'https://github.com/djberg96/ez-email/issues',
-    'changelog_uri'     => 'https://github.com/djberg96/ez-email/blob/master/CHANGES',
-    'documentation_uri' => 'https://github.com/djberg96/ez-email/wiki',
-    'source_code_uri'   => 'https://github.com/djberg96/ez-email',
-    'wiki_uri'          => 'https://github.com/djberg96/ez-email/wiki'
+    'homepage_uri'          => 'https://github.com/djberg96/ez-email',
+    'bug_tracker_uri'       => 'https://github.com/djberg96/ez-email/issues',
+    'changelog_uri'         => 'https://github.com/djberg96/ez-email/blob/main/CHANGES.md',
+    'documentation_uri'     => 'https://github.com/djberg96/ez-email/wiki',
+    'source_code_uri'       => 'https://github.com/djberg96/ez-email',
+    'wiki_uri'              => 'https://github.com/djberg96/ez-email/wiki',
+    'github_repo'           => 'https://github.com/djberg96/ez-email',
+    'funding_uri'           => 'https://github.com/sponsors/djberg96',
+    'rubygems_mfa_required' => 'true'
   }
 end

data/lib/ez/email.rb

@@ -1,19 +1,25 @@
+# frozen_string_literal: true
+
 require 'resolv'
 require 'etc'
 require 'socket'
 require 'net/smtp'
+require 'base64'
+require 'mime/types'
 
 # The EZ module serves as a namespace only.
 module EZ
-
   # The Email class encapsulates certain SMTP attributes, which are then
   # used to send simple emails.
   class Email
     # The version of the ez-email library
-    VERSION = '0.2.2'.freeze
+    VERSION = '0.4.0'
 
     class << self
+      # Writer method for the mail_host property.
       attr_writer :mail_host
+
+      # Writer method for the mail_port property.
       attr_writer :mail_port
 
       # The name of the mail host to use when sending email. The default
@@ -48,12 +54,16 @@ module EZ
     # The body of the email. Mandatory.
     attr_accessor :body
 
+    # An array of file paths to attach to the email. Optional.
+    attr_accessor :attachments
+
     # Creates a new EZ::Email object. As a general rule you won't use
     # this method, but should use EZ::Email.deliver instead.
     #
-    def initialize(options={})
+    def initialize(options = {})
       raise TypeError unless options.is_a?(Hash)
-      options[:from] ||= Etc.getlogin + '@' + Socket.gethostname
+      options[:from] ||= "#{Etc.getlogin}@#{Socket.gethostname}"
+      @attachments = []
       validate_options(options)
       @options = options
     end
@@ -66,25 +76,55 @@ module EZ
       host = EZ::Email.mail_host
       port = EZ::Email.mail_port
 
-      to_list = self.to.is_a?(Array) ? self.to : [self.to]
-
-      Net::SMTP.start(host, port, host){ |smtp|
-        smtp.open_message_stream(self.from, self.to){ |stream|
-          stream.puts "From: #{self.from}"
-          stream.puts "To: " + to_list.join(', ')
-          stream.puts "Subject: #{self.subject}"
-          stream.puts
-          stream.puts self.body
-        }
-      }
+      to_list = to.is_a?(Array) ? to : [to]
+
+      Net::SMTP.start(host, port, host) do |smtp|
+        smtp.open_message_stream(from, to) do |stream|
+          if attachments.empty?
+            # Simple email without attachments
+            stream.puts "From: #{from}"
+            stream.puts "To: #{to_list.join(', ')}"
+            stream.puts "Subject: #{subject}"
+            stream.puts
+            stream.puts body
+          else
+            # Email with attachments - use multipart MIME
+            boundary = generate_boundary
+
+            stream.puts "From: #{from}"
+            stream.puts "To: #{to_list.join(', ')}"
+            stream.puts "Subject: #{subject}"
+            stream.puts "MIME-Version: 1.0"
+            stream.puts "Content-Type: multipart/mixed; boundary=\"#{boundary}\""
+            stream.puts
+
+            # Text body part
+            stream.puts "--#{boundary}"
+            stream.puts "Content-Type: text/plain; charset=UTF-8"
+            stream.puts "Content-Transfer-Encoding: 7bit"
+            stream.puts
+            stream.puts body
+            stream.puts
+
+            # Attachment parts
+            attachments.each do |file_path|
+              add_attachment(stream, file_path, boundary)
+            end
+
+            # End boundary
+            stream.puts "--#{boundary}--"
+          end
+        end
+      end
     end
 
-    # Delivers a simple text email message using four options:
+    # Delivers a simple text email message using these options:
     #
     # * to
     # * from
     # * subject
     # * body
+    # * attachments (optional)
     #
     # Examples:
     #
@@ -104,6 +144,15 @@ module EZ
     #       :body    => 'How are you?'
     #    )
     #
+    #    # Send an email with attachments
+    #    EZ::Email.deliver(
+    #       :to          => 'someone@example.com',
+    #       :from        => 'me@example.com',
+    #       :subject     => 'Files attached',
+    #       :body        => 'Please find the attached files.',
+    #       :attachments => ['/path/to/file1.pdf', '/path/to/file2.txt']
+    #    )
+    #
     # This is a shortcut for EZ::Email.new + EZ::Email#deliver.
     #
     def self.deliver(options)
@@ -116,17 +165,54 @@ module EZ
     # the attribute values.
     #
     def validate_options(hash)
-      valid = %w[to from subject body]
+      valid = %w[to from subject body attachments]
 
-      hash.each{ |key, value|
+      hash.each do |key, value|
         key = key.to_s.downcase
         raise ArgumentError unless valid.include?(key)
-        send("#{key}=", value)
-      }
 
-      if to.nil? || subject.nil? || body.nil?
-        raise ArgumentError, "Missing :to, :subject or :body"
+        if key == 'attachments'
+          # Validate attachments
+          attachments_value = value.is_a?(Array) ? value : [value]
+          attachments_value.each do |file_path|
+            raise ArgumentError, "Attachment file not found: #{file_path}" unless File.exist?(file_path)
+            raise ArgumentError, "Attachment is not a file: #{file_path}" unless File.file?(file_path)
+          end
+          self.attachments = attachments_value
+        else
+          send("#{key}=", value)
+        end
       end
+
+      raise ArgumentError, 'Missing :to' if to.nil?
+      raise ArgumentError, 'Missing :subject' if subject.nil?
+      raise ArgumentError, 'Missing :body' if body.nil?
+    end
+
+    # Generate a unique boundary for multipart MIME messages
+    def generate_boundary
+      "----=_NextPart_#{Time.now.to_i}_#{rand(1000000)}"
+    end
+
+    # Add an attachment to the email stream
+    def add_attachment(stream, file_path, boundary)
+      filename = File.basename(file_path)
+
+      # Determine MIME type
+      mime_type = MIME::Types.type_for(file_path).first
+      content_type = mime_type ? mime_type.content_type : 'application/octet-stream'
+
+      stream.puts "--#{boundary}"
+      stream.puts "Content-Type: #{content_type}; name=\"#{filename}\""
+      stream.puts "Content-Transfer-Encoding: base64"
+      stream.puts "Content-Disposition: attachment; filename=\"#{filename}\""
+      stream.puts
+
+      # Read file and encode as base64
+      file_content = File.read(file_path)
+      encoded_content = Base64.encode64(file_content)
+      stream.puts encoded_content
+      stream.puts
     end
   end
 end

data/lib/ez-email.rb

@@ -1 +1,3 @@
+# frozen_string_literal: true
+
 require_relative 'ez/email'

data/spec/ez_email_spec.rb

@@ -0,0 +1,197 @@
+########################################################################
+# ez_email_spec.rb
+#
+# Specs for the EZ::Email library. These specs assume that you are
+# running the mailhog docker container on port 1025.
+#
+# Install docker and run "docker compose run mailhog" first.
+########################################################################
+require 'rspec'
+require 'ez/email'
+require 'socket'
+require 'etc'
+
+RSpec.describe EZ::Email do
+  let(:host){ Socket.gethostname }
+  let(:login){ Etc.getlogin }
+  let(:port){ 1025 }
+
+  before do
+    @to   = 'foo@some_mail_service.com'
+    @from = 'bar@some_mail_service.com'
+    @subj = 'This is a test'
+    @body = 'How are you?'
+
+    @opts = {:to => @to, :from => @from, :subject => @subj, :body => @body }
+    @email = EZ::Email.new(@opts)
+  end
+
+  example "version is set to expected value" do
+    expect(EZ::Email::VERSION).to eq('0.4.0')
+    expect(EZ::Email::VERSION).to be_frozen
+  end
+
+  example "to getter method basic functionality" do
+    expect(@email).to respond_to(:to)
+    expect{ @email.to }.not_to raise_error
+    expect(@email.to).not_to be_nil
+  end
+
+  example "to getter method returns expected value" do
+    expect(@email.to).to eq(@to)
+  end
+
+  example "to setter method basic functionality" do
+    expect(@email).to respond_to(:to=)
+    expect{ @email.to = 'bogus@some_bogus.com' }.not_to raise_error
+  end
+
+  example "to setter actually sets value" do
+    @email.to = 'bogus@some_bogus.com'
+    expect('bogus@some_bogus.com').to eq(@email.to)
+  end
+
+  example "from getter basic functionality" do
+    expect(@email).to respond_to(:from)
+    expect{ @email.from }.not_to raise_error
+    expect(@email.from).not_to be_nil
+  end
+
+  example "from setter basic functionality" do
+    expect(@email).to respond_to(:from=)
+    expect{ @email.from = 'bogus@some_bogus.com' }.not_to raise_error
+  end
+
+  example "from method returns expected value" do
+    expect(@email.from).to eq(@from)
+  end
+
+  example "from defaults to username@host if not set in constructor" do
+    @email = EZ::Email.new(:to => 'x', :subject => 'x', :body => 'x')
+    expected = login << '@' << host
+    expect(@email.from).to eq(expected)
+  end
+
+  example "subject getter basic functionality" do
+    expect(@email).to respond_to(:subject)
+    expect{ @email.subject }.not_to raise_error
+    expect(@email.subject).not_to be_nil
+  end
+
+  example "subject setter basic functionality" do
+    expect(@email).to respond_to(:subject=)
+    expect{ @email.subject = 'bogus@bogus.com' }.not_to raise_error
+  end
+
+  example "subject method returns expected value" do
+    expect(@email.subject).to eq(@subj)
+  end
+
+  example "body getter basic functionality" do
+    expect(@email).to respond_to(:body)
+    expect{ @email.body }.not_to raise_error
+    expect(@email.body).not_to be_nil
+  end
+
+  example "body setter basic functionality" do
+    expect(@email).to respond_to(:body=)
+    expect{ @email.body = "Test" }.not_to raise_error
+  end
+
+  example "body method returns the expected value" do
+    expect(@email.body).to eq(@body)
+  end
+
+  example "mail_host getter basic functionality" do
+    expect(EZ::Email).to respond_to(:mail_host)
+    expect{ EZ::Email.mail_host }.not_to raise_error
+    expect(EZ::Email.mail_host).not_to be_nil
+  end
+
+  example "mail_host setter basic functionality" do
+    expect(EZ::Email).to respond_to(:mail_host=)
+    expect{ EZ::Email.mail_host = 'Test' }.not_to raise_error
+    expect(EZ::Email.mail_host).to eq('Test')
+  end
+
+  example "mail_port singleton getter basic functionality" do
+    expect(EZ::Email).to respond_to(:mail_port)
+  end
+
+  example "mail_port method returns the expected default value" do
+    expect(EZ::Email.mail_port).to eq(25)
+  end
+
+  example "mail_port singleton setter basic functionality" do
+    expect(EZ::Email).to respond_to(:mail_port=)
+    expect{ EZ::Email.mail_port = port }.not_to raise_error
+    expect(EZ::Email.mail_port).to eq(1025)
+  end
+
+  example "deliver singleton method basic functionality" do
+    expect(EZ::Email).to respond_to(:deliver)
+  end
+
+  example "deliver singleton method works without error" do
+    EZ::Email.mail_host = 'localhost'
+    EZ::Email.mail_port = port
+    expect{ EZ::Email.deliver(@opts) }.not_to raise_error
+  end
+
+  example "passing an invalid option to the constructor raises an error" do
+    expect{ EZ::Email.send(:new, {:bogus => 77}) }.to raise_error(ArgumentError)
+  end
+
+  example "attachments getter basic functionality" do
+    expect(@email).to respond_to(:attachments)
+    expect{ @email.attachments }.not_to raise_error
+  end
+
+  example "attachments setter basic functionality" do
+    expect(@email).to respond_to(:attachments=)
+    expect{ @email.attachments = [] }.not_to raise_error
+  end
+
+  example "attachments method returns an array" do
+    expect(@email.attachments).to be_an(Array)
+  end
+
+  example "attachments defaults to empty array" do
+    expect(@email.attachments).to be_empty
+  end
+
+  example "can set attachments via constructor" do
+    # Create a test file
+    test_file = '/tmp/test_attachment.txt'
+    File.write(test_file, 'test content')
+
+    begin
+      opts_with_attachments = @opts.merge(attachments: [test_file])
+      email = EZ::Email.new(opts_with_attachments)
+      expect(email.attachments).to eq([test_file])
+    ensure
+      File.delete(test_file) if File.exist?(test_file)
+    end
+  end
+
+  example "raises error for non-existent attachment file" do
+    opts_with_bad_attachment = @opts.merge(attachments: ['/non/existent/file.txt'])
+    expect{ EZ::Email.new(opts_with_bad_attachment) }.to raise_error(ArgumentError, /Attachment file not found/)
+  end
+
+  example "can deliver email with attachments" do
+    # Create a test file
+    test_file = '/tmp/test_attachment.txt'
+    File.write(test_file, 'test content for attachment')
+
+    begin
+      EZ::Email.mail_host = 'localhost'
+      EZ::Email.mail_port = port
+
+      opts_with_attachments = @opts.merge(attachments: [test_file])
+      expect{ EZ::Email.deliver(opts_with_attachments) }.not_to raise_error
+    ensure
+      File.delete(test_file) if File.exist?(test_file)
+    end
+  end
+end

data/test_attachments.rb

@@ -0,0 +1,45 @@
+#!/usr/bin/env ruby
+
+require_relative 'lib/ez-email'
+
+# Create a test file for attachment
+test_file = '/tmp/sample_attachment.txt'
+File.write(test_file, "This is a sample attachment file.\nIt contains some test content.")
+
+begin
+  # Create an email with attachment
+  email = EZ::Email.new(
+    to: 'recipient@example.com',
+    from: 'sender@example.com',
+    subject: 'Test Email with Attachment',
+    body: 'Hello! Please find the attached file.',
+    attachments: [test_file]
+  )
+
+  puts "Email created successfully with attachment: #{test_file}"
+  puts "Attachments: #{email.attachments}"
+  puts "To: #{email.to}"
+  puts "From: #{email.from}"
+  puts "Subject: #{email.subject}"
+  puts "Body: #{email.body}"
+
+  # You can also use the class method
+  puts "\nUsing class method:"
+
+  # This would deliver if you had a mail server running
+  # EZ::Email.deliver(
+  #   to: 'recipient@example.com',
+  #   from: 'sender@example.com',
+  #   subject: 'Test Email with Multiple Attachments',
+  #   body: 'Hello! Please find the attached files.',
+  #   attachments: [test_file, '/path/to/another/file.pdf']
+  # )
+
+  puts "All tests passed! Attachment functionality is working."
+
+rescue => e
+  puts "Error: #{e.message}"
+ensure
+  # Clean up
+  File.delete(test_file) if File.exist?(test_file)
+end

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: ez-email
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.4.0
 platform: ruby
 authors:
 - Daniel Berger
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain:
 - |
@@ -35,10 +35,10 @@ cert_chain:
   ORVCZpRuCPpmC8qmqxUnARDArzucjaclkxjLWvCVHeFa9UP7K3Nl9oTjJNv+7/jM
   WZs4eecIcUc4tKdHxcAJ0MO/Dkqq7hGaiHpwKY76wQ1+8xAh
   -----END CERTIFICATE-----
-date: 
+date: 2025-07-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: test-unit
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -51,6 +51,62 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.9'
+- !ruby/object:Gem::Dependency
+  name: mime-types
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: net-smtp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: A very simple interface for sending email
 email: djberg96@gmail.com
 executables: []
@@ -60,31 +116,33 @@ extra_rdoc_files:
 - CHANGES.md
 - MANIFEST.md
 files:
+- CHANGES.md
+- Gemfile
 - LICENSE
-- test
-- test/test_ez_email.rb
-- ez-email.gemspec
+- MANIFEST.md
 - README.md
 - Rakefile
-- MANIFEST.md
-- certs
 - certs/djberg96_pub.pem
-- lib
+- docker-compose.yml
+- ez-email.gemspec
 - lib/ez-email.rb
-- lib/ez
 - lib/ez/email.rb
-- CHANGES.md
+- spec/ez_email_spec.rb
+- test_attachments.rb
 homepage: https://github.com/djberg96/ez-email
 licenses:
 - Apache-2.0
 metadata:
   homepage_uri: https://github.com/djberg96/ez-email
   bug_tracker_uri: https://github.com/djberg96/ez-email/issues
-  changelog_uri: https://github.com/djberg96/ez-email/blob/master/CHANGES
+  changelog_uri: https://github.com/djberg96/ez-email/blob/main/CHANGES.md
   documentation_uri: https://github.com/djberg96/ez-email/wiki
   source_code_uri: https://github.com/djberg96/ez-email
   wiki_uri: https://github.com/djberg96/ez-email/wiki
-post_install_message: 
+  github_repo: https://github.com/djberg96/ez-email
+  funding_uri: https://github.com/sponsors/djberg96
+  rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -99,9 +157,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: Really easy emails
 test_files:
-- test/test_ez_email.rb
+- spec/ez_email_spec.rb

data/test/test_ez_email.rb

@@ -1,147 +0,0 @@
-########################################################################
-# test_ez_email.rb
-#
-# Test suite for the EZ::Email library.
-########################################################################
-require 'test-unit'
-require 'ez/email'
-require 'socket'
-require 'etc'
-
-class TC_EZ_Email < Test::Unit::TestCase
-  def self.startup
-    @@host  = Socket.gethostname
-    @@login = Etc.getlogin
-  end
-
-  def setup
-    @to   = 'foo@some_mail_service.com'
-    @from = 'bar@some_mail_service.com'
-    @subj = 'This is a test'
-    @body = 'How are you?'
-
-    @opts = {:to => @to, :from => @from, :subject => @subj, :body => @body }
-    @email = EZ::Email.new(@opts)
-  end
-
-  test "version is set to expected value" do
-    assert_equal('0.2.2', EZ::Email::VERSION)
-    assert_true(EZ::Email::VERSION.frozen?)
-  end
-
-  test "to getter method basic functionality" do
-    assert_respond_to(@email, :to)
-    assert_nothing_raised{ @email.to }
-    assert_not_nil(@email.to)
-  end
-
-  test "to getter method returns expected value" do
-    assert_equal(@to, @email.to)
-  end
-
-  test "to setter method basic functionality" do
-    assert_respond_to(@email, :to=)
-    assert_nothing_raised{ @email.to = 'bogus@some_bogus.com' }
-  end
-
-  test "to setter actually sets value" do
-    @email.to = 'bogus@some_bogus.com'
-    assert_equal(@email.to, 'bogus@some_bogus.com')
-  end
-
-  test "from getter basic functionality" do
-    assert_respond_to(@email, :from)
-    assert_nothing_raised{ @email.from }
-    assert_not_nil(@email.from)
-  end
-
-  test "from setter basic functionality" do
-    assert_respond_to(@email, :from=)
-    assert_nothing_raised{ @email.from = 'bogus@some_bogus.com' }
-  end
-
-  test "from method returns expected value" do
-    assert_equal(@from, @email.from)
-  end
-
-  test "from defaults to username@host if not set in constructor" do
-    @email = EZ::Email.new(:to => 'x', :subject => 'x', :body => 'x')
-    expected = @@login << '@' << @@host
-    assert_equal(expected, @email.from)
-  end
-
-  test "subject getter basic functionality" do
-    assert_respond_to(@email, :subject)
-    assert_nothing_raised{ @email.subject }
-    assert_not_nil(@email.subject)
-  end
-
-  test "subject setter basic functionality" do
-    assert_respond_to(@email, :subject=)
-    assert_nothing_raised{ @email.subject = 'bogus@bogus.com' }
-  end
-
-  test "subject method returns expected value" do
-    assert_equal(@subj, @email.subject)
-  end
-
-  test "body getter basic functionality" do
-    assert_respond_to(@email, :body)
-    assert_nothing_raised{ @email.body }
-    assert_not_nil(@email.body)
-  end
-
-  test "body setter basic functionality" do
-    assert_respond_to(@email, :body=)
-    assert_nothing_raised{ @email.body = "Test" }
-  end
-
-  test "body method returns the expected value" do
-    assert_equal(@body, @email.body)
-  end
-
-  test "mail_host getter basic functionality" do
-    assert_respond_to(EZ::Email, :mail_host)
-    assert_nothing_raised{ EZ::Email.mail_host }
-    assert_not_nil(EZ::Email.mail_host)
-  end
-
-  test "mail_host setter basic functionality" do
-    assert_respond_to(EZ::Email, :mail_host=)
-    assert_nothing_raised{ EZ::Email.mail_host = "Test" }
-  end
-
-  test "mail_port singleton getter basic functionality" do
-    assert_respond_to(EZ::Email, :mail_port)
-  end
-
-  test "mail_port singleton setter basic functionality" do
-    assert_respond_to(EZ::Email, :mail_port=)
-  end
-
-  test "mail_port method returns the expected value" do
-    assert_equal(25, EZ::Email.mail_port)
-  end
-
-  test "deliver singleton method basic functionality" do
-    assert_respond_to(EZ::Email, :deliver)
-  end
-
-  test "passing an invalid option to the constructor raises an error" do
-    assert_raise(ArgumentError){ EZ::Email.send(:new, {:bogus => 77}) }
-  end
-
-  def teardown
-    @to    = nil
-    @from  = nil
-    @subj  = nil
-    @body  = nil
-    @opts  = nil
-    @email = nil
-  end
-
-  def self.shutdown
-    @@host  = nil
-    @@login = nil
-  end
-end