smtp_mock 0.1.0

data/README.md

@@ -0,0 +1,242 @@
+# ![Ruby SmtpMock - mimic any 📤 SMTP server behaviour for your test environment and even more!](https://repository-images.githubusercontent.com/443795043/81ce5b00-0915-4dd0-93ad-88e6699e18cd)
+
+[![Maintainability](https://api.codeclimate.com/v1/badges/5ea9da61ef468b8ad4c4/maintainability)](https://codeclimate.com/github/mocktools/ruby-smtp-mock/maintainability)
+[![Test Coverage](https://api.codeclimate.com/v1/badges/5ea9da61ef468b8ad4c4/test_coverage)](https://codeclimate.com/github/mocktools/ruby-smtp-mock/test_coverage)
+[![CircleCI](https://circleci.com/gh/mocktools/ruby-smtp-mock/tree/master.svg?style=svg)](https://circleci.com/gh/mocktools/ruby-smtp-mock/tree/master)
+[![Gem Version](https://badge.fury.io/rb/smtp_mock.svg)](https://badge.fury.io/rb/smtp_mock)
+[![Downloads](https://img.shields.io/gem/dt/smtp_mock.svg?colorA=004d99&colorB=0073e6)](https://rubygems.org/gems/smtp_mock)
+[![GitHub](https://img.shields.io/github/license/mocktools/ruby-smtp-mock)](LICENSE.txt)
+[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v1.4%20adopted-ff69b4.svg)](CODE_OF_CONDUCT.md)
+
+💎 Ruby SMTP mock - flexible Ruby wrapper over [`smtpmock`](https://github.com/mocktools/go-smtp-mock). Mimic any 📤 SMTP server behaviour for your test environment and even more.
+
+## Table of Contents
+
+- [Features](#features)
+- [Requirements](#requirements)
+- [Installation](#installation)
+- [Usage](#usage)
+  - [Dependency manager](#dependency-manager)
+    - [Available flags](#available-flags)
+  - [DSL](#dsl)
+    - [Available server options](#available-server-options)
+    - [Example of usage](#example-of-usage)
+  - [RSpec integration](#rspec-integration)
+    - [SmtpMock RSpec helper](#smtpmock-rspec-helper)
+    - [SmtpMock RSpec interface](#smtpmock-rspec-interface)
+- [Contributing](#contributing)
+- [License](#license)
+- [Code of Conduct](#code-of-conduct)
+- [Credits](#credits)
+- [Versioning](#versioning)
+- [Changelog](CHANGELOG.md)
+
+## Features
+
+- Ability to handle configurable behaviour and life cycles of SMTP mock server(s)
+- Dynamic/manual port assignment
+- Test framework agnostic (it's PORO, so you can use it outside of `RSpec`, `Test::Unit` or `MiniTest`)
+- Simple and intuitive DSL
+- RSpec integration out of the box
+- Includes easy system dependency manager
+
+## Requirements
+
+Ruby MRI 2.5.0+
+
+## Installation
+
+Add this line to your application's `Gemfile`:
+
+```ruby
+group :development, :test do
+  gem 'smtp_mock', require: false
+end
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install smtp_mock
+
+Then install [`smtpmock`](https://github.com/mocktools/go-smtp-mock) as system dependency:
+
+    $ bundle exec smtp_mock -i ~
+
+## Usage
+
+### Dependency manager
+
+This gem includes esasy system dependency manager. Run `bundle exec smtp_mock` with options for manage `smtpmock` system dependency.
+
+#### Available flags
+
+| Flag | Description | Example of usage |
+| --- | --- | --- |
+| `-s`, `--sudo` | Run command as sudo | `bundle exec smtp_mock -s -i ~` |
+| `-i`, `--install=PATH` | Install smtpmock to the existing path | `bundle exec smtp_mock -i ~/existent_dir` |
+| `-u`, `--uninstall` | Uninstall smtpmock | `bundle exec smtp_mock -u` |
+| `-h`, `--help` | Prints help | `bundle exec smtp_mock -h` |
+
+### DSL
+
+#### Available server options
+
+| Example of usage kwarg | Description |
+| --- | --- |
+| `host: '0.0.0.0'` | Host address where smtpmock will run. It's equal to 127.0.0.1 by default |
+| `port: 2525` | Server port number. If not specified it will be assigned dynamically |
+| `log: true` | Enables log server activity. Disabled by default |
+| `session_timeout: 60` | Session timeout in seconds. It's equal to 30 seconds by default |
+| `shutdown_timeout: 5` | Graceful shutdown timeout in seconds. It's equal to 1 second by default |
+| `fail_fast: true` | Enables fail fast scenario. Disabled by default |
+| `blacklisted_helo_domains: %w[a.com b.com]` | Blacklisted `HELO` domains |
+| `blacklisted_mailfrom_emails: %w[a@a.com b@b.com]` | Blacklisted `MAIL FROM` emails |
+| `blacklisted_rcptto_emails: %w[c@c.com d@d.com]` | blacklisted `RCPT TO` emails |
+| `not_registered_emails: %w[e@e.com f@f.com]` | Not registered (non-existent) `RCPT TO` emails |
+| `msg_size_limit: 42` | Message body size limit in bytes. It's equal to 10485760 bytes by default |
+| `msg_greeting: 'Greeting message'` | Custom server greeting message |
+| `msg_invalid_cmd: 'Invalid command message'` | Custom invalid command message |
+| `msg_invalid_cmd_helo_sequence: 'Invalid command HELO sequence message'` | Custom invalid command `HELO` sequence message |
+| `msg_invalid_cmd_helo_arg: 'Invalid command HELO argument message'` | Custom invalid command `HELO` argument message |
+| `msg_helo_blacklisted_domain: 'Blacklisted domain message'` | Custom `HELO` blacklisted domain message |
+| `msg_helo_received: 'HELO received message'` | Custom `HELO` received message |
+| `msg_invalid_cmd_mailfrom_sequence: 'Invalid command MAIL FROM sequence message'` | Custom invalid command `MAIL FROM` sequence message |
+| `msg_invalid_cmd_mailfrom_arg: 'Invalid command MAIL FROM argument message'` | Custom invalid command `MAIL FROM` argument message |
+| `msg_mailfrom_blacklisted_email: 'Blacklisted email message'` | Custom `MAIL FROM` blacklisted email message |
+| `msg_mailfrom_received: 'MAIL FROM received message'` | Custom `MAIL FROM` received message |
+| `msg_invalid_cmd_rcptto_sequence: 'Invalid command RCPT TO sequence message'` | Custom invalid command `RCPT TO` sequence message |
+| `msg_invalid_cmd_rcptto_arg: 'Invalid command RCPT TO argument message'` | Custom invalid command `RCPT TO` argument message |
+| `msg_rcptto_not_registered_email: 'Not registered email message'` | Custom `RCPT TO` not registered email message |
+| `msg_rcptto_blacklisted_email: 'Blacklisted email message'` | Custom `RCPT TO` blacklisted email message |
+| `msg_rcptto_received: 'RCPT TO received message'` | Custom `RCPT TO` received message |
+| `msg_invalid_cmd_data_sequence: 'Invalid command DATA sequence message'` | Custom invalid command `DATA` sequence message |
+| `msg_data_received: 'DATA received message'` | Custom `DATA` received message |
+| `msg_msg_size_is_too_big: 'Message size is too big'` | Custom size is too big message |
+| `msg_msg_received: 'Message has been received'` | Custom received message body message |
+| `msg_quit_cmd: 'Quit command message'` | Custom quit command message |
+
+#### Example of usage
+
+```ruby
+# Public SmtpMock interface
+# Without kwargs creates SMTP mock server with default behaviour.
+# A free port for server will be randomly assigned in the range
+# from 49152 to 65535. Returns current smtp mock server instance
+smtp_mock_server = SmtpMock.start_server(not_registered_emails: %w[user@example.com]) # => SmtpMock::Server instance
+
+# returns current smtp mock server port
+smtp_mock_server.port # => 55640
+
+# returns current smtp mock server port
+smtp_mock_server.pid # => 38195
+
+# interface for graceful shutdown current smtp mock server
+smtp_mock_server.stop # => true
+
+# interface for force shutdown current smtp mock server
+smtp_mock_server.stop! # => true
+
+# interface to check state of current smtp mock server
+# returns true if server is running, otherwise returns false
+smtp_mock_server.active? # => true
+
+# returns list of running smtp mock servers
+SmtpMock.running_servers # => [SmtpMock::Server instance]
+
+# interface to stop all running smtp mock servers
+SmtpMock.stop_running_servers! # => true
+```
+
+### RSpec integration
+
+Require this either in your Gemfile or in RSpec's support scripts. So either:
+
+```ruby
+# Gemfile
+group :test do
+  gem 'rspec'
+  gem 'smtp_mock', require: 'smtp_mock/test_framework/rspec'
+end
+```
+
+or
+
+```ruby
+# spec/support/config/smtp_mock.rb
+require 'smtp_mock/test_framework/rspec'
+```
+
+#### SmtpMock RSpec helper
+
+Just add `SmtpMock::TestFramework::RSpec::Helper` if you wanna use shortcut `smtp_mock_server` for SmtpMock server instance inside of your `RSpec.describe` blocks:
+
+```ruby
+# spec/support/config/smtp_mock.rb
+RSpec.configure do |config|
+  config.include SmtpMock::TestFramework::RSpec::Helper
+end
+```
+
+```ruby
+# your awesome first_a_record_spec.rb
+
+RSpec.describe SmtpClient do
+  subject(:smtp_response) do
+    described_class.call(
+      host: 'localhost',
+      port: smtp_mock_server.port,
+      mailfrom: mailfrom,
+      rcptto: rcptto,
+      message: message
+    )
+  end
+
+  let(:mailfrom) { 'sender@example.com' }
+  let(:rcptto) { 'receiver@example.com' }
+  let(:message) { 'Email message context' }
+  let(:expected_response_message) { '250 Custom successful response' }
+
+  before { smtp_mock_server(msg_msg_received: expected_response_message) }
+
+  it do
+    expect(smtp_response).to be_success
+    expect(smtp_response).to have_status(expected_response_status)
+    expect(smtp_response).to have_message_context(expected_response_message)
+  end
+end
+```
+
+#### SmtpMock RSpec interface
+
+If you won't use `SmtpMock::TestFramework::RSpec::Helper` you can use `SmtpMock::TestFramework::RSpec::Interface` directly instead:
+
+```ruby
+SmtpMock::TestFramework::RSpec::Interface.start_server  # creates and runs SmtpMock server instance
+SmtpMock::TestFramework::RSpec::Interface.stop_server!  # stops and clears current SmtpMock server instance
+SmtpMock::TestFramework::RSpec::Interface.clear_server! # clears current SmtpMock server instance
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/mocktools/ruby-smtp-mock. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct. Please check the [open tickets](https://github.com/mocktools/ruby-smtp-mock/issues). Be sure to follow Contributor Code of Conduct below and our [Contributing Guidelines](CONTRIBUTING.md).
+
+## 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 SmtpMock project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](CODE_OF_CONDUCT.md).
+
+## Credits
+
+- [The Contributors](https://github.com/mocktools/ruby-smtp-mock/graphs/contributors) for code and awesome suggestions
+- [The Stargazers](https://github.com/mocktools/ruby-smtp-mock/stargazers) for showing their support
+
+## Versioning
+
+SmtpMock uses [Semantic Versioning 2.0.0](https://semver.org)

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'smtp_mock'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/bin/smtp_mock

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative '../lib/smtp_mock'
+
+SmtpMock::Cli.call(::ARGV)

data/lib/smtp_mock/cli/resolver.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module SmtpMock
+  module Cli
+    module Resolver
+      require 'optparse'
+
+      USE_CASE = 'Usage: smtp_mock [options], example: `bundle exec smtp_mock -s -i ~/existent_dir`'
+      DOWNLOAD_SCRIPT = 'https://raw.githubusercontent.com/mocktools/go-smtp-mock/master/script/download.sh'
+
+      def resolve(command_line_args) # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
+        opt_parser = ::OptionParser.new do |parser|
+          parser.banner = SmtpMock::Cli::Resolver::USE_CASE
+
+          parser.on('-s', '--sudo', 'Run command as sudo') do
+            self.sudo = true
+          end
+
+          parser.on('-iPATH', '--install=PATH', 'Install smtpmock to the existing path') do |argument|
+            self.install_path = argument
+            return self.message = 'smtpmock is already installed' if ::File.exist?(binary_path)
+
+            ::Kernel.system("cd #{install_path} && curl -sL #{SmtpMock::Cli::Resolver::DOWNLOAD_SCRIPT} | bash")
+            ::Kernel.system("#{as_sudo}ln -s #{binary_path} #{SmtpMock::Dependency::SYMLINK}")
+
+            self.message = 'smtpmock was installed successfully'
+          end
+
+          parser.on('-u', '--uninstall', 'Uninstall smtpmock') do
+            current_smtpmock_path = SmtpMock::Dependency.smtpmock_path_by_symlink
+            return self.message = 'smtpmock not installed yet' if current_smtpmock_path.empty?
+
+            ::Kernel.system("#{as_sudo}unlink #{SmtpMock::Dependency::SYMLINK}")
+            ::Kernel.system("rm #{current_smtpmock_path}")
+
+            self.message = 'smtpmock was uninstalled successfully'
+          end
+
+          self.success = true
+
+          parser.on('-h', '--help', 'Prints help') do
+            ::Kernel.puts(parser.to_s)
+            ::Kernel.exit
+          end
+        end
+
+        opt_parser.parse(command_line_args) # TODO: add error handler
+      end
+
+      private
+
+      def binary_path
+        "#{install_path}/smtpmock"
+      end
+
+      def as_sudo
+        return 'sudo ' if sudo
+      end
+    end
+  end
+end

data/lib/smtp_mock/cli.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module SmtpMock
+  module Cli
+    Command = ::Struct.new(:install_path, :sudo, :success, :message) do
+      include Resolver
+    end
+
+    def self.call(command_line_args, command = SmtpMock::Cli::Command)
+      command.new.tap do |cmd|
+        cmd.resolve(command_line_args)
+        ::Kernel.puts(cmd.message)
+        ::Kernel.exit(cmd.success ? 0 : 1)
+      end
+    end
+  end
+end

data/lib/smtp_mock/command_line_args_builder.rb

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+module SmtpMock
+  require 'dry/struct'
+
+  Types = ::Class.new { include Dry.Types }
+
+  class CommandLineArgsBuilder < Dry::Struct
+    IP_ADDRESS_PATTERN = /\A((1\d|[1-9]|2[0-4])?\d|25[0-5])(\.\g<1>){3}\z/.freeze
+    PERMITTED_ATTRS = {
+      SmtpMock::Types::Array.constrained(min_size: 1) => %i[
+        blacklisted_helo_domains
+        blacklisted_mailfrom_emails
+        blacklisted_rcptto_emails
+        not_registered_emails
+      ].freeze,
+      SmtpMock::Types::Bool.constrained(eql: true) => %i[log fail_fast].freeze,
+      SmtpMock::Types::Integer.constrained(gteq: 1) => %i[
+        port
+        session_timeout
+        shutdown_timeout
+        msg_size_limit
+      ].freeze,
+      SmtpMock::Types::String => %i[
+        msg_greeting
+        msg_invalid_cmd
+        msg_invalid_cmd_helo_sequence
+        msg_invalid_cmd_helo_arg
+        msg_helo_blacklisted_domain
+        msg_helo_received
+        msg_invalid_cmd_mailfrom_sequence
+        msg_invalid_cmd_mailfrom_arg
+        msg_mailfrom_blacklisted_email
+        msg_mailfrom_received
+        msg_invalid_cmd_rcptto_sequence
+        msg_invalid_cmd_rcptto_arg
+        msg_rcptto_not_registered_email
+        msg_rcptto_blacklisted_email
+        msg_rcptto_received
+        msg_invalid_cmd_data_sequence
+        msg_data_received
+        msg_msg_size_is_too_big
+        msg_msg_received
+        msg_quit_cmd
+      ].freeze
+    }.freeze
+
+    class << self
+      def call(**options)
+        new(options).to_command_line_args_string
+      rescue Dry::Struct::Error => error
+        raise SmtpMock::Error::Argument, error.message
+      end
+
+      private
+
+      def define_attribute
+        ->((type, attributes)) { attributes.each { |field| attribute?(field, type) } }
+      end
+    end
+
+    schema(schema.strict)
+
+    attribute?(:host, SmtpMock::Types::String.constrained(format: SmtpMock::CommandLineArgsBuilder::IP_ADDRESS_PATTERN))
+    SmtpMock::CommandLineArgsBuilder::PERMITTED_ATTRS.each(&define_attribute)
+
+    def to_command_line_args_string
+      to_h.map do |key, value|
+        key = to_camel_case(key)
+        value = format_by_type(value)
+        value ? "-#{key}=#{value}" : "-#{key}"
+      end.sort.join(' ')
+    end
+
+    private
+
+    def to_camel_case(symbol)
+      symbol.to_s.gsub(/_(\D)/) { ::Regexp.last_match(1).upcase }
+    end
+
+    def to_quoted(string)
+      "\"#{string}\""
+    end
+
+    def format_by_type(object)
+      case object
+      when ::Array then to_quoted(object.join(','))
+      when ::String then to_quoted(object)
+      when ::TrueClass then nil
+      else object
+      end
+    end
+  end
+end

data/lib/smtp_mock/core.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module SmtpMock
+  module Error
+    require_relative '../smtp_mock/error/argument'
+    require_relative '../smtp_mock/error/dependency'
+    require_relative '../smtp_mock/error/server'
+  end
+
+  require_relative '../smtp_mock/version'
+  require_relative '../smtp_mock/dependency'
+  require_relative '../smtp_mock/command_line_args_builder'
+  require_relative '../smtp_mock/cli/resolver'
+  require_relative '../smtp_mock/cli'
+  require_relative '../smtp_mock/server/port'
+  require_relative '../smtp_mock/server/process'
+  require_relative '../smtp_mock/server'
+end

data/lib/smtp_mock/dependency.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module SmtpMock
+  module Dependency
+    BINARY_SHORTCUT = 'smtpmock'
+    SYMLINK = "/usr/local/bin/#{BINARY_SHORTCUT}"
+
+    class << self
+      def smtpmock_path_by_symlink
+        ::Kernel.public_send(:`, "readlink #{SmtpMock::Dependency::SYMLINK}")
+      end
+
+      def smtpmock?
+        !smtpmock_path_by_symlink.empty?
+      end
+
+      def verify_dependencies
+        raise SmtpMock::Error::Dependency, SmtpMock::Error::Dependency::SMTPMOCK_NOT_INSTALLED unless smtpmock?
+      end
+
+      def compose_command(command_line_args)
+        "#{SmtpMock::Dependency::BINARY_SHORTCUT} #{command_line_args}".strip
+      end
+    end
+  end
+end

data/lib/smtp_mock/error/argument.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module SmtpMock
+  module Error
+    Argument = ::Class.new(::ArgumentError)
+  end
+end

data/lib/smtp_mock/error/dependency.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module SmtpMock
+  module Error
+    class Dependency < ::RuntimeError
+      SMTPMOCK_NOT_INSTALLED = 'smtpmock is required system dependency. Run `bundle exec smtp_mock -h` for details'
+    end
+  end
+end

data/lib/smtp_mock/error/server.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module SmtpMock
+  module Error
+    Server = ::Class.new(::RuntimeError)
+  end
+end

data/lib/smtp_mock/server/port.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module SmtpMock
+  class Server
+    class Port
+      require 'socket'
+
+      LOCALHOST = '127.0.0.1'
+      RANDOM_FREE_PORT = 0
+
+      class << self
+        def random_free_port
+          server = ::TCPServer.new(SmtpMock::Server::Port::LOCALHOST, SmtpMock::Server::Port::RANDOM_FREE_PORT)
+          port = server.addr[1]
+          server.close
+          port
+        end
+
+        def port_open?(port)
+          !::TCPSocket.new(SmtpMock::Server::Port::LOCALHOST, port).close
+        rescue ::Errno::ECONNREFUSED, ::Errno::EHOSTUNREACH
+          false
+        end
+      end
+    end
+  end
+end

data/lib/smtp_mock/server/process.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module SmtpMock
+  class Server
+    class Process
+      SIGNULL = 0
+      SIGKILL = 9
+      SIGTERM = 15
+      TMP_LOG_PATH = '../../../tmp/err_log'
+      WARMUP_DELAY = 0.1
+
+      class << self
+        def create(command)
+          pid = ::Process.spawn(command, err: err_log)
+          ::Kernel.sleep(SmtpMock::Server::Process::WARMUP_DELAY)
+          error_context = ::IO.readlines(err_log)[0]
+          raise SmtpMock::Error::Server, error_context.strip if error_context
+          pid
+        end
+
+        def alive?(pid)
+          ::Process.kill(SmtpMock::Server::Process::SIGNULL, pid)
+          true
+        rescue ::Errno::ESRCH
+          false
+        end
+
+        def kill(signal_number, pid)
+          ::Process.detach(pid)
+          ::Process.kill(signal_number, pid)
+          true
+        rescue ::Errno::ESRCH
+          false
+        end
+
+        private
+
+        def err_log
+          @err_log ||= ::File.expand_path(SmtpMock::Server::Process::TMP_LOG_PATH, ::File.dirname(__FILE__))
+        end
+      end
+    end
+  end
+end

data/lib/smtp_mock/server.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module SmtpMock
+  class Server
+    attr_reader :pid, :port
+
+    def initialize( # rubocop:disable Metrics/ParameterLists
+      deps_handler = SmtpMock::Dependency,
+      port_checker = SmtpMock::Server::Port,
+      args_builder = SmtpMock::CommandLineArgsBuilder,
+      process = SmtpMock::Server::Process,
+      **args
+    )
+      deps_handler.verify_dependencies
+      args[:port] = port_checker.random_free_port unless args.include?(:port)
+      @command_line_args, @port = args_builder.call(**args), args[:port]
+      @deps_handler, @port_checker, @process = deps_handler, port_checker, process
+      run
+    end
+
+    def active?
+      process_alive? && port_open?
+    end
+
+    def stop
+      process_kill(SmtpMock::Server::Process::SIGTERM)
+    end
+
+    def stop!
+      process_kill(SmtpMock::Server::Process::SIGKILL)
+    end
+
+    private
+
+    attr_reader :deps_handler, :command_line_args, :port_checker, :process
+    attr_writer :pid, :port
+
+    def process_kill(signal_number)
+      process.kill(signal_number, pid)
+    end
+
+    def compose_command
+      deps_handler.compose_command(command_line_args)
+    end
+
+    def process_alive?
+      process.alive?(pid)
+    end
+
+    def port_open?
+      port_checker.port_open?(port)
+    end
+
+    def run
+      self.pid = process.create(compose_command)
+      ::Kernel.at_exit { stop! }
+    end
+  end
+end

data/lib/smtp_mock/test_framework/rspec/helper.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require_relative './interface'
+
+module SmtpMock
+  module TestFramework
+    module RSpec
+      module Helper
+        def smtp_mock_server(**options)
+          SmtpMock::TestFramework::RSpec::Interface.start_server(**options)
+        end
+      end
+    end
+  end
+end