courrier 0.5.0 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 394bb78e24569d93855f2bcf788662ec8773371779b7743c5737867b893d4b38
-  data.tar.gz: 4f35baf4f3ccca75ac05cd6bc7140f2eb4585c0c95e528f1aa45bc1227ec3777
+  metadata.gz: 7b53b10ca70de7f78cc85b10132ef28629ab062421e0d8ba0c7179b69e45d98d
+  data.tar.gz: 95aecbc0697a720292f9bf3e98e32a5a50637c73367b121fdd5549c6dfbe8f9a
 SHA512:
-  metadata.gz: 387e9a879abac10ecbd97ac1a254fb08c40e48e8faf1a37f3a284dd2efd118dd70e0bf1d0032d3318914b2ddaa9242a56495547c6599dc3483844b3449114846
-  data.tar.gz: f5b458d0cc5ff6f640f0e3ffc19be8e0e6982721dcd4ff29a3dc49d42e7a3d6e9e6b0ba2d132e8f75d2a6c5edb8f6d2ae581b3076027fc9a5a48207c54ecc2ec
+  metadata.gz: 42d52645c4ee70b04ec3005c699555f17ab3f93da25096d9c240126b6765e4f00197dafba99f0eaeec873df5577bbb828e9d177877d16c7611f6a2087cfc990f
+  data.tar.gz: 03e8724821bc2452e4f838564f7e12ea3654658a20c4eb5c4c2d1b782f7f53e66972a6b88e48490c23ab652e1a8f8df710573028ac88b7c186876462bc36916e

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    courrier (0.5.0)
+    courrier (0.5.1)
       launchy (>= 3.1, < 4)
       nokogiri (>= 1.18, < 2)
 

data/README.md

@@ -2,6 +2,8 @@
 
 Modern, API-powered email delivery for Ruby apps.
 
+![A cute cartoon mascot wearing a blue postal uniform with red scarf and cap, carrying a leather messenger bag, representing a modern email delivery system for Ruby applications](https://raw.githubusercontent.com/Rails-Designer/courrier/HEAD/.github/cover.jpg)
+
 ```ruby
 # Quick example
 OrderEmail.deliver to: "recipient@railsdesigner.com"
@@ -39,6 +41,7 @@ Generate a new email:
 ```bash
 bin/rails generate courrier:email Order
 ```
+
 ```ruby
 class OrderEmail < Courrier::Email
   def subject = "Here is your order!"
@@ -55,7 +58,10 @@ class OrderEmail < Courrier::Email
     HTML
   end
 end
+
+# OrderEmail.deliver to: "recipient@railsdesigner.com"
 ```
+
 💡 Write your email content using the [Minimal Email Editor](https://railsdesigner.com/minimal-email-editor/).
 
 
@@ -80,7 +86,7 @@ end
 2. **Email class defaults**
 ```ruby
 class OrderEmail < Courrier::Email
-  configure from: "devs@railsdesigner.com",
+  configure from: "orders@railsdesigner.com",
             cc: "records@railsdesigner.com",
             provider: "mailgun",
 end
@@ -89,12 +95,61 @@ end
 3. **Instance options**
 ```ruby
 OrderEmail.deliver to: "recipient@railsdesigner.com",\
-                   from: "devs@railsdesigner.com",\
+                   from: "shop@railsdesigner.com",\
                    provider: "sendgrid",\
                    api_key: "sk_a1b1c3"
 ```
 
 
+Provider and API key settings can be overridden using environment variables (`COURRIER_PROVIDER` and `COURRIER_API_KEY`) for both global configuration and email class defaults.
+
+
+## Custom Attributes
+
+Besides the standard email attributes (`from`, `to`, `reply_to`, etc.), you can pass any additional attributes that will be available in your email templates:
+```ruby
+OrderEmail.deliver to: "recipient@railsdesigner.com", download_url: downloads_path(token: "token")
+```
+
+These custom attributes are accessible directly in your email class:
+```ruby
+def text
+  <<~TEXT
+    #{download_url}
+  TEXT
+end
+```
+
+
+## Result Object
+
+When sending an email through Courrier, a `Result` object is returned that provides information about the delivery attempt. This object offers a simple interface to check the status and access response data.
+
+
+### Available Methods
+
+| Method | Return Type | Description |
+|:-------|:-----------|:------------|
+| `success?` | Boolean | Returns `true` if the API request was successful |
+| `response` | Net::HTTP::Response | The raw HTTP response from the email provider |
+| `data` | Hash | Parsed JSON response body from the provider |
+| `error` | Exception | Contains any error that occurred during delivery |
+
+
+### Example
+
+```ruby
+delivery = OrderEmail.deliver(to: "recipient@example.com")
+
+if delivery.success?
+  puts "Email sent successfully!"
+  puts "Provider response: #{delivery.data}"
+else
+  puts "Failed to send email: #{delivery.error}"
+end
+```
+
+
 ## Providers
 
 Courrier supports these transactional email providers:
@@ -119,10 +174,10 @@ Additional functionality to help with development and email handling:
 
 Preview emails in your browser during development:
 ```ruby
-
config.provider = "preview" # Opens emails in your default browser
+
config.provider = "preview" # Opens emails in your default browser
 ```
 
-
Previews are automatically cleared with `bin/rails tmp:clear`, or manually with `bin/rails courrier:clear`.
+
Previews are automatically cleared with `bin/rails tmp:clear`, or manually with `bin/rails courrier:clear`.
 
 
 ### Layout Support
@@ -172,13 +227,13 @@ end
 
 Automatically generate plain text versions from your HTML emails:
 ```ruby
-
config.auto_generate_text = true # Defaults to false
+
config.auto_generate_text = true # Defaults to false
 ```
 
 
 ### Email Address Helper
 
-Compose RFC 2822-compliant email addresses with display names:
+Compose email addresses with display names:
 ```ruby
 class SignupsController < ApplicationController
   def create
@@ -214,9 +269,9 @@ config.logger = custom_logger # Optional: defaults to ::Logger.new($stdout)
 
 ### Custom Providers
 
-Create your own provider by inheriting from `Courrier::Email::Base`:
+Create your own provider by inheriting from `Courrier::Email::Providers::Base`:
 ```ruby
-class CustomProvider < Courrier::Email::Base
+class CustomProvider < Courrier::Email::Providers::Base
   ENDPOINT_URL = ""
 
   def body = ""

data/lib/courrier/configuration/preview.rb

@@ -14,9 +14,7 @@ module Courrier
       private
 
       def default_destination
-        return Rails.root.join("tmp", "courrier", "emails").to_s if defined?(Rails)
-
-        File.join(Dir.tmpdir, "courrier", "emails")
+        defined?(Rails) ? Rails.root.join("tmp", "courrier", "emails").to_s : File.join(Dir.tmpdir, "courrier", "emails")
       end
     end
   end

data/lib/courrier/configuration.rb

@@ -45,9 +45,7 @@ module Courrier
     private
 
     def default_email_path
-      return Rails.root.join("app", "emails").to_s if defined?(Rails)
-
-      File.join("courrier", "emails")
+      defined?(Rails) ? Rails.root.join("app", "emails").to_s : File.join("courrier", "emails")
     end
   end
 end

data/lib/courrier/email/request.rb

@@ -42,11 +42,9 @@ module Courrier
       end
 
       def body_for(request)
-        if requires_multipart_form?
-          set_multipart_form(request)
-        else
-          set_json_body(request)
-        end
+        return set_multipart_form(request) if requires_multipart_form?
+
+        set_json_body(request)
       end
 
       def default_headers

data/lib/courrier/email.rb

@@ -49,7 +49,7 @@ module Courrier
 
     def initialize(options = {})
       @provider = options[:provider] || ENV["COURRIER_PROVIDER"] || self.class.provider || Courrier.configuration&.provider
-      @api_key = options[:api_key] || ENV["COURRIER_PROVIDER"] || self.class.api_key || Courrier.configuration&.api_key
+      @api_key = options[:api_key] || ENV["COURRIER_API_KEY"] || self.class.api_key || Courrier.configuration&.api_key
 
       @default_url_options = self.class.default_url_options.merge(options[:default_url_options] || {})
       @context_options = options.except(:provider, :api_key, :from, :to, :reply_to, :cc, :bcc, :subject, :text, :html)

data/lib/courrier/version.rb

@@ -1,3 +1,3 @@
 module Courrier
-  VERSION = "0.5.0"
+  VERSION = "0.5.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: courrier
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.5.1
 platform: ruby
 authors:
 - Rails Designer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-05-09 00:00:00.000000000 Z
+date: 2025-05-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: launchy