truemail-rspec 0.9.2 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
data/README.md DELETED
@@ -1,178 +0,0 @@
1
- # ![Truemail RSpec helpers](https://truemail-rb.org/assets/images/truemail_logo.png)
2
-
3
- [![Maintainability](https://api.codeclimate.com/v1/badges/d23d82c1c1bdbc271b81/maintainability)](https://codeclimate.com/github/truemail-rb/truemail-rspec/maintainability)
4
- [![Test Coverage](https://api.codeclimate.com/v1/badges/d23d82c1c1bdbc271b81/test_coverage)](https://codeclimate.com/github/truemail-rb/truemail-rspec/test_coverage)
5
- [![CircleCI](https://circleci.com/gh/truemail-rb/truemail-rspec/tree/master.svg?style=svg)](https://circleci.com/gh/truemail-rb/truemail-rspec/tree/master)
6
- [![Gem Version](https://badge.fury.io/rb/truemail-rspec.svg)](https://badge.fury.io/rb/truemail-rspec)
7
- [![Downloads](https://img.shields.io/gem/dt/truemail-rspec.svg?colorA=004d99&colorB=0073e6)](https://rubygems.org/gems/truemail-rspec)
8
- [![Gitter](https://badges.gitter.im/truemail-rb/community.svg)](https://gitter.im/truemail-rb/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
9
- [![GitHub](https://img.shields.io/github/license/truemail-rb/truemail-rspec)](LICENSE.txt)
10
- [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v1.4%20adopted-ff69b4.svg)](CODE_OF_CONDUCT.md)
11
-
12
- `truemail-rspec` gem helps you to create `Truemail::Configuration`, `Truemail::Auditor` and `Truemail::Validator` instances for your RSpec environment.
13
-
14
- > Actual and maintainable documentation :books: for developers is living [here](https://truemail-rb.org/truemail-rspec).
15
-
16
- ## Table of Contents
17
-
18
- - [Features](#features)
19
- - [Requirements](#requirements)
20
- - [Installation](#installation)
21
- - [Usage](#usage)
22
- - [Create configuration instance](#create-configuration-instance)
23
- - [Configuration instance with default random params](#configuration-instance-with-default-random-params)
24
- - [Configuration instance with predefined params](#configuration-instance-with-predefined-params)
25
- - [Create auditor instance](#create-auditor-instance)
26
- - [create_auditor](#create_auditor)
27
- - [Create validator instance](#create-validator-instance)
28
- - [create_servers_list](#create_servers_list)
29
- - [create_validator](#create_validator)
30
- - [Truemail family](#truemail-family)
31
- - [Contributing](#contributing)
32
- - [License](#license)
33
- - [Code of Conduct](#code-of-conduct)
34
- - [Credits](#credits)
35
- - [Versioning](#versioning)
36
- - [Changelog](CHANGELOG.md)
37
-
38
- ## Requirements
39
-
40
- Ruby MRI 2.5.0+
41
-
42
- ## Features
43
-
44
- - Ability to create `Truemail::Configuration` instance with random or with predefined params
45
- - Ability to create `Truemail::Auditor` instance with random or with predefined params
46
- - Ability to create `Truemail::Validator` instance with random or with predefined params
47
-
48
- ## Installation
49
-
50
- Add this line to your application's `Gemfile`:
51
-
52
- ```ruby
53
- group :development, :test do
54
- gem 'truemail-rspec', require: false
55
- end
56
- ```
57
-
58
- And add into your `spec_helper.rb` or `rails_helper.rb`:
59
-
60
- ```ruby
61
- require 'truemail/rspec'
62
-
63
- RSpec.configure do |config|
64
- config.include Truemail::RSpec
65
- end
66
- ```
67
-
68
- And then execute:
69
-
70
- $ bundle
71
-
72
- Or install it yourself as:
73
-
74
- $ gem install truemail-rspec
75
-
76
- ## Usage
77
-
78
- ### Create configuration instance
79
-
80
- Allows to create configuration instance with random or with predefined params.
81
-
82
- #### Configuration instance with default random params
83
-
84
- ```ruby
85
- create_configuration
86
-
87
- # => returns Truemail::Configuration instance with
88
- # random verifier_email and default Truemail::Configuration params
89
- ```
90
-
91
- #### Configuration instance with predefined params
92
-
93
- All `Truemail::Configuration` [available params](https://github.com/truemail-rb/truemail#setting-global-configuration)
94
-
95
- ```ruby
96
- create_configuration(verifier_email: 'email@domain.com', verifier_domain: 'other-domain.com')
97
- # => returns Truemail::Configuration instance with custom settings
98
- ```
99
-
100
- ### Create auditor instance
101
-
102
- Allows to create auditor instance with default random or with predefined params.
103
-
104
- #### create_auditor
105
-
106
- ```ruby
107
- create_auditor(
108
- success: true, # optional, type:Bool, by default true
109
- current_host_ip: current_host_ip, # optional, type:String, by default random IPv4 address
110
- warnings: warnings, # optional, type:Hash, by default creates auditor result warnings
111
- configuration: create_configuration # optional, type:Truemail::Configuration, by default creates random configuration
112
- )
113
-
114
- # => returns Truemail::Auditor instance follow passed params
115
- ```
116
-
117
- ### Create validator instance
118
-
119
- Allows to create validator instance with default random or with predefined params.
120
-
121
- #### create_servers_list
122
-
123
- ```ruby
124
- create_servers_list # => returns array with random ip addresses
125
- create_servers_list(42) # => returns array with 42 random ip addresses
126
- ```
127
-
128
- #### create_validator
129
-
130
- ```ruby
131
- create_validator(
132
- validation_type, # optional, type:Symbol, can be :whitelist, :regex, :mx, :mx_blacklist or :smtp, by default creates :smtp validation
133
- email, # optional, type:String, by default random email
134
- mail_servers, # optional, type:Array(String), by default array with random ip addresses
135
- success: true, # optional, type:Bool, by default true
136
- rcptto_error: 'custom context of rcptto error' # optional, type:String, by default it's equal to 'user not found'
137
- configuration: create_configuration # optional, type:Truemail::Configuration, by default creates random configuration
138
- )
139
-
140
- # => returns Truemail::Validator instance follow passed params
141
- ```
142
-
143
- ---
144
-
145
- ## Truemail family
146
-
147
- All Truemail solutions: https://truemail-rb.org
148
-
149
- | Name | Type | Description |
150
- | --- | --- | --- |
151
- | [truemail](https://github.com/truemail-rb/truemail) | ruby gem | Configurable framework agnostic plain Ruby email validator, main core |
152
- | [truemail-go](https://github.com/truemail-rb/truemail-go) | go package | Configurable Golang email validator, main core |
153
- | [truemail server](https://github.com/truemail-rb/truemail-rack) | ruby app | Lightweight rack based web API wrapper for Truemail gem |
154
- | [truemail-rack-docker](https://github.com/truemail-rb/truemail-rack-docker-image) | docker image | Lightweight rack based web API [dockerized image](https://hub.docker.com/r/truemail/truemail-rack) :whale: of Truemail server |
155
- | [truemail-ruby-client](https://github.com/truemail-rb/truemail-ruby-client) | ruby gem | Web API Ruby client for Truemail Server |
156
- | [truemail-crystal-client](https://github.com/truemail-rb/truemail-crystal-client) | crystal shard | Web API Crystal client for Truemail Server |
157
- | [truemail-java-client](https://github.com/truemail-rb/truemail-java-client) | java lib | Web API Java client for Truemail Server |
158
-
159
- ## Contributing
160
-
161
- Bug reports and pull requests are welcome on GitHub at https://github.com/truemail-rb/truemail-rspec. 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/truemail-rb/truemail-rspec/issues). Be sure to follow Contributor Code of Conduct below and our [Contributing Guidelines](CONTRIBUTING.md).
162
-
163
- ## License
164
-
165
- The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
166
-
167
- ## Code of Conduct
168
-
169
- Everyone interacting in the `truemail-rspec` project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](CODE_OF_CONDUCT.md).
170
-
171
- ## Credits
172
-
173
- - [The Contributors](https://github.com/truemail-rb/truemail-rspec/graphs/contributors) for code and awesome suggestions
174
- - [The Stargazers](https://github.com/truemail-rb/truemail-rspec/stargazers) for showing their support
175
-
176
- ## Versioning
177
-
178
- `truemail-rspec` uses [Semantic Versioning 2.0.0](https://semver.org)
data/Rakefile DELETED
@@ -1,8 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- require 'bundler/gem_tasks'
4
- require 'rspec/core/rake_task'
5
-
6
- RSpec::Core::RakeTask.new(:spec)
7
-
8
- task default: :spec