invoice_printer 2.0.0.alpha1 → 2.1.0.rc1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cdf5ab1be5ba608592e459feb3295450b61fb43d063adf9e250281bad74fa87e
-  data.tar.gz: ffbe76f56621e22d5e0020ba0a285305b4ce018f5923d7240e543140fb8b9acd
+  metadata.gz: 926ffa0b9c6ce419a715122202dbc5e5b6489323c0daafe1da259cb86efb0acc
+  data.tar.gz: d0a6882d42b488d4df932f8b5981a188beb515af31ec3a0d5eb49a6b64a28882
 SHA512:
-  metadata.gz: 9d5f1023dd14f26e190b579edf7a4def0f86530574d64024a4ebd49d82735efcd4294a0913e09c95a38ed44e8a12fe46ac56326e8e1d8db565d3a9df242a9441
-  data.tar.gz: f768d976020dc7397241344cecf5daa164e24e51f71815105cf37d781b8d9e278a6f98af3445cbb97deb8df3d46dbc082be5999e666016735ff411ae975d1059
+  metadata.gz: 383e3dc9b714a1faf3a585ed9313db8d0e77031d4556643894395757de723a787b216f5af2eba8ea7aa5c183c0d5ea55bc69534bf9bc40def043767f10c9aeb3
+  data.tar.gz: b53666c983492ffc59668c305b4b1e1e914f78488a44ec8c048c83de847a4a3559a0092534795d985a61c0192698ab99a2f0b3ecdf8d74a91dde1ff3a7f524af

data/Dockerfile

@@ -0,0 +1,37 @@
+# To build the Docker image:
+#
+#   $ sudo systemctl start docker
+#   $ sudo docker build -t printer .
+#
+# To run it:
+#
+#   $ sudo docker run -d -p 9393:9393 -t printer
+#
+# To push to repository:
+#
+#   $ sudo docker login
+#   $ sudo docker tag printer docker.io/strzibnyj/invoice_printer_server:latest
+#   $ sudo docker push strzibnyj/invoice_printer_server:latest
+FROM alpine:3.10
+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
+
+# 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 --version 2.0.0 --no-document
+
+# Install gem from RubyGems.org
+RUN gem install invoice_printer_server --version 2.0.0 --no-document
+
+# Clean APK cache
+RUN rm -rf /var/cache/apk/*
+
+# Run the server on port 80
+ENTRYPOINT ["/usr/local/bundle/bin/invoice_printer_server", "-p9393"]

data/Gemfile.lock

@@ -1,7 +1,12 @@
 PATH
   remote: .
   specs:
-    invoice_printer_server (2.0.0.alpha1)
+    invoice_printer (2.0.0)
+      json (~> 2.1)
+      prawn (~> 2.2)
+      prawn-table (~> 0.2.2)
+    invoice_printer_server (2.0.0)
+      invoice_printer (= 2.0.0)
       json (~> 2.1)
       puma (>= 3.9.0)
       roda (~> 3.5)
@@ -15,31 +20,39 @@ GEM
     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.3.1)
+    minitest (5.14.2)
+    nio4r (2.5.4)
+    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.0.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.36.0)
       rack
     ruby-rc4 (0.1.5)
-    ttfunk (1.4.0)
+    ttfunk (1.7.0)
 
 PLATFORMS
   ruby
@@ -55,4 +68,4 @@ DEPENDENCIES
   rake (>= 10.0)
 
 BUNDLED WITH
-   1.17.2
+   2.1.4

data/README.md

@@ -28,7 +28,7 @@ See more usecases in the `examples/` directory.
 - Configurable items' table with item description, 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)
@@ -48,4 +48,4 @@ See more usecases in the `examples/` directory.
 
 ## 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

@@ -8,6 +8,17 @@ prelude: |
   $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
   require 'invoice_printer'
 
+  provider_address = <<ADDRESS
+  Rolnická 1
+  747 05  Opava
+  Kateřinky
+  ADDRESS
+
+  purchaser_address = <<ADDRESS
+  Ostravská 1
+  747 70  Opava
+  ADDRESS
+
   item = InvoicePrinter::Document::Item.new(
     name: 'Programming',
     quantity: '10',
@@ -19,15 +30,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

@@ -5,7 +5,7 @@ require 'optparse'
 require 'invoice_printer'
 
 def show_version
-  puts "InvoicePrinter Server v#{InvoicePrinter::VERSION}"
+  puts "InvoicePrinter v#{InvoicePrinter::VERSION}"
 
   exit 0
 end
@@ -18,7 +18,7 @@ def show_help
 
       -d, --document   document as JSON
         -l, --labels   labels as JSON
-              --font   path to font
+              --font   path to font or builtin font name
          -s, --stamp   path to stamp
               --logo   path to logotype
         --background   path to background image

data/docs/COMMAND_LINE.md

@@ -12,7 +12,7 @@ Options:
 
   -d, --document   document as JSON
     -l, --labels   labels as JSON
-          --font   path to font
+          --font   path to font or builtin font name
      -s, --stamp   path to stamp
           --logo   path to logotype
     --background   path to background image
@@ -20,6 +20,125 @@ 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",
+  "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",
+  "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`.
+
 ## Examples
 
 ```

data/docs/INSTALLATION.md

@@ -4,10 +4,17 @@
 
 This requires Ruby to be installed.
 
-Then install the gem as:
+Install the library and command line as:
 
     $ gem install invoice_printer
 
+Or the server version as:
+
+    $ gem install invoice_printer_server
+
+To have builtin fonts available install:
+
+    $ gem install invoice_printer_fonts
 
 ### With Bundler
 
@@ -17,6 +24,30 @@ Add this line to your application's Gemfile:
 gem 'invoice_printer'
 ```
 
+For the server:
+
+```ruby
+gem 'invoice_printer_server'
+```
+
+To have builtin fonts available add:
+
+```ruby
+gem 'invoice_printer_fonts'
+```
+
 And then execute:
 
-    $ bundle
+    $ bundle
+
+## Using Docker
+
+InvoicePrinter Server is available as a Docker image.
+
+This requires Docker to be installed and running.
+
+To get it:
+
+```bash
+$ sudo docker pull strzibnyj/invoice_printer_server
+```

data/docs/LIBRARY.md

@@ -72,13 +72,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 +107,8 @@ InvoicePrinter.print(
   document:  document,
   ...
 )
-
 ```
 
-
-
 ## Customization
 
 ### Page size
@@ -153,8 +148,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 = {
@@ -226,14 +220,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__)
 )
 ```
 
-We recommend you DejaVuSans and Overpass fonts.
+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 `roboto`. Note that searching the path takes preference.
 
 ### Background
 

data/docs/SERVER.md

@@ -1,24 +1,38 @@
 # InvoicePrinter Server
 
-InvoicePrinter contains a built in server that can be run from a command line with `invoice_printer_server`.
+InvoicePrinter comes with a server that can be run from a command line with `invoice_printer_server`. Since 2.x releases this server is packaged separately in `invoice_printer_server` gem.
 
 Apart from this you can also manually mount the server inside of your Rack application.
 
 ## Running the server
 
-### From command line
+### From a command line
 
-Once installed, InvoicePrinter provides `invoice_printer_server` executable that starts the Puma server:
+Once installed, InvoicePrinter Server provides `invoice_printer_server` executable that starts the Puma server:
 
 ```bash
-invoice_printer_server -h 0.0.0.0 -p 5000
+$ invoice_printer_server -h 0.0.0.0 -p 5000
 ```
 
 `-h` defines a host and `-p` defines a port. For help you can run `--help`.
 
 By default server binds to `0.0.0.0:9393`.
 
-### As mountable Rack app
+#### As a Docker image
+
+Get the public image and run it:
+
+```bash
+$ sudo docker pull strzibnyj/invoice_printer_server:$VERSION
+$ sudo docker run -d -p 9393:9393 -v ~/path/to/invocies:/data:Z -t docker.io/strzibnyj/invoice_printer_server
+```
+You can use `latest` as a `$VERSION`. Specifying the `-v` option is only required when using the `/print` action to create the documents at certain path. It will allow you to provide the desired filename as "/data/invoice-name.pdf".
+
+The server will then be available on `0.0.0.0:9393`.
+
+Docker image already contains the optional `invoice_printer_fonts` gem.
+
+### As a mountable Rack app
 
 If you want you can always run the server from your custom program or mount it directly from a Rack app.
 
@@ -46,12 +60,14 @@ Options:
 
 - `document` - JSON representation of the document
 - `labels` - JSON for labels
-- `font` - path to font file
+- `font` - path to font file or builtin font name
 - `stamp` - path to stamp file
 - `logo` - path to logotype file
 - `background` - path to background file
 - `page_size` - letter or A4 page size
 
+These parameters are the same as for the [command line](./COMMAND_LINE.md).
+
 On success a `200` response is returned:
 
 ```json
@@ -86,7 +102,7 @@ Options:
 
 - `document` - JSON representation of the document
 - `labels` - JSON for labels
-- `font` - path to font file
+- `font` - path to font file or builtin font name
 - `stamp` - path to stamp file
 - `logo` - path to logotype file
 - `background` - path to background file