receipts 1.0.4 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa3e56021ccff37e48f340cea424f548b1f52c6782203cde1002049a1f470571
-  data.tar.gz: db562a59a36abcc235718f59420bc730ddcb70a3b057536df824692cfbfd4909
+  metadata.gz: 875a1ff6a3a1dcca7a1de7c21362ce0837426c3f5b3299cd9f15f38daf97cfa2
+  data.tar.gz: 2aed77f22588a1675b558eccbe1122cc94912e04fa692aacaa7a40b16429495e
 SHA512:
-  metadata.gz: a2ed85aa3947b15ca345d01b88e9f267335e181ef4a8950b496cd99c4d9c9187844d92f993b82dfc3018ece6dcee9765777842135d330dbe61e08599676b43d8
-  data.tar.gz: 9d2c8edb71e5d0204431f2053bb1a8518a8e766201950327c0581c8c4914d7edee96ea1f435ee9dd4c800d687886f79dcc6e97596a0cd689fadf6b827d30dcd9
+  metadata.gz: f54fc0957bccf87ebd1ae377d275f9dfe0f39a8b2cd0e8c4b5a96635183abd24f229eea142631a98d5a61156fc87cd366864e35a044a53e60ec072de08ada3e5
+  data.tar.gz: 87745a1fe2f9cb84c69a00d816e254c4cc7b2dfee02457ece89d9e543a39b65813bfd427e7fa789e5a56feea1a3837ac3e8cc5d4574e4894805b535de76cf630

data/CHANGELOG.md

@@ -1,3 +1,26 @@
+### Unreleased
+
+### 2.0.0
+
+* New, consistent layouts between Receipts, Invoices, and Statements - @excid3
+* PDFs can now be completely customized - @excid3
+* Add line_items to Receipts - @excid3
+
+### 1.2.0
+
+* Update design to give more room for longer product names, addresses, etc - @excid3
+
+### 1.1.1
+
+* [FIX] Use `URI.parse().open` instead - @excid3 @reckerswartz
+* Add I18n notes to the readme - @excid3 @reckerswartz
+* Add standardrb formatting - @excid3
+* Add GitHub Actions for standardrb and tests - @excid3
+
+### 1.1.0
+
+* [NEW] Add Statements - @anquinn
+
 ### 1.0.3
 
 * [FIX] Fixes typo introduced in 1.0.2

data/Gemfile

@@ -1,4 +1,9 @@
-source 'https://rubygems.org'
+source "https://rubygems.org"
 
 # Specify your gem's dependencies in receipts.gemspec
 gemspec
+
+gem "minitest", "~> 5.0"
+gem "rake", "~> 13.0"
+gem "standard"
+gem "matrix", "~> 0.4"

data/README.md

@@ -1,10 +1,10 @@
 ![travisci](https://api.travis-ci.org/excid3/receipts.svg)
 
-# Receipts
+# Receipts Gem
 
-Receipts for your Rails application that works with any payment provider.
+Receipts, Invoices, and Statements for your Rails application that works with any payment provider. Receipts uses Prawn to generate the PDFs.
 
-Check out the [example receipt](https://github.com/excid3/receipts/blob/master/examples/receipt.pdf?raw=true) and [example invoice](https://github.com/excid3/receipts/blob/master/examples/invoice.pdf?raw=true) PDFs.
+Check out the [example PDFs](https://github.com/excid3/receipts/blob/master/examples/).
 
 ## Installation
 
@@ -24,127 +24,157 @@ Or install it yourself as:
 
 ## Usage
 
-Adding receipts to your application is pretty simple. All you need is a
-model that stores your transaction details. In this example our
-application has a model named `Charge` that we will use.
-
-We're going to add a method called `receipt` on our model called `Charge`
-that will create a new receipt for the charge using attributes from the
-model.
-
-Video Tutorial:
-[GoRails Episode #51](https://gorails.com/episodes/pdf-receipts)
+To generate a Receipt, Invoice, or Statement, create an instance and provide content to render:
 
 ```ruby
-# == Schema Information
-#
-# Table name: charges
-#
-#  id             :integer          not null, primary key
-#  user_id        :integer
-#  stripe_id      :string(255)
-#  amount         :integer
-#  card_last4     :string(255)
-#  card_type      :string(255)
-#  card_exp_month :integer
-#  card_exp_year  :integer
-#  uuid           :string
-#  created_at     :datetime
-#  updated_at     :datetime
-#
-
-class Charge < ActiveRecord::Base
-  belongs_to :user
-  validates :stripe_id, uniqueness: true
-
-  def receipt
-    Receipts::Receipt.new(
-      id: id,
-      subheading: "RECEIPT FOR CHARGE #%{id}",
-      product: "GoRails",
-      company: {
-        name: "GoRails, LLC.",
-        address: "123 Fake Street\nNew York City, NY 10012",
-        email: "support@example.com",
-        logo: Rails.root.join("app/assets/images/logo.png")
-      },
-      line_items: [
-        ["Date",           created_at.to_s],
-        ["Account Billed", "#{user.name} (#{user.email})"],
-        ["Product",        "GoRails"],
-        ["Amount",         "$#{amount / 100}.00"],
-        ["Charged to",     "#{card_type} (**** **** **** #{card_last4})"],
-        ["Transaction ID", uuid]
-      ],
-      font: {
-        bold: Rails.root.join('app/assets/fonts/tradegothic/TradeGothic-Bold.ttf'),
-        normal: Rails.root.join('app/assets/fonts/tradegothic/TradeGothic.ttf'),
-      }
-    )
-  end
-end
+r = Receipts::Receipt.new(
+  details: [
+    ["Receipt Number", "123"],
+    ["Date paid", Date.today],
+    ["Payment method", "ACH super long super long super long super long super long"]
+  ],
+  company: {
+    name: "Example, LLC",
+    address: "123 Fake Street\nNew York City, NY 10012",
+    email: "support@example.com",
+    logo: File.expand_path("./examples/images/logo.png")
+  },
+  recipient: [
+    "Customer",
+    "Their Address",
+    "City, State Zipcode",
+    nil,
+    "customer@example.org"
+  ],
+  line_items: [
+    ["<b>Item</b>", "<b>Unit Cost</b>", "<b>Quantity</b>", "<b>Amount</b>"],
+    ["Subscription", "$19.00", "1", "$19.00"],
+    [nil, nil, "Subtotal", "$19.00"],
+    [nil, nil, "Tax", "$1.12"],
+    [nil, nil, "Total", "$20.12"],
+    [nil, nil, "<b>Amount paid</b>", "$20.12"],
+    [nil, nil, "Refunded on #{Date.today}", "$5.00"]
+  ],
+  footer: "Thanks for your business. Please contact us if you have any questions."
+)
+
+# Returns a string of the raw PDF
+r.render 
+
+# Writes the PDF to disk
+r.render_file "examples/receipt.pdf"
 ```
 
-Update the options for the receipt according to the data you want to
-display.
+### Options
+
+You can pass the following options to generate a PDF:
+
+* `recipient` - Array of customer details to include. Typically, this is name, address, email, VAT ID, etc.
+
+* `company` - Hash of your company details
+
+  * `name` - Company name
+
+  * `address` - Company address
+
+  * `email` - Company support email address
 
-## Customizing Your Receipts
+  * `phone` - Company phone number - _Optional_
 
-* `id` - **Required**
+  * `logo` - Logo to be displayed on the receipt - _Optional_
+    This can be either a Path, File, StringIO, or URL. Here are a few examples:
 
-This sets the ID of the charge on the receipt
+    ```ruby
+    logo: Rails.root.join("app/assets/images/logo.png")
+    logo: File.expand_path("./logo.png")
+    logo: File.open("app/assets/images/logo.png", "rb")
+    logo: "https://www.ruby-lang.org/images/header-ruby-logo@2x.png" # Downloaded with OpenURI
+    ```
 
-* `product` or `message` - **Required**
+* `details` - Array of details about the Receipt, Invoice, Statement. Typically, this is receipt numbers, issue date, due date, status, etc.
 
-You can set either the product or message options. If you set product, it will use the default message. If you want a custom message, you can set the message option to populate it with custom text.
+* `line_items` - Array of line items to be displayed in table format.
 
-* `company` - **Required**
+* `footer` - String for a message at the bottom of the PDF.
 
-Company consists of several required nested attributes.
+* `font` - Hash of paths to font files - _Optional_
+
+  ```ruby
+  font: {
+    bold: Rails.root.join('app/assets/fonts/tradegothic/TradeGothic-Bold.ttf'),
+    normal: Rails.root.join('app/assets/fonts/tradegothic/TradeGothic.ttf'),
+  }
+  ```
+
+Here's an example of where each option is displayed.
+
+![options](examples/images/options.jpg)
+
+### Formatting
+
+`details` and `line_items` allow inline formatting with Prawn. This allows you to use HTML tags to format text: `<b>` `<i>` `<u>` `<strikethrough>` `<sub>` `<sup>` `<font>` `<color>` `<link>` 
+
+See [the Prawn docs](https://prawnpdf.org/api-docs/2.3.0/Prawn/Text.html#text-instance_method) for more information.
+
+### Internationalization (I18n)
+
+You can use `I18n.t` when rendering your receipts to internationalize them.
+
+```ruby
+line_items: [
+  [I18n.t("receipts.date"),           created_at.to_s],
+  [I18n.t("receipts.product"), "GoRails"],
+  [I18n.t("receipts.transaction"), uuid]
+]
+```
 
-  * `name` - **Required**
-  * `address` - **Required**
-  * `email` - **Required**
-  * `line_items` - **Required**
+### Custom PDF Content
 
-You can set as many line items on the receipts as you want. Just pass in an array with each item containing a name and a value to display on the receipt.
+You can change the entire PDF content by instantiating an Receipts object without any options.
 
-  * `logo` - *Optional*
+```ruby
+receipt = Receipts::Receipt.new # creates an empty PDF
+```
 
-The logo must be either a string path to a file or a file-like object.
+Each Receipts object inherits from Prawn::Document. This allows you to choose what is rendered and include any custom Prawn content you like.
 
 ```ruby
-logo: Rails.root.join("app/assets/images/logo.png")
-# or
-logo: File.open("app/assets/images/logo.png", "rb")
+receipt.text("hello world")
 ```
 
-To use an image from a URL, we recommend using `open-uri` to open the remote file as a StringIO object.
+You can also use the Receipts helpers in your custom PDFs at the current cursor position.
+
+```ruby
+receipt.text("Custom header")
+receipt.render_line_items([
+  ["my line items"]
+])
+receipt.render_footer("This is a custom footer using the Receipts helper")
+```
 
-`require 'open-uri'`
+### Rendering PDFs
 
-`logo: URI.open("https://www.ruby-lang.org/images/header-ruby-logo@2x.png")`
+To render a PDF in memory, use `render`. This is recommended for serving PDFs in your Rails controllers.
 
-* `font` - *Optional*
+```ruby
+receipt.render
+```
 
-If you'd like to use your own custom font, you can pass in the file paths to the `normal` and `bold` variations of your font. The bold font variation is required because it is used in the default message. If you wish to override that, you can pass in your own custom message instead.
+To render a PDF to disk, use `render_file`:
 
+```ruby
+receipt.render_file "receipt.pdf"
+```
 
-## Rendering the Receipt PDF in your Controller
+## Rendering PDFs in Rails controller actions
 
-Here we have a charges controller that responds to the show action. When
-you visit it with the PDF format, it calls the `receipt` method that we
-just created on the `Charge` model.
+Here's an example Rails controller action you can use for serving PDFs. We'll first look up the database record for the `Charge` we want to render a receipt for.
 
-We set the filename to be the date plus the product name. You can
-customize the filename to your liking.
+The `Charge` model has a `receipt` method that returns a `Receipts::Receipt` instance with all the receipt data filled out.
 
-Next we set the response type which will be `application/pdf`
+Then we can `render` to generate the PDF in memory. This produces a String with the raw PDF data in it.
 
-Optionally we can set the `disposition` to `:inline` which allows us to
-render the PDF in the browser without forcing the download. If you
-delete this option or change it to `:attachment` then the receipt will
-be downloaded instead.
+Using `send_data` from Rails, we can send the PDF contents and provide the browser with a recommended filename, content type and disposition.
 
 ```ruby
 class ChargesController < ApplicationController
@@ -153,12 +183,7 @@ class ChargesController < ApplicationController
 
   def show
     respond_to do |format|
-      format.pdf {
-        send_data @charge.receipt.render,
-          filename: "#{@charge.created_at.strftime("%Y-%m-%d")}-gorails-receipt.pdf",
-          type: "application/pdf",
-          disposition: :inline
-      }
+      format.pdf { send_pdf }
     end
   end
 
@@ -167,13 +192,18 @@ class ChargesController < ApplicationController
     def set_charge
       @charge = current_user.charges.find(params[:id])
     end
+  
+  	def send_pdf
+      # Render the PDF in memory and send as the response
+      send_data @charge.receipt.render,
+          filename: "#{@charge.created_at.strftime("%Y-%m-%d")}-gorails-receipt.pdf",
+          type: "application/pdf",
+          disposition: :inline # or :attachment to download
+    end
 end
 ```
 
-And that's it! Just create a `link_to` to your charge with the format of
-`pdf` and you're good to go.
-
-For example:
+Then, just `link_to` to your charge with the format of `pdf`. For example:
 
 ```ruby
 # config/routes.rb
@@ -181,50 +211,78 @@ resources :charges
 ```
 
 ```erb
-<%= link_to "Download Receipt", charge_path(@charge, format: :pdf) %>
+<%= link_to "View Receipt", charge_path(@charge, format: :pdf) %>
 ```
 
 ## Invoices
 
-Invoices follow the exact same set of steps as above, with a few minor changes and have a few extra arguments you can use:
-
-* `issue_date` - Date the invoice was issued
-
-* `due_date` - Date the invoice payment is due
+Invoices follow the exact same set of steps as above. You'll simply want to modify the `details` to include other information for the Invoice such as the Issue Date, Due Date, etc.
 
-* `status` - A status for the invoice (Pending, Paid, etc)
+```ruby
+Receipts::Invoice.new(
+  details: [
+    ["Invoice Number", "123"],
+    ["Issue Date", Date.today.strftime("%B %d, %Y")],
+    ["Due Date", Date.today.strftime("%B %d, %Y")],
+    ["Status", "<b><color rgb='#5eba7d'>PAID</color></b>"]
+  ],
+  recipient: [
+    "<b>Bill To</b>",
+    "Customer",
+    "Address",
+    "City, State Zipcode",
+    "customer@example.org"
+  ],
+  company: {
+    name: "Example, LLC",
+    address: "123 Fake Street\nNew York City, NY 10012",
+    phone: "(555) 867-5309",
+    email: "support@example.com",
+    logo: File.expand_path("./examples/images/logo.png")
+  },
+  line_items: [
+    ["<b>Item</b>", "<b>Unit Cost</b>", "<b>Quantity</b>", "<b>Amount</b>"],
+    ["Subscription", "$19.00", "1", "$19.00"],
+    [nil, nil, "Subtotal", "$19.00"],
+    [nil, nil, "Tax Rate", "0%"],
+    [nil, nil, "Amount Due", "$19.00"]
+  ]
+)
+```
 
-* `bill_to` - A string or Array of lines with billing details
+## Statements
 
-You can also use line_items to flexibly generate and display the table with items in it, including subtotal, taxes, and total amount.
+Statements follow the exact same set of steps as above. You'll simply want to modify the `details` to include other information for the Invoice such as the Issue Date, Start and End Dates, etc.
 
 ```ruby
-  Receipts::Invoice.new(
-    id: "123",
-    issue_date: Date.today,
-    due_date: Date.today + 30,
-    status: "<b><color rgb='#5eba7d'>PAID</color></b>",
-    bill_to: [
-      "GoRails, LLC",
-      "123 Fake Street",
-      "New York City, NY 10012",
-      nil,
-      "mail@example.com",
-    ],
-    company: {
-      name: "GoRails, LLC",
-      address: "123 Fake Street\nNew York City, NY 10012",
-      email: "support@example.com",
-      logo: File.expand_path("./examples/gorails.png")
-    },
-    line_items: [
-      ["<b>Item</b>", "<b>Unit Cost</b>", "<b>Quantity</b>", "<b>Amount</b>"],
-      ["GoRails Subscription", "$19.00", "1", "$19.00"],
-      [nil, nil, "Subtotal", "$19.00"],
-      [nil, nil, "Tax Rate", "0%"],
-      [nil, nil, "Total", "$19.00"],
-    ],
-  )
+Receipts::Statement.new(
+  details: [
+    ["Statement Number", "123"],
+    ["Issue Date", Date.today.strftime("%B %d, %Y")],
+    ["Period", "#{(Date.today - 30).strftime("%B %d, %Y")} - #{Date.today.strftime("%B %d, %Y")}"]
+  ],
+  recipient: [
+    "<b>Bill To</b>",
+    "Customer",
+    "Address",
+    "City, State Zipcode",
+    "customer@example.org"
+  ],
+  company: {
+    name: "Example, LLC",
+    address: "123 Fake Street\nNew York City, NY 10012",
+    email: "support@example.com",
+    phone: "(555) 867-5309",
+    logo: File.expand_path("./examples/images/logo.png")
+  },
+  line_items: [
+    ["<b>Item</b>", "<b>Unit Cost</b>", "<b>Quantity</b>", "<b>Amount</b>"],
+    ["Subscription", "$19.00", "1", "$19.00"],
+    [nil, nil, "Subtotal", "$19.00"],
+    [nil, nil, "Tax Rate", "0%"],
+    [nil, nil, "Total", "$19.00"]
+  ]
+)
 ```
 
 ## Contributing

data/Rakefile

@@ -1,70 +1,126 @@
+# frozen_string_literal: true
+
 require "bundler/gem_tasks"
-require "rspec/core/rake_task"
-require "open-uri"
+require "rake/testtask"
 
-RSpec::Core::RakeTask.new('spec')
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/test_*.rb"]
+end
 
-# If you want to make this the default task
-task :default => :spec
-task :test => :spec
+task default: :test
 
 task :console do
   exec "irb -r receipts -I ./lib"
 end
 
+task :examples do
+  [:receipt, :invoice, :statement].each { |t| Rake::Task[t].invoke }
+  puts "Use `open examples` to view example PDFs."
+end
+
 task :receipt do
   require "./lib/receipts"
 
-  Receipts::Receipt.new(
-    id: "123",
-    subheading: "RECEIPT FOR CHARGE #1",
-    product: "GoRails",
+  r = Receipts::Receipt.new(
+    recipient: [
+      "<b>Bill To</b>",
+      "Customer",
+      "Address",
+      "City, State Zipcode",
+      "customer@example.org"
+    ],
     company: {
-      name: "GoRails, LLC",
+      name: "Example, LLC",
       address: "123 Fake Street\nNew York City, NY 10012",
+      phone: "(555) 867-5309",
       email: "support@example.com",
-      logo: URI.open("https://www.ruby-lang.org/images/header-ruby-logo@2x.png")
+      logo: File.expand_path("./examples/images/logo.png")
     },
-    line_items: [
-      ["Date",           Time.now.to_s],
-      ["Account Billed", "Example User (user@example.com)"],
-      ["Product",        "GoRails"],
-      ["Amount",         "$19.00"],
-      ["Charged to",     "Visa (**** **** **** 1234)"],
-      ["Transaction ID", "123456"]
+    details: [
+      ["Receipt Number", "123"],
+      ["Date paid", Date.today.strftime("%B %d, %Y")],
+      ["Payment method", "ACH super long super long super long super long super long"]
     ],
-  ).render_file "examples/receipt.pdf"
+    line_items: [
+      ["<b>Item</b>", "<b>Unit Cost</b>", "<b>Quantity</b>", "<b>Amount</b>"],
+      ["Subscription", "$19.00", "1", "$19.00"],
+      [nil, nil, "Subtotal", "$19.00"],
+      [nil, nil, "Tax", "$1.12"],
+      [nil, nil, "Total", "$20.12"],
+      [nil, nil, "<b>Amount paid</b>", "$20.12"],
+      [nil, nil, "Refunded on #{Date.today.strftime("%B %d, %Y")}", "$5.00"]
+    ]
+  )
+  r.render_file "examples/receipt.pdf"
 end
 
 task :invoice do
   require "./lib/receipts"
 
   Receipts::Invoice.new(
-    id: "123",
-    issue_date: Date.today,
-    due_date: Date.today + 30,
-    status: "<b><color rgb='#5eba7d'>PAID</color></b>",
-    bill_to: [
-      "GoRails, LLC",
+    details: [
+      ["Invoice Number", "123"],
+      ["Issue Date", Date.today.strftime("%B %d, %Y")],
+      ["Due Date", Date.today.strftime("%B %d, %Y")],
+      ["Status", "<b><color rgb='#5eba7d'>PAID</color></b>"]
+    ],
+    recipient: [
+      "<b>Bill To</b>",
+      "Customer",
       "Address",
       "City, State Zipcode",
-      nil,
-      "mail@example.com",
+      "customer@example.org"
     ],
     company: {
-      name: "GoRails, LLC",
+      name: "Example, LLC",
       address: "123 Fake Street\nNew York City, NY 10012",
+      phone: "(555) 867-5309",
       email: "support@example.com",
-      #logo: Rails.root.join("app/assets/images/gorails.png")
-      #logo: File.expand_path("./examples/gorails.png")
-      logo: File.open("./examples/gorails.png")
+      # logo: Rails.root.join("app/assets/images/logo.png")
+      # logo: File.open("./examples/images/logo.png")
+      logo: File.expand_path("./examples/images/logo.png")
     },
     line_items: [
       ["<b>Item</b>", "<b>Unit Cost</b>", "<b>Quantity</b>", "<b>Amount</b>"],
-      ["GoRails Subscription", "$19.00", "1", "$19.00"],
+      ["Subscription", "$19.00", "1", "$19.00"],
       [nil, nil, "Subtotal", "$19.00"],
       [nil, nil, "Tax Rate", "0%"],
-      [nil, nil, "Amount Due", "$19.00"],
-    ],
+      [nil, nil, "Amount Due", "$19.00"]
+    ]
   ).render_file "examples/invoice.pdf"
 end
+
+task :statement do
+  require "./lib/receipts"
+
+  Receipts::Statement.new(
+    details: [
+      ["Statement Number", "123"],
+      ["Issue Date", Date.today.strftime("%B %d, %Y")],
+      ["Period", "#{(Date.today - 30).strftime("%B %d, %Y")} - #{Date.today.strftime("%B %d, %Y")}"]
+    ],
+    recipient: [
+      "<b>Bill To</b>",
+      "Customer",
+      "Address",
+      "City, State Zipcode",
+      "customer@example.org"
+    ],
+    company: {
+      name: "Example, LLC",
+      address: "123 Fake Street\nNew York City, NY 10012",
+      email: "support@example.com",
+      phone: "(555) 867-5309",
+      logo: File.expand_path("./examples/images/logo.png")
+    },
+    line_items: [
+      ["<b>Item</b>", "<b>Unit Cost</b>", "<b>Quantity</b>", "<b>Amount</b>"],
+      ["Subscription", "$19.00", "1", "$19.00"],
+      [nil, nil, "Subtotal", "$19.00"],
+      [nil, nil, "Tax Rate", "0%"],
+      [nil, nil, "Total", "$19.00"]
+    ]
+  ).render_file "examples/statement.pdf"
+end

data/lib/receipts/base.rb

@@ -0,0 +1,102 @@
+module Receipts
+  class Base < Prawn::Document
+    attr_accessor :title, :company
+
+    class << self
+      attr_reader :title
+    end
+
+    def initialize(attributes = {})
+      super(page_size: "LETTER")
+      setup_fonts attributes[:font]
+
+      @title = attributes.fetch(:title, self.class.title)
+
+      generate_from(attributes)
+    end
+
+    def generate_from(attributes)
+      return if attributes.empty?
+
+      company = attributes.fetch(:company)
+      header company: company
+      render_details attributes.fetch(:details)
+      render_billing_details company: company, recipient: attributes.fetch(:recipient)
+      render_line_items attributes.fetch(:line_items)
+      render_footer attributes.fetch(:footer, default_message(company: company))
+    end
+
+    def setup_fonts(custom_font = nil)
+      if !!custom_font
+        font_families.update "Primary" => custom_font
+        font "Primary"
+      end
+
+      font_size 8
+    end
+
+    def load_image(logo)
+      if logo.is_a? String
+        logo.start_with?("http") ? URI.parse(logo).open : File.open(logo)
+      else
+        logo
+      end
+    end
+
+    def header(company: {}, height: 16)
+      logo = company[:logo]
+
+      if logo.nil?
+        text company.fetch(:name), align: :right, style: :bold, size: 16, color: "4b5563"
+      else
+        image load_image(logo), height: height, position: :right
+      end
+
+      move_up height
+      text title, style: :bold, size: 16
+    end
+
+    def render_details(details, margin_top: 16)
+      move_down margin_top
+      table(details, cell_style: {borders: [], inline_format: true, padding: [0, 8, 2, 0]})
+    end
+
+    def render_billing_details(company:, recipient:, margin_top: 16)
+      move_down margin_top
+
+      company_details = [
+        company[:address],
+        company[:phone],
+        company[:email]
+      ].compact.join("\n")
+
+      line_items = [
+        [
+          {content: "<b>#{company.fetch(:name)}</b>\n#{company_details}", padding: [0, 12, 0, 0]},
+          {content: Array(recipient).join("\n"), padding: [0, 12, 0, 0]}
+        ]
+      ]
+      table(line_items, width: bounds.width, cell_style: {borders: [], inline_format: true, overflow: :expand})
+    end
+
+    def render_line_items(line_items, margin_top: 30)
+      move_down margin_top
+
+      borders = line_items.length - 2
+      table(line_items, width: bounds.width, cell_style: {border_color: "eeeeee", inline_format: true}) do
+        cells.padding = 6
+        cells.borders = []
+        row(0..borders).borders = [:bottom]
+      end
+    end
+
+    def render_footer(message, margin_top: 30)
+      move_down margin_top
+      text message, inline_format: true
+    end
+
+    def default_message(company:)
+      "For questions, contact us anytime at <color rgb='326d92'><link href='mailto:#{company.fetch(:email)}?subject=Question about my receipt'><b>#{company.fetch(:email)}</b></link></color>."
+    end
+  end
+end

data/lib/receipts/invoice.rb

@@ -1,125 +1,5 @@
-require 'prawn'
-require 'prawn/table'
-
 module Receipts
-  class Invoice < Prawn::Document
-    attr_reader :attributes, :id, :company, :custom_font, :line_items, :logo, :message, :product, :subheading, :bill_to, :issue_date, :due_date, :status
-
-    def initialize(attributes)
-      @attributes  = attributes
-      @id          = attributes.fetch(:id)
-      @company     = attributes.fetch(:company)
-      @line_items  = attributes.fetch(:line_items)
-      @custom_font = attributes.fetch(:font, {})
-      @message     = attributes.fetch(:message) { default_message }
-      @subheading  = attributes.fetch(:subheading) { default_subheading }
-      @bill_to     = Array(attributes.fetch(:bill_to)).join("\n")
-      @issue_date  = attributes.fetch(:issue_date)
-      @due_date    = attributes.fetch(:due_date)
-      @status      = attributes.fetch(:status)
-
-      super(margin: 0)
-
-      setup_fonts if custom_font.any?
-      generate
-    end
-
-    private
-
-      def default_message
-        "For questions, contact us anytime at <color rgb='326d92'><link href='mailto:#{company.fetch(:email)}?subject=Charge ##{id}'><b>#{company.fetch(:email)}</b></link></color>."
-      end
-
-      def default_subheading
-        "INVOICE #%{id}"
-      end
-
-      def setup_fonts
-        font_families.update "Primary" => custom_font
-        font "Primary"
-      end
-
-      def generate
-        bounding_box [0, 792], width: 612, height: 792 do
-          bounding_box [85, 792], width: 442, height: 792 do
-            header
-            charge_details
-            footer
-          end
-        end
-      end
-
-      def header
-        move_down 60
-
-        logo = company[:logo]
-
-        if logo.nil?
-          move_down 32
-        elsif logo.is_a?(String)
-          image open(logo), height: 32
-        else
-          image logo, height: 32
-        end
-
-        move_down 8
-        label (subheading % {id: id})
-
-        move_down 10
-
-        # Cache the Y value so we can have both boxes at the same height
-        top = y
-        bounding_box([0, y], width: 200) do
-          label "BILL TO"
-
-          move_down 5
-          text_box bill_to, at: [0, cursor], width: 200, height: 75, inline_format: true, size: 10, leading: 4, overflow: :shrink_to_fit
-
-        end
-
-        bounding_box([250, top], width: 200) do
-          label "INVOICE DATE"
-
-          move_down 5
-          text issue_date.to_s, inline_format: true, size: 12, leading: 4
-
-          move_down 10
-          label "DUE DATE"
-
-          move_down 5
-          text due_date.to_s, inline_format: true, size: 12, leading: 4
-
-          move_down 10
-          label "STATUS"
-
-          move_down 5
-          text status, inline_format: true, size: 12, leading: 4
-        end
-      end
-
-      def charge_details
-        move_down 30
-
-        borders = line_items.length - 2
-
-        table(line_items, width: bounds.width, cell_style: { border_color: 'cccccc', inline_format: true }) do
-          cells.padding = 12
-          cells.borders = []
-          row(0..borders).borders = [:bottom]
-        end
-      end
-
-      def footer
-        move_down 30
-        text message, inline_format: true, size: 12, leading: 4
-
-        move_down 30
-        text company.fetch(:name), inline_format: true
-        text "<color rgb='888888'>#{company.fetch(:address)}</color>", inline_format: true
-      end
-
-      def label(text)
-        text "<color rgb='a6a6a6'>#{text}</color>", inline_format: true, size: 8
-      end
+  class Invoice < Base
+    @title = "Invoice"
   end
 end

data/lib/receipts/receipt.rb

@@ -1,86 +1,5 @@
-require 'prawn'
-require 'prawn/table'
-
 module Receipts
-  class Receipt < Prawn::Document
-    attr_reader :attributes, :id, :company, :custom_font, :line_items, :logo, :message, :product, :subheading
-
-    def initialize(attributes)
-      @attributes  = attributes
-      @id          = attributes.fetch(:id)
-      @company     = attributes.fetch(:company)
-      @line_items  = attributes.fetch(:line_items)
-      @custom_font = attributes.fetch(:font, {})
-      @message     = attributes.fetch(:message) { default_message }
-      @subheading  = attributes.fetch(:subheading) { default_subheading }
-
-      super(margin: 0)
-
-      setup_fonts if custom_font.any?
-      generate
-    end
-
-    private
-
-      def default_message
-        "We've received your payment for #{attributes.fetch(:product)}. You can keep this receipt for your records. For questions, contact us anytime at <color rgb='326d92'><link href='mailto:#{company.fetch(:email)}?subject=Charge ##{id}'><b>#{company.fetch(:email)}</b></link></color>."
-      end
-
-      def default_subheading
-        "RECEIPT FOR CHARGE #%{id}"
-      end
-
-      def setup_fonts
-        font_families.update "Primary" => custom_font
-        font "Primary"
-      end
-
-      def generate
-        bounding_box [0, 792], width: 612, height: 792 do
-          bounding_box [85, 792], width: 442, height: 792 do
-            header
-            charge_details
-            footer
-          end
-        end
-      end
-
-      def header
-        move_down 60
-
-        logo = company[:logo]
-
-        if logo.nil?
-          move_down 32
-        elsif logo.is_a?(String)
-          image open(logo), height: 32
-        else
-          image logo, height: 32
-        end
-
-        move_down 8
-        text "<color rgb='a6a6a6'>#{subheading % { id: id }}</color>", inline_format: true
-
-        move_down 30
-        text message, inline_format: true, size: 12.5, leading: 4
-      end
-
-      def charge_details
-        move_down 30
-
-        borders = line_items.length - 2
-
-        table(line_items, width: bounds.width, cell_style: { border_color: 'cccccc', inline_format: true }) do
-          cells.padding = 12
-          cells.borders = []
-          row(0..borders).borders = [:bottom]
-        end
-      end
-
-      def footer
-        move_down 45
-        text company.fetch(:name), inline_format: true
-        text "<color rgb='888888'>#{company.fetch(:address)}</color>", inline_format: true
-      end
+  class Receipt < Base
+    @title = "Receipt"
   end
 end

data/lib/receipts/statement.rb

@@ -0,0 +1,5 @@
+module Receipts
+  class Statement < Base
+    @title = "Statement"
+  end
+end

data/lib/receipts/version.rb

@@ -1,3 +1,3 @@
 module Receipts
-  VERSION = "1.0.4"
+  VERSION = "2.0.0"
 end

data/lib/receipts.rb

@@ -1,3 +1,11 @@
 require "receipts/version"
-require "receipts/receipt"
-require "receipts/invoice"
+require "open-uri"
+require "prawn"
+require "prawn/table"
+
+module Receipts
+  autoload :Base, "receipts/base"
+  autoload :Invoice, "receipts/invoice"
+  autoload :Receipt, "receipts/receipt"
+  autoload :Statement, "receipts/statement"
+end

data/receipts.gemspec

@@ -1,28 +1,33 @@
-# coding: utf-8
-lib = File.expand_path('../lib', __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'receipts/version'
+# frozen_string_literal: true
+
+require_relative "lib/receipts/version"
 
 Gem::Specification.new do |spec|
-  spec.name          = "receipts"
-  spec.version       = Receipts::VERSION
-  spec.authors       = ["Chris Oliver"]
-  spec.email         = ["excid3@gmail.com"]
-  spec.summary       = %q{Receipts for your Rails application that works with any payment provider.}
-  spec.description   = %q{Receipts for your Rails application that works with any payment provider.}
-  spec.homepage      = ""
-  spec.license       = "MIT"
+  spec.name = "receipts"
+  spec.version = Receipts::VERSION
+  spec.authors = ["Chris Oliver"]
+  spec.email = ["excid3@gmail.com"]
 
-  spec.files         = `git ls-files -z`.split("\x0")
-  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
-  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
-  spec.require_paths = ["lib"]
+  spec.summary = "Receipts for your Rails application that works with any payment provider."
+  spec.description = "Receipts for your Rails application that works with any payment provider."
+  spec.homepage = "https://github.com/excid3/receipts"
+  spec.license = "MIT"
 
-  spec.add_development_dependency "bundler"
-  spec.add_development_dependency "rake", "~> 10.0"
-  spec.add_development_dependency "rspec"
-  spec.add_development_dependency "pry"
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = "https://github.com/excid3/receipts/blob/master/CHANGELOG.md"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (f == __FILE__) || f.match(%r{\A(?:(?:test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
+    end
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
 
-  spec.add_dependency 'prawn', '>= 1.3.0', '< 3.0.0'
-  spec.add_dependency 'prawn-table', '~> 0.2.1'
+  spec.add_dependency "prawn", ">= 1.3.0", "< 3.0.0"
+  spec.add_dependency "prawn-table", "~> 0.2.1"
 end

metadata

@@ -1,71 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: receipts
 version: !ruby/object:Gem::Version
-  version: 1.0.4
+  version: 2.0.0
 platform: ruby
 authors:
 - Chris Oliver
-autorequire: 
-bindir: bin
+autorequire:
+bindir: exe
 cert_chain: []
-date: 2020-08-02 00:00:00.000000000 Z
+date: 2022-01-30 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: pry
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: prawn
   requirement: !ruby/object:Gem::Requirement
@@ -107,29 +51,31 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".github/FUNDING.yml"
-- ".gitignore"
-- ".travis.yml"
 - CHANGELOG.md
 - Gemfile
 - LICENSE.txt
 - README.md
 - Rakefile
-- examples/gorails.png
+- examples/images/logo.png
+- examples/images/options.jpg
 - examples/invoice.pdf
 - examples/receipt.pdf
+- examples/statement.pdf
 - lib/receipts.rb
+- lib/receipts/base.rb
 - lib/receipts/invoice.rb
 - lib/receipts/receipt.rb
+- lib/receipts/statement.rb
 - lib/receipts/version.rb
 - receipts.gemspec
-- spec/receipts_spec.rb
-- spec/spec_helper.rb
-homepage: ''
+homepage: https://github.com/excid3/receipts
 licenses:
 - MIT
-metadata: {}
-post_install_message: 
+metadata:
+  homepage_uri: https://github.com/excid3/receipts
+  source_code_uri: https://github.com/excid3/receipts
+  changelog_uri: https://github.com/excid3/receipts/blob/master/CHANGELOG.md
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -144,10 +90,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key: 
+rubygems_version: 3.2.32
+signing_key:
 specification_version: 4
 summary: Receipts for your Rails application that works with any payment provider.
-test_files:
-- spec/receipts_spec.rb
-- spec/spec_helper.rb
+test_files: []

data/.github/FUNDING.yml

@@ -1,12 +0,0 @@
-# These are supported funding model platforms
-
-github: [excid3] # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
-patreon: # Replace with a single Patreon username
-open_collective: # Replace with a single Open Collective username
-ko_fi: # Replace with a single Ko-fi username
-tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
-community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
-liberapay: # Replace with a single Liberapay username
-issuehunt: # Replace with a single IssueHunt username
-otechie: # Replace with a single Otechie username
-custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

data/.gitignore

@@ -1,15 +0,0 @@
-/.bundle/
-/.yardoc
-/Gemfile.lock
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-*.bundle
-*.so
-*.o
-*.a
-mkmf.log
-.DS_Store

data/.travis.yml

@@ -1,4 +0,0 @@
-language: ruby
-rvm:
-  - 2.3.3
-  - 2.4.0

data/spec/receipts_spec.rb

@@ -1,18 +0,0 @@
-require 'spec_helper'
-
-describe Receipts do
-  it "lets you create a new receipt" do
-    expect(Receipts::Receipt.new(
-      id: 1,
-      product: "GoRails",
-      company: {
-        name: "One Month, Inc.",
-        address: "37 Great Jones\nFloor 2\nNew York City, NY 10012",
-        email: "teachers@onemonth.com"
-      },
-      line_items: [
-        ["Product",        "GoRails"],
-      ],
-    ).class.name).to eq("Receipts::Receipt")
-  end
-end

data/spec/spec_helper.rb

@@ -1,9 +0,0 @@
-begin
-  require 'pry'
-rescue LoadError
-end
-
-require 'receipts'
-
-RSpec.configure do |config|
-end