pixelpress 0.3.1 → 0.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 72fc075971593953c3a7056f7001d50348f9b8d685ad08fe96b80dcd4151436a
-  data.tar.gz: 72c713f2b2aa16d3437bf0ed335d158cfd32048487aa5626a4236976c3cbe76c
+  metadata.gz: 0cc5425ba75f2b3d99b63622b074e34922e734bd6fba94306a94cd84088e882e
+  data.tar.gz: 1907176157c4a6fa50f77c9479cc39c36f37fe74ed73d81633d812703fe483bd
 SHA512:
-  metadata.gz: d89b7c28c2a0a9193281eb5d1b8c3e9da7bc100772a41628c5c85b9ba3216e3ff6f00de6c9566238dfc63e9cf9dde026efe7c6c1c0d5e7aeb926ff634c5ba9eb
-  data.tar.gz: 56c91b7091209f81d7447de720c3b5ffa3e523a89599a23c6363434866d14fa6f671aab7bfb2504c895647878c7b2a78d8fbe47e045df69f025d0764847b36ba
+  metadata.gz: 1ce2a0d492ab4376ddc0d50f132d0e91515fc927f8d67487fcb34935e6ee93b8fb9f0f98df40e571bfb43a9663b020a1d62bd9e69930b5950a7ff2d5f046a59b
+  data.tar.gz: 7303ace72f3b012e4162ce976494b199dc5c0fdae59d0825ed01f5d0de21b943ddf72073b390fe3ac3dd911d73ff3217bfa9328d97648d6ce9c4c247e4384229

data/README.md

@@ -1,23 +1,22 @@
 # Pixelpress
-[![CircleCI](https://circleci.com/gh/nerdgeschoss/pixelpress/tree/master.svg?style=svg)](https://circleci.com/gh/nerdgeschoss/pixelpress/tree/master)
 
-Modeled after `ActionMailer` this gem allows you to render PDFs from HTML via Rails templating engine. Also you can preview your PDF templates via a supplied engine during development.
+Modeled after `ActionMailer`, this gem allows you to render PDFs from HTML via Rails' templating engine. Additionally, you can preview your PDF templates via a supplied Rails engine during development.
 
 ## Installation
 
-Add this line to your application's Gemfile:
+Add Pixelpress to your application's Gemfile:
 
 ```ruby
-gem 'pixelpress'
+gem "pixelpress"
 ```
 
 And then execute:
 
-    $ bundle
-
-Or install it yourself as:
+```bash
+$ bundle
+```
 
-    $ gem install pixelpress
+You'll also need [WeasyPrint](https://weasyprint.org/). It needs to be installed and added to your `PATH`, so that `which weasyprint` returns the location of the binary. Read their installation instructions here: https://doc.courtbouillon.org/weasyprint/stable/first_steps.html#installation
 
 ## Usage
 
@@ -26,26 +25,29 @@ Run the printer generator providing the name of your printer with methods to be
 rails generate pixelpress:printer NAME [method_name1 method_name2 ...] [options]
 ```
 
-This creates an `ApplicationPrinter` in `app/printers` and the corresponding subclass and also mounts the engine in your `config/routes.rb` file.
+This creates the new printer in `app/printers`. If you run it the first time, it will also add an `ApplicationPrinter` and mount the Rails engine in your `config/routes.rb` file.
 
 **Example**
+
 ```bash
-$ rails g pixelpress:printer invoice customer_invoice delivery_document 	
+$ rails g pixelpress:printer invoice customer_invoice delivery_document
 ```
-will generate `app/printers/invoice_printer.rb` file which looks like this:
+
+will generate an `app/printers/invoice_printer.rb` file with this content:
+
 ```ruby
 class InvoicePrinter < ApplicationPrinter
- 	def customer_invoice
- 		# put your code here
- 	end
+  def customer_invoice
+    # put your code here
+  end
 
- 	def delivery_document
- 		# put your code here
- 	end
+  def delivery_document
+    # put your code here
+  end
 end
 ```
 
-Also this command will generate the corresponding templates  as `.pdf.erb` files located in `app/views/printers/invoice/`:
+The command will also generate corresponding templates  as `.pdf.erb` files located in `app/views/printers/invoice/`:
 
 - `customer_invoice.pdf.erb`
 - `delivery_document.pdf.erb`
@@ -53,10 +55,10 @@ Also this command will generate the corresponding templates  as `.pdf.erb` files
 You can preview your documents by running `rails s` and go to
 
 ```
-localhost:3000/rails/printers
+http://localhost:3000/rails/printers
 ```
 
-To use your printers in code, you can instantiate them just like mailers:
+To use your printers in code, you can use them similarly to how you'd use mailers:
 
 ```ruby
 InvoicePrinter.customer_invoice.pdf # render a temporary pdf file

data/lib/generators/pixelpress/printer/templates/initializer.rb

@@ -1,2 +1,2 @@
-Rails.application.config.autoload_paths << Rails.root.join('app', 'printers')
-Rails.application.config.autoload_paths << Rails.root.join('spec', 'printer', 'previews') if Rails.env.development?
+Rails.application.config.autoload_paths << Rails.root.join('app/printers')
+Rails.application.config.autoload_paths << Rails.root.join('spec/printers/previews') if Rails.env.development?

data/lib/pixelpress/preview.rb

@@ -1,7 +1,7 @@
 module Pixelpress
   class Preview
     def self.all
-      Dir[Rails.root.join('spec', 'printers', 'previews', '**', '*_preview.rb')].map do |file|
+      Dir[Rails.root.join('spec/printers/previews/**/*_preview.rb')].map do |file|
         require_dependency file
         file.split('printers/previews/').last.sub('.rb', '').classify.constantize.new
       end

data/lib/pixelpress/renderers/weasyprint_renderer.rb

@@ -1,11 +1,13 @@
 class Pixelpress::WeasyPrintRenderer
+  class WeasyPrintInstallationError < StandardError; end
+
   def render(input)
     output = Tempfile.new
 
     system executable_path, "--encoding", "utf-8", input.path, output.path, exception: true
     return output
   end
-  
+
   def version
     `#{executable_path} --version`.chomp.scan(/(\d+\.\d+)/).flatten.first
   end
@@ -13,6 +15,12 @@ class Pixelpress::WeasyPrintRenderer
   private
 
   def executable_path
-    `which weasyprint`.chomp || raise(StandardError, "could not find weasyprint")
+    path = `which weasyprint`.chomp
+
+    if path.blank?
+      raise WeasyPrintInstallationError.new("Unable to locate weasyprint binary. Please make sure it's in your PATH.")
+    end
+
+    path
   end
 end

data/lib/pixelpress/version.rb

@@ -1,3 +1,3 @@
 module Pixelpress
-  VERSION = '0.3.1'.freeze
+  VERSION = '0.3.3'.freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pixelpress
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.3.3
 platform: ruby
 authors:
 - Alex
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-05-23 00:00:00.000000000 Z
+date: 2025-01-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionpack