invoice_printer 2.0.0.beta3 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d0b5acb10995e69d8aba7d44d9e7d71ce5e9b9104cf5883fec574ada600501b0
-  data.tar.gz: 3ccaa20f6baeee71cf879cdf74687e6da7ab6441fa5583199fa547d3e5afd34f
+  metadata.gz: 33a87300d4ff6a12080b758ea012b7c94a09521575c99579e300844dbfbf0e47
+  data.tar.gz: 33446dc1314512a7793ad95b73065dfb59abef1963e5c115fab5263e2dd53ecc
 SHA512:
-  metadata.gz: 84cf91f9a5f2445dbe62491e7f51c05e4bfaf3d9c5d58881db035a964c2114a9d02fca485f300b15fc8cb87efea05d2c24d60822c1f9c01145dd1eeba62c22cd
-  data.tar.gz: aa5566034f52a87d9c7ee432fc485fd233407a82f591ded208a880f0d214aea3c39cc6241add8bfffbcb3abe07311214cb47ff0daec20f1e7ea4ad5a92b131c8
+  metadata.gz: ef29b3e26227c6cbeba87fca78154d55a7bb103472f77991fe1a4df24f30a36efa75db3f7f724ddd17a369713870db6d20bd93ea33d0812fb55501bbba9c7ea2
+  data.tar.gz: 6c93d97f040190c555dcbdaf742e05d904a00bd458e2f68009dd1191ec3bf190fe92e20033bb19e0ae3337f6e10686361922b05bcfcc6316e86f8bb46b7a0cbf

data/Dockerfile

@@ -11,24 +11,25 @@
 #
 #   $ sudo docker login
 #   $ sudo docker tag printer docker.io/strzibnyj/invoice_printer_server:latest
+#   $ sudo docker push strzibnyj/invoice_printer_server:$VERSION
 #   $ sudo docker push strzibnyj/invoice_printer_server:latest
-FROM alpine:3.10
+FROM alpine:3.13
 MAINTAINER Josef Strzibny <strzibny@strzibny.name>
 
 ENV GEM_HOME="/usr/local/bundle"
 ENV PATH $GEM_HOME/bin:$GEM_HOME/gems/bin:$PATH
 
 # Update system
-RUN apk update &&  apk upgrade
+RUN apk update && apk upgrade
 
 # Install Ruby and build dependencies
 RUN apk add build-base bash ruby ruby-etc ruby-dev
 
-# Install support for builtin fonts
-RUN gem install invoice_printer_fonts --no-document
+# Install builtin fonts
+RUN gem install invoice_printer_fonts --version 2.2.0 --no-document
 
-# Install gem from RubyGems.org
-RUN gem install invoice_printer_server --version 2.0.0.beta3 --no-document
+# Install the gem from RubyGems.org
+RUN gem install invoice_printer_server --version 2.2.0 --no-document
 
 # Clean APK cache
 RUN rm -rf /var/cache/apk/*

data/Gemfile

@@ -10,7 +10,7 @@ group :test do
 end
 
 group :benchmark do
-  gem 'benchmark_driver', '0.14.11'
+  gem 'benchmark_driver', '0.15.17'
   # For generating benchmark reports with --output gruff
   gem 'benchmark_driver-output-gruff'
 end

data/Gemfile.lock

@@ -1,7 +1,12 @@
 PATH
   remote: .
   specs:
-    invoice_printer_server (2.0.0.alpha1)
+    invoice_printer (2.2.0)
+      json (~> 2.1)
+      prawn (~> 2.2)
+      prawn-table (~> 0.2.2)
+    invoice_printer_server (2.2.0)
+      invoice_printer (= 2.2.0)
       json (~> 2.1)
       puma (>= 3.9.0)
       roda (~> 3.5)
@@ -11,41 +16,49 @@ GEM
   specs:
     Ascii85 (1.0.3)
     afm (0.2.2)
-    benchmark_driver (0.14.11)
+    benchmark_driver (0.15.17)
     benchmark_driver-output-gruff (0.3.1)
       benchmark_driver (>= 0.12.0)
       gruff
-    gruff (0.7.0)
-      rmagick (~> 2.13, >= 2.13.4)
+    gruff (0.11.0)
+      histogram
+      rmagick
     hashery (2.1.2)
-    json (2.2.0)
-    minitest (5.11.3)
-    nio4r (2.3.1)
+    histogram (0.2.4.1)
+    json (2.5.1)
+    minitest (5.14.2)
+    nio4r (2.5.7)
+    pdf-core (0.9.0)
     pdf-inspector (1.3.0)
       pdf-reader (>= 1.0, < 3.0.a)
-    pdf-reader (2.2.0)
+    pdf-reader (2.4.1)
       Ascii85 (~> 1.0.0)
       afm (~> 0.2.1)
       hashery (~> 2.0)
       ruby-rc4
       ttfunk
-    puma (4.0.0)
+    prawn (2.4.0)
+      pdf-core (~> 0.9.0)
+      ttfunk (~> 1.7)
+    prawn-table (0.2.2)
+      prawn (>= 1.3.0, < 3.0.0)
+    puma (5.3.2)
       nio4r (~> 2.0)
-    rack (2.0.6)
+    rack (2.2.3)
     rack-test (1.1.0)
       rack (>= 1.0, < 3)
-    rake (10.5.0)
-    rmagick (2.16.0)
-    roda (3.21.0)
+    rake (13.0.1)
+    rmagick (4.1.2)
+    roda (3.45.0)
       rack
     ruby-rc4 (0.1.5)
-    ttfunk (1.4.0)
+    ttfunk (1.7.0)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  benchmark_driver (= 0.14.11)
+  benchmark_driver (= 0.15.17)
   benchmark_driver-output-gruff
   bundler (>= 1.7)
   invoice_printer_server!
@@ -55,4 +68,4 @@ DEPENDENCIES
   rake (>= 10.0)
 
 BUNDLED WITH
-   1.17.2
+   2.1.4

data/README.md

@@ -25,10 +25,10 @@ See more usecases in the `examples/` directory.
 - Purchaser and provider boxes with addresses and identificaton numbers
 - Payment method box showing banking details including SWIFT and IBAN fields
 - Issue/due dates box
-- Configurable items' table with item description, quantity, unit, price per unit, tax and item's total amount fields
+- Configurable items' table with item description, breakdown, quantity, unit, price per unit, tax and item's total amount fields
 - Final subtotal/tax/total info box
 - Page numbers
-- Configurable labels & sublabels (optional little labels)
+- Configurable field labels & sublabels (optional little labels)
 - Configurable font file
 - Logotype (as image scaled to fit 50px of height)
 - Background (as image)
@@ -46,6 +46,12 @@ See more usecases in the `examples/` directory.
 - [Server](./docs/SERVER.md)
 - [Command line](./docs/COMMAND_LINE.md)
 
+## Support
+
+I am developing InvoicePrinter as a free and MIT-licensed library for several years now.
+
+I would appreciate if you consider [buying my book](https://deploymentfromscratch.com/).
+
 ## Copyright
 
-Copyright 2015-2019 © [Josef Strzibny](http://strzibny.name/). MIT licensed.
+Copyright 2015-2021 © [Josef Strzibny](http://strzibny.name/). MIT licensed.

data/benchmarks/render.yml

@@ -1,13 +1,25 @@
 # Run the benchmark with benchmark_driver as:
 #
-#   $ benchmark-driver benchmarks/render.yml --output gruff --runner ips -e '/path/to/bin/ruby;/path/to/bin/ruby-2.6.0 --jit'
-#   $ benchmark-driver benchmarks/render.yml --output compare --runner memory -e '/path/to/bin/ruby;/path/to/bin/ruby-2.6.0 --jit--jit'
-loop_count: 10000
+#   $ benchmark-driver benchmarks/render.yml --output gruff --runner ips -e '/path/to/bin/ruby;/path/to/bin/ruby-3.0.0 --jit'
+#   $ benchmark-driver benchmarks/render.yml --output compare --runner memory -e '/path/to/bin/ruby;/path/to/bin/ruby-3.0.0 --jit'
+#   $ benchmark-driver benchmarks/render.yml -e '/home/strzibny/.rubies/ruby-2.7.0/bin/ruby;/home/strzibny/.rubies/ruby-3.0.0/bin/ruby;/home/strzibny/.rubies/ruby-3.0.0/bin/ruby --jit'
+#
+# Note: You need to install invoice_printer as a gem for the require to work.
+loop_count: 3000
 prelude: |
-  lib = File.expand_path('../lib', __FILE__)
-  $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
   require 'invoice_printer'
 
+  provider_address = <<ADDRESS
+  Rolnicka 1
+  747 05  Opava
+  Katerinky
+  ADDRESS
+
+  purchaser_address = <<ADDRESS
+  Ostravska 1
+  747 70  Opava
+  ADDRESS
+
   item = InvoicePrinter::Document::Item.new(
     name: 'Programming',
     quantity: '10',
@@ -19,15 +31,9 @@ prelude: |
   invoice = InvoicePrinter::Document.new(
     number: 'NO. 198900000001',
     provider_name: 'John White',
-    provider_street: '5th Avenue',
-    provider_street_number: '1',
-    provider_postcode: '747 05',
-    provider_city: 'NYC',
+    provider_lines: provider_address,
     purchaser_name: 'Will Black',
-    purchaser_street: '7th Avenue',
-    purchaser_street_number: '1',
-    purchaser_postcode: '747 70',
-    purchaser_city: 'NYC',
+    purchaser_lines: purchaser_address,
     issue_date: '05/03/2016',
     due_date: '19/03/2016',
     total: '$ 900',

data/bin/invoice_printer

@@ -19,6 +19,7 @@ def show_help
       -d, --document   document as JSON
         -l, --labels   labels as JSON
               --font   path to font or builtin font name
+         --bold-font   path to bold font or builtin font name
          -s, --stamp   path to stamp
               --logo   path to logotype
         --background   path to background image
@@ -47,6 +48,10 @@ parser = OptionParser.new do|opts|
     options[:font] = path
   end
 
+  opts.on('--bold-font PATH') do |path|
+    options[:bold_font] = path
+  end
+
   opts.on('-s', '--stamp PATH') do |path|
     options[:stamp] = path
   end
@@ -116,6 +121,7 @@ begin
       document:   document,
       labels:     labels,
       font:       options[:font],
+      bold_font:  options[:bold_font],
       stamp:      options[:stamp],
       logo:       options[:logo],
       background: options[:background],
@@ -130,6 +136,7 @@ begin
       document:   document,
       labels:     labels,
       font:       options[:font],
+      bold_font:  options[:bold_font],
       stamp:      options[:stamp],
       logo:       options[:logo],
       file_name:  options[:filename],

data/docs/COMMAND_LINE.md

@@ -13,6 +13,7 @@ Options:
   -d, --document   document as JSON
     -l, --labels   labels as JSON
           --font   path to font or builtin font name
+     --bold-font   path to bold font or builtin font name
      -s, --stamp   path to stamp
           --logo   path to logotype
     --background   path to background image
@@ -20,6 +21,127 @@ Options:
   -f, --filename   output path
     -r, --render   directly render PDF stream (filename option will be ignored)
 ```
+
+## Document
+
+JSON document with all possible fields filled:
+
+```json
+{
+  "number":"c. 198900000001",
+  "provider_name":"Petr Novy",
+  "provider_tax_id":"56565656",
+  "provider_tax_id2":"",
+  "provider_lines":"Rolnická 1\n747 05  Opava\nKateřinky",
+  "purchaser_name":"Adam Cerny",
+  "purchaser_tax_id":"",
+  "purchaser_tax_id2":"",
+  "purchaser_lines":"Ostravská 1\n747 70  Opava",
+  "issue_date":"05/03/2016",
+  "due_date":"19/03/2016",
+  "variable_symbol":"198900000001",
+  "subtotal":"Kc 10.000",
+  "tax":"Kc 2.100",
+  "tax2":"",
+  "tax3":"",
+  "variable":"Extra column",
+  "total":"Kc 12.100,-",
+  "bank_account_number":"156546546465",
+  "account_iban":"IBAN464545645",
+  "account_swift":"SWIFT5456",
+  "items":[
+    {
+       "name":"Konzultace",
+       "variable": "",
+       "quantity":"2",
+       "unit":"hod",
+       "price":"Kc 500",
+       "tax":"",
+       "tax2":"",
+       "tax3":"",
+       "amount":"Kc 1.000"
+    },
+    {
+       "name":"Programovani",
+       "variable": "",
+       "quantity":"10",
+       "unit":"hod",
+       "price":"Kc 900",
+       "tax":"",
+       "tax2":"",
+       "tax3":"",
+       "amount":"Kc 9.000"
+    }
+  ],
+  "note":"Osoba je zapsána v zivnostenském rejstríku."
+}
+```
+
+**Note**: `provider_lines` and `purchaser_lines` are 4 lines of data separated by new line character`\n`. Other lines are being stripped.
+
+**Note**: There is `variable` field that can be used for any
+extra column.
+
+## Field labels
+
+All labels:
+
+```json
+{
+  "name":"Invoice",
+  "provider":"Provider",
+  "purchaser":"Purchaser",
+  "tax_id":"Identification number",
+  "tax_id2":"Identification number",
+  "payment":"Payment",
+  "payment_by_transfer":"Payment by bank transfer on the account below:",
+  "payment_in_cash":"Payment in cash",
+  "account_number":"Account NO",
+  "swift":"SWIFT",
+  "iban":"IBAN",
+  "issue_date":"Issue date",
+  "due_date": "Due date",
+  "variable_symbol": "Variable symbol",
+  "item":"Item",
+  "variable":"",
+  "quantity":"Quantity",
+  "unit": "Unit",
+  "price_per_item":"Price per item",
+  "amount":"Amount",
+  "tax":"Tax",
+  "tax2":"Tax 2",
+  "tax3":"Tax 3",
+  "subtotal":"Subtotal",
+  "total":"Total",
+  "sublabels":{
+    "name":"Faktura",
+    "provider":"Prodejce",
+    "purchaser":"Kupující",
+    "tax_id":"IČ",
+    "tax_id2":"DIČ",
+    "payment":"Forma úhrady",
+    "payment_by_transfer":"Platba na následující účet:",
+    "account_number":"Číslo účtu",
+    "issue_date":"Datum vydání",
+    "due_date":"Datum splatnosti",
+    "item":"Položka",
+    "variable:":"",
+    "quantity":"Počet",
+    "unit":"MJ",
+    "price_per_item":"Cena za položku",
+    "amount":"Celkem bez daně",
+    "subtota":"Cena bez daně",
+    "tax":"DPH 21 %",
+    "total":"Celkem"
+  }
+}
+```
+**Note**: Notice the `sublabels` which you might not want to necessary include.
+
+## Built-in fonts
+
+Supported builtin fonts are: `overpass`, `opensans`, and `roboto`. They ship with bold versions.
+
 ## Examples
 
 ```

data/docs/LIBRARY.md

@@ -31,6 +31,7 @@ Here is an full example for creating the document object:
 ```ruby
 item = InvoicePrinter::Document::Item.new(
   name: 'Web consultation',
+  breakdown: 'Excludes 1h free consultation',
   quantity: nil,
   unit: 'hours',
   price: '$ 25',
@@ -72,13 +73,11 @@ invoice = InvoicePrinter::Document.new(
 **Note**: `provider_lines` and `purchaser_lines` are 4 lines of data separated by new line character`\n`. Other lines are being stripped.
 
 **Note**: There is `variable` field that can be used for any
-extra column. `tax2` and `tax3` for more complex taxes are
-available as well.
+extra column.
 
 ### Ruby on Rails
 
-If you want to use InvoicePrinter for printing PDF documents directly from Rails
-actions, you can:
+If you want to use InvoicePrinter for printing PDF documents directly from Rails actions, you can:
 
 ```ruby
 # GET /invoices/1
@@ -109,11 +108,8 @@ InvoicePrinter.print(
   document:  document,
   ...
 )
-
 ```
 
-
-
 ## Customization
 
 ### Page size
@@ -153,8 +149,7 @@ InvoicePrinter.print(
 )
 ```
 
-Here is the full list of labels to configure. You can paste and edit this block
-to `initializers/invoice_printer.rb` if you are using Rails.
+Here is the full list of labels to configure. You can paste and edit this block to `initializers/invoice_printer.rb` if you are using Rails.
 
 ```ruby
 InvoicePrinter.labels = {
@@ -171,6 +166,7 @@ InvoicePrinter.labels = {
   iban: 'IBAN',
   issue_date: 'Issue date',
   due_date: 'Due date',
+  variable_symbol: 'Variable symbol',
   item: 'Item',
   variable: '',
   quantity: 'Quantity',
@@ -204,6 +200,7 @@ sublabels = {
   account_number: 'Číslo účtu',
   issue_date: 'Datum vydání',
   due_date: 'Datum splatnosti',
+  variable_symbol: 'Variabilní symbol',
   item: 'Položka',
   variable: '',
   quantity: 'Počet',
@@ -226,16 +223,23 @@ Now the document will have little sublabels next to the original labels in Czech
 
 To support specific characters you might need to specify a TTF font to be used:
 
-``` ruby
+```ruby
 InvoicePrinter.print(
   ...
   font: File.expand_path('../Overpass-Regular.ttf', __FILE__)
 )
 ```
 
-If you don't have a font around, you can install `invoice_printer_fonts` gem and specify the supported font name instead.
+If you don't have a font around, you can install `invoice_printer_fonts` gem and specify the supported font name instead:
+
+```ruby
+InvoicePrinter.print(
+  document: invoice,
+  font: "roboto"
+)
+```
 
-Supported builtin fonts are: `overpass`, `opensans`, and `ruboto`. Note that searching the path takes preference.
+Supported builtin fonts are: `overpass`, `opensans`, and `roboto`. Note that searching the path takes preference.
 
 ### Background