Ce Ruby Gem offre une intégration avec l'API officielle pour MailTrap.
Ajoutez rapidement des fonctionnalités d'envoi d'e-mail à votre application Ruby avec MailTrap.
(Ce client utilise l'API V2, pour V1 Reportez-vous à cette documentation)
Ajoutez cette ligne à Gemfile de votre application:
gem 'mailtrap'
Puis exécuter:
$ bundle install
Ou installez-le vous-même comme:
$ gem install mailtrap
# place this code in config/environments/production.rb:
config . action_mailer . delivery_method = :mailtrap
# then set the MAILTRAP_API_KEY environment variable
# using your hosting solution.
require 'mailtrap'
# create mail object
mail = Mailtrap :: Mail :: Base . new (
from : { email : '[email protected]' , name : 'Mailtrap Test' } ,
to : [
{ email : '[email protected]' }
] ,
subject : 'You are awesome!' ,
text : "Congrats for sending test email with Mailtrap!"
)
# create client and send
client = Mailtrap :: Client . new ( api_key : 'your-api-key' )
client . send ( mail )
Reportez-vous au dossier examples
pour plus d'exemples.
mailtrap
GEM utilise l'API MailTrap pour envoyer des e-mails. L'API MailTrap n'essaie pas de reproduire SMTP. C'est pourquoi vous devriez vous attendre à certaines limites en matière d'envoi. Par exemple, /api/send
Endpoint ignore Content-Transfer-Encoding
(voir headers
dans la documentation de l'API). Ce qui signifie que vos destinataires ne recevront des e-mails que dans le codage par défaut qui est quoted-printable
, si vous envoyez une API MailTrap.
Pour ceux qui ont besoin d'utiliser 7bit
ou tout autre encodage, SMTP offre une meilleure flexibilité à cet égard. Accédez à votre compte MailTrap → Email Envoi → Envoi de domaines → Votre domaine → Paramètres SMTP / API Pour trouver l'exemple de configuration SMTP.
Changer Mailtrap::Sending::Client
à Mailtrap::Client
.
Si vous utilisez des classes qui ont Sending
d'espace de noms, supprimez l'espace de noms comme dans l'exemple ci-dessus.
Après avoir vérifié le dépôt, exécutez bin/setup
pour installer des dépendances. Ensuite, exécutez rake spec
pour exécuter les tests. Vous pouvez également exécuter bin/console
pour une invite interactive qui vous permettra d'expérimenter.
Pour installer ce gemme sur votre machine locale, exécutez bundle exec rake install
. Pour publier une nouvelle version, mettez à jour le numéro de version dans version.rb
, puis exécutez bundle exec rake release
, qui créera une balise GIT pour la version, pousse Git Commits et la balise créée, et pousse le fichier .gem
sur RubyGems. org.
Les rapports de bogues et les demandes de traction sont les bienvenus sur GitHub. Ce projet est destiné à être un espace sûr et accueillant pour la collaboration, et les contributeurs devraient adhérer au code de conduite.
Le GEM est disponible en open source en vertu des termes de la licence du MIT.
Tout le monde interagit dans les bases de code, les trackers des problèmes, les salles de discussion et les listes de diffusion du CodeTrap devrait suivre le code de conduite.