invoice_printer 1.1.0 → 1.2.0.alpha1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7267267a6ecf63b5859b996d9e559f15a47c1c99
-  data.tar.gz: 0526101ea5a21143caca53fa8e6d6cde1a6a1907
+  metadata.gz: 8abb69910f861a930c17f4a59b2f00c5c7530556
+  data.tar.gz: b4b108dc6b68db259a24a9fca49db4eb78ab0a9b
 SHA512:
-  metadata.gz: cf3f24eb77ac24d9fad50aff96b215289088f4a1d56f5d7aa32d29bbfeaf527301b46275853538da488dfc02eb925b3fc5d8fd4da59cdb0fd06049cdc8cd6ca5
-  data.tar.gz: 9746c2ce166bbdbe5b81668345fde6ade8897c76872e175849e70be9f69f4a9c630ddf5933bb17cee4412cc14bb6527117f2e8f8a0366a42bd6463bed6ce2a86
+  metadata.gz: 126cddc2f3e5cf893cf94f18abdd2b7966399f993f0ff29826adff0d1b77f26ea08c8de3feb6b036c4c5b12027ebbd90b41ef54f3b1b9fecc6e80bc88c9a530c
+  data.tar.gz: db9b42fb49fa1c303c0f6a6abeb1408cd2940960efc529107372f9581d21248eb982ce1f3eaf4e4bee23ce6d3bb759972aeabfd3f4611aec42cd295d961968e2

data/Gemfile

@@ -6,4 +6,5 @@ gemspec
 group :test do
   gem 'pdf-inspector'
   gem 'minitest'
+  gem 'rack-test', require: 'rack/test'
 end

data/README.md

@@ -1,12 +1,22 @@
-<a href="http://strzibny.github.io/invoice_printer/">
-  <img src="./docs/web/logo.png" width="300" />
-</a>
+<img src="./assets/logo.png" width="300" />
 
 &nbsp;
 
-Super simple PDF invoicing in pure Ruby
+**Super simple PDF invoicing.** InvoicePrinter is a server, command line program and pure Ruby library to generate PDF invoices in no time. You can use Ruby or JSON as the invoice representation to build the final PDF.
 
-InvoicePrinter is a Ruby library and a command line program. You can use Ruby or JSON to build the final PDF.
+## Philosophy
+
+- **Simple**, no styling required, no calculation, no money formatting (bring your own)
+- **Pure Ruby**, no dependency on system libraries or browsers
+- **Fast**, so you can render invoice on the fly during request
+
+## Examples
+
+| Simple invoice |
+| -------------- |
+| <a href="https://github.com/strzibny/invoice_printer/raw/master/examples/promo.pdf"><img src="./examples/picture.jpg" width="180" /></a>|
+
+See more usecases in the `examples/` directory.
 
 ## Features
 
@@ -26,296 +36,18 @@ InvoicePrinter is a Ruby library and a command line program. You can use Ruby or
 - Note
 - JSON format
 - CLI
+- Server
 - Well tested
 
-## Example
-
-| Simple invoice |
-| -------------- |
-| <a href="https://github.com/strzibny/invoice_printer/raw/master/examples/promo.pdf"><img src="./examples/picture.jpg" width="180" /></a>|
-
-See more usecases in the `examples/` directory.
-
-## Installation
-
-Add this line to your application's Gemfile:
-
-```ruby
-gem 'invoice_printer'
-```
-
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
-
-    $ gem install invoice_printer
-
-## Usage
-
-The simplest way how to create your invoice PDF is to create an invoice object
-and pass it to printer:
-
-```ruby
-item = InvoicePrinter::Document::Item.new(
-  ...
-)
-
-invoice = InvoicePrinter::Document.new(
-  ...
-  items: [item, ...]
-)
-
-InvoicePrinter.print(
-  document: invoice,
-  file_name: 'invoice.pdf'
-)
-
-# Or render PDF directly
-InvoicePrinter.render(
-  document: invoice
-)
-```
-
-Here is an full example for creating the document object:
-
-```ruby
-item = InvoicePrinter::Document::Item.new(
-  name: 'Web consultation',
-  quantity: nil,
-  unit: 'hours',
-  price: '$ 25',
-  tax: '$ 1',
-  amount: '$ 100'
-)
-
-invoice = InvoicePrinter::Document.new(
-  number: '201604030001',
-  provider_name: 'Business s.r.o.',
-  provider_tax_id: '56565656',
-  provider_tax_id2: '465454',
-  provider_street: 'Rolnicka',
-  provider_street_number: '1',
-  provider_postcode: '747 05',
-  provider_city: 'Opava',
-  provider_city_part: 'Katerinky',
-  provider_extra_address_line: 'Czech Republic',
-  purchaser_name: 'Adam',
-  purchaser_tax_id: '',
-  purchaser_tax_id2: '',
-  purchaser_street: 'Ostravska',
-  purchaser_street_number: '1',
-  purchaser_postcode: '747 70',
-  purchaser_city: 'Opava',
-  purchaser_city_part: '',
-  purchaser_extra_address_line: '',
-  issue_date: '19/03/3939',
-  due_date: '19/03/3939',
-  subtotal: '175',
-  tax: '5',
-  tax2: '10',
-  tax3: '20',
-  total: '$ 200',
-  bank_account_number: '156546546465',
-  account_iban: 'IBAN464545645',
-  account_swift: 'SWIFT5456',
-  items: [item],
-  note: 'A note...'
-)
-```
-
-### Ruby on Rails
-
-If you want to use InvoicePrinter for printing PDF documents directly from Rails
-actions, you can:
-
-```ruby
-# GET /invoices/1
-def show
-  invoice = InvoicePrinter::Document.new(...)
-
-  respond_to do |format|
-    format.pdf {
-      @pdf = InvoicePrinter.render(
-        document: invoice
-      )
-      send_data @pdf, type: 'application/pdf', disposition: 'inline'
-    }
-  end
-end
-```
-
-### JSON format
-
-JSON format is supported via `from_json` method. JSON itself mimicks the original Ruby objects:
-
-```ruby
-json = InvoicePrinter::Document.new(...).to_json
-document = InvoicePrinter::Document.from_json(json)
-
-
-InvoicePrinter.print(
-  document:  document,
-  ...
-)
-
-```
-
-## CLI
-
-InvoicePrinter ships with a command line executable called `invoice_printer`.
-
-It supports all features except it only accepts JSON as an input.
-
-```
-$ invoice_printer --help
-Usage: invoice_printer [options]
-
-Options:
-
-    -l, --labels   labels as JSON
-  -d, --document   document as JSON
-     -s, --stamp   path to stamp
-          --logo   path to logotype
-          --font   path to font
-     --page_size   letter or a4 (letter is the default)
-  -f, --filename   output path
-    -r, --render   directly render PDF stream (filename option will be ignored)
-```
-
-
-## Customization
-
-### Page size
-
-Both A4 and US letter is supported. Just pass `page_size` as an argument to `print` or `render` methods:
-
-```ruby
-InvoicePrinter.print(
-  document: invoice,
-  labels: labels,
-  page_size: :a4,
-  file_name: 'invoice.pdf'
-)
-```
-
-`:letter` is the default.
-
-
-### Localization
-
-To localize your documents you can set both global defaults or instance
-overrides:
-
-```ruby
-InvoicePrinter.labels = {
-  provider: 'Dodavatel'
-}
-
-labels = {
-  purchaser: 'Customer'
-}
-
-InvoicePrinter.print(
-  document: invoice,
-  labels: labels,
-  file_name: 'invoice.pdf'
-)
-```
-
-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 = {
-  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',
-  quantity: 'Quantity',
-  unit: 'Unit',
-  price_per_item: 'Price per item',
-  amount: 'Amount',
-  tax: 'Tax',
-  tax2: 'Tax 2',
-  tax3: 'Tax 3',
-  subtotal: 'Subtotal',
-  total: 'Total'
-}
-```
-
-You can also use sublabels feature to provide the document in two languages:
-
-```ruby
-labels = {
-  ...
-}
-
-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',
-  quantity: 'Počet',
-  unit: 'MJ',
-  price_per_item: 'Cena za položku',
-  amount: 'Celkem bez daně',
-  subtotal: 'Cena bez daně',
-  tax: 'DPH 21 %',
-  total: 'Celkem'
-}
-
-labels.merge!({ sublabels: sublabels })
-
-...
-```
-
-Now the document will have a little sublabels next to the original labels in Czech.
-
-### Font
-
-To support specific characters you might need to specify a TTF font to be used:
-
-``` ruby
-InvoicePrinter.print(
-  ...
-  font: File.expand_path('../Overpass-Regular.ttf', __FILE__)
-)
-```
-
-We recommend you DejaVuSans and Overpass fonts.
-
-### Background
-
-To include a background image you might need to create the file according to the size and resolution to be used (see: [examples/background.png](https://github.com/strzibny/invoice_printer/blob/master/examples/background.png)):
+## Documentation
 
-``` ruby
-InvoicePrinter.print(
-  ...
-  background: File.expand_path('../background.png', __FILE__)
-)
-```
+- [Installation](./docs/INSTALLATION.md)
+- [Ruby library](./docs/LIBRARY.md)
+- [Server](./docs/SERVER.md)
+- [Command line](./docs/COMMAND_LINE.md)
 
 ## Copyright
 
-Copyright 2015-2017 &copy; [Josef Strzibny](http://strzibny.name/). MIT licensed.
+Copyright 2015-2018 &copy; [Josef Strzibny](http://strzibny.name/). MIT licensed.
 
 Originally extracted from and created for an open source single-entry invoicing app [InvoiceBar](https://github.com/strzibny/invoicebar).

data/bin/invoice_printer

@@ -2,7 +2,6 @@
 $LOAD_PATH << File.expand_path('lib')
 
 require 'optparse'
-require 'json'
 require 'invoice_printer'
 
 def show_version
@@ -34,8 +33,6 @@ end
 options = {}
 
 parser = OptionParser.new do|opts|
-	opts.banner = "Usage: invoice_printer [options]"
-
   opts.on('-l', '--labels JSON') do |json|
     options[:labels] = json
   end

data/bin/invoice_printer_server

@@ -0,0 +1,69 @@
+#!/usr/bin/env ruby
+$LOAD_PATH << File.expand_path('lib')
+
+require 'optparse'
+require 'rack/handler/puma'
+require 'invoice_printer/server'
+
+def show_version
+  puts "InvoicePrinter v#{InvoicePrinter::VERSION}"
+
+  exit 0
+end
+
+def show_help
+  puts <<~HELP
+    Usage: invoice_printer_server [options]
+
+    Options:
+
+        -h, --host   hostname to listen on (default is 0.0.0.0)
+        -p, --port   port to listen on (default is 9393)
+     -w, --workers   number of Puma workers (default is 2)
+
+  HELP
+
+  exit 0
+end
+
+options = {}
+
+parser = OptionParser.new do|opts|
+  opts.on('-h', '--hostname ADDRESS') do |address|
+    options[:Host] = address
+  end
+
+  opts.on('-p', '--port NUMBER') do |number|
+    options[:Port] = number
+  end
+
+  opts.on('-w', '--workers NUMBER') do |number|
+    options[:workers] = number.to_i
+  end
+
+  opts.on('--debug') do
+    options[:debug] = true
+  end
+
+  opts.on('-h', '--help') do
+    show_help
+  end
+end
+
+parser.parse!
+
+puma_options = { :Host => '0.0.0.0', :Port => 9393, :workers => 2 }.merge(options)
+
+begin
+  puts 'Starting InvoicePrinter Server...'
+  Rack::Handler::Puma.run(InvoicePrinter::Server.freeze.app, puma_options)
+rescue => e
+  STDERR.puts "ERROR: #{e.message}"
+
+  if options[:debug]
+    STDERR.puts
+    STDERR.puts e.backtrace
+  end
+
+  exit 1
+end

data/docs/COMMAND_LINE.md

@@ -0,0 +1,21 @@
+# InvoicePrinter CLI
+
+InvoicePrinter ships with a command line executable called `invoice_printer`.
+
+It supports all features except it only accepts JSON as an input.
+
+```
+$ invoice_printer --help
+Usage: invoice_printer [options]
+
+Options:
+
+    -l, --labels   labels as JSON
+  -d, --document   document as JSON
+     -s, --stamp   path to stamp
+          --logo   path to logotype
+          --font   path to font
+     --page_size   letter or a4 (letter is the default)
+  -f, --filename   output path
+    -r, --render   directly render PDF stream (filename option will be ignored)
+```

data/docs/INSTALLATION.md

@@ -0,0 +1,22 @@
+# Installation
+
+## Via RubyGems
+
+This requires Ruby to be installed.
+
+Then install the gem as:
+
+    $ gem install invoice_printer
+
+
+### With Bundler
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'invoice_printer'
+```
+
+And then execute:
+
+    $ bundle

data/docs/LIBRARY.md

@@ -0,0 +1,242 @@
+# InvoicePrinter Library
+
+## Usage
+
+The simplest way how to create your invoice PDF is to create an invoice object
+and pass it to printer:
+
+```ruby
+item = InvoicePrinter::Document::Item.new(
+  ...
+)
+
+invoice = InvoicePrinter::Document.new(
+  ...
+  items: [item, ...]
+)
+
+InvoicePrinter.print(
+  document: invoice,
+  file_name: 'invoice.pdf'
+)
+
+# Or render PDF directly
+InvoicePrinter.render(
+  document: invoice
+)
+```
+
+Here is an full example for creating the document object:
+
+```ruby
+item = InvoicePrinter::Document::Item.new(
+  name: 'Web consultation',
+  quantity: nil,
+  unit: 'hours',
+  price: '$ 25',
+  tax: '$ 1',
+  amount: '$ 100'
+)
+
+invoice = InvoicePrinter::Document.new(
+  number: '201604030001',
+  provider_name: 'Business s.r.o.',
+  provider_tax_id: '56565656',
+  provider_tax_id2: '465454',
+  provider_street: 'Rolnicka',
+  provider_street_number: '1',
+  provider_postcode: '747 05',
+  provider_city: 'Opava',
+  provider_city_part: 'Katerinky',
+  provider_extra_address_line: 'Czech Republic',
+  purchaser_name: 'Adam',
+  purchaser_tax_id: '',
+  purchaser_tax_id2: '',
+  purchaser_street: 'Ostravska',
+  purchaser_street_number: '1',
+  purchaser_postcode: '747 70',
+  purchaser_city: 'Opava',
+  purchaser_city_part: '',
+  purchaser_extra_address_line: '',
+  issue_date: '19/03/3939',
+  due_date: '19/03/3939',
+  subtotal: '175',
+  tax: '5',
+  tax2: '10',
+  tax3: '20',
+  total: '$ 200',
+  bank_account_number: '156546546465',
+  account_iban: 'IBAN464545645',
+  account_swift: 'SWIFT5456',
+  items: [item],
+  note: 'A note...'
+)
+```
+
+### Ruby on Rails
+
+If you want to use InvoicePrinter for printing PDF documents directly from Rails
+actions, you can:
+
+```ruby
+# GET /invoices/1
+def show
+  invoice = InvoicePrinter::Document.new(...)
+
+  respond_to do |format|
+    format.pdf {
+      @pdf = InvoicePrinter.render(
+        document: invoice
+      )
+      send_data @pdf, type: 'application/pdf', disposition: 'inline'
+    }
+  end
+end
+```
+
+### JSON format
+
+JSON format is supported via `from_json` method. JSON itself mimicks the original Ruby objects:
+
+```ruby
+json = InvoicePrinter::Document.new(...).to_json
+document = InvoicePrinter::Document.from_json(json)
+
+
+InvoicePrinter.print(
+  document:  document,
+  ...
+)
+
+```
+
+
+
+## Customization
+
+### Page size
+
+Both A4 and US letter is supported. Just pass `page_size` as an argument to `print` or `render` methods:
+
+```ruby
+InvoicePrinter.print(
+  document: invoice,
+  labels: labels,
+  page_size: :a4,
+  file_name: 'invoice.pdf'
+)
+```
+
+`:letter` is the default.
+
+
+### Localization
+
+To localize your documents you can set both global defaults or instance
+overrides:
+
+```ruby
+InvoicePrinter.labels = {
+  provider: 'Dodavatel'
+}
+
+labels = {
+  purchaser: 'Customer'
+}
+
+InvoicePrinter.print(
+  document: invoice,
+  labels: labels,
+  file_name: 'invoice.pdf'
+)
+```
+
+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 = {
+  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',
+  quantity: 'Quantity',
+  unit: 'Unit',
+  price_per_item: 'Price per item',
+  amount: 'Amount',
+  tax: 'Tax',
+  tax2: 'Tax 2',
+  tax3: 'Tax 3',
+  subtotal: 'Subtotal',
+  total: 'Total'
+}
+```
+
+You can also use sublabels feature to provide the document in two languages:
+
+```ruby
+labels = {
+  ...
+}
+
+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',
+  quantity: 'Počet',
+  unit: 'MJ',
+  price_per_item: 'Cena za položku',
+  amount: 'Celkem bez daně',
+  subtotal: 'Cena bez daně',
+  tax: 'DPH 21 %',
+  total: 'Celkem'
+}
+
+labels.merge!({ sublabels: sublabels })
+
+...
+```
+
+Now the document will have a little sublabels next to the original labels in Czech.
+
+### Font
+
+To support specific characters you might need to specify a TTF font to be used:
+
+``` ruby
+InvoicePrinter.print(
+  ...
+  font: File.expand_path('../Overpass-Regular.ttf', __FILE__)
+)
+```
+
+We recommend you DejaVuSans and Overpass fonts.
+
+### Background
+
+To include a background image you might need to create the file according to the size and resolution to be used (see: [examples/background.png](https://github.com/strzibny/invoice_printer/blob/master/examples/background.png)):
+
+``` ruby
+InvoicePrinter.print(
+  ...
+  background: File.expand_path('../background.png', __FILE__)
+)
+```

data/docs/SERVER.md

@@ -0,0 +1,96 @@
+# InvoicePrinter Server
+
+InvoicePrinter contains a built in server that can be run from a command line with `invoice_printer_server`.
+
+Apart from this you can also manually mount the server inside of your Rack application.
+
+## Running the server
+
+### From command line
+
+Once installed, InvoicePrinter provides `invoice_printer_server` executable that starts the Puma server:
+
+```bash
+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
+
+If you want you can always run the server from your custom program or mount it directly from a Rack app.
+
+`InvoicePrinter::Server` is a Rack app as any other. Example:
+
+```ruby
+require 'rack/handler/puma'
+require 'invoice_printer/server'
+
+Rack::Handler::Puma.run InvoicePrinter::Server.freeze.app
+```
+
+## Available API
+
+Endpoints accept similar arguments as the corresponding methods to `InvoicePrinter`. `render` is used for directly getting the PDF output whereas `print` would accept `filename` option and save the document to that
+file.
+
+A content type is always `application/json` both for requests and responses.
+
+### `POST /render`
+
+Directly render PDF data.
+
+Options:
+
+- `document` - JSON representation of the document
+- `labels` - JSON for labels
+- `stamp` - path to stamp file
+- `logo` - path to logotype file
+- `font` - path to font file
+
+On success a `200` response is returned:
+
+```json
+{ "result": "ok", "data": "base64 encoded PDF document" }
+```
+
+On error a `400` response is returned:
+
+```json
+{ "result": "error", "error": "error description" }
+```
+
+#### Example
+
+Example of calling the API to render a document using `curl`:
+
+```
+$ curl -X POST http://0.0.0.0:9393/render -H "Content-Type: application/json" --data '{"document":{"number":"c. 198900000001","provider_name":"Petr Novy","provider_tax_id":"56565656","provider_tax_id2":"","provider_street":"Rolnicka","provider_street_number":"1","provider_postcode":"747 05","provider_city":"Opava","provider_city_part":"Katerinky","provider_extra_address_line":"","purchaser_name":"Adam Cerny","purchaser_tax_id":"","purchaser_tax_id2":"","purchaser_street":"Ostravska","purchaser_street_number":"1","purchaser_postcode":"747 70","purchaser_city":"Opava","purchaser_city_part":"","purchaser_extra_address_line":"","issue_date":"05/03/2016","due_date":"19/03/2016","subtotal":"Kc 10.000","tax":"Kc 2.100","tax2":"","tax3":"","total":"Kc 12.100,-","bank_account_number":"156546546465","account_iban":"IBAN464545645","account_swift":"SWIFT5456","items":[{"name":"Konzultace","quantity":"2","unit":"hod","price":"Kc 500","tax":"","tax2":"","tax3":"","amount":"Kc 1.000"},{"name":"Programovani","quantity":"10","unit":"hod","price":"Kc 900","tax":"","tax2":"","tax3":"","amount":"Kc 9.000"}],"note":"Osoba je zapsána v zivnostenském rejstríku."}}'
+```
+
+### `POST /print`
+
+Print resulting document to a file.
+
+Options:
+
+- `document` - JSON representation of the document
+- `labels` - JSON for labels
+- `stamp` - path to stamp file
+- `logo` - path to logotype file
+- `font` - path to font file
+- `filename` - path for saving the generated output PDF
+
+On success a `200` response is returned:
+
+```json
+{ "result": "ok", "path": "/path/basically/what/was/sent/as/filepath" }
+```
+
+On error a `400` response is returned:
+
+```json
+{ "result": "error", "error": "error description" }
+```

data/invoice_printer.gemspec

@@ -15,7 +15,6 @@ Gem::Specification.new do |spec|
   # Remove .pdf files as they take a lot of space
   package_files = `git ls-files -z`.split("\x0")
                     .reject{ |file| file.match /.*\.pdf/ }
-                    .reject{ |file| file.match /docs\/.*/ }
 
   spec.files         = package_files
   spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
@@ -24,6 +23,8 @@ Gem::Specification.new do |spec|
   spec.bindir        = 'bin'
 
   spec.add_dependency 'json', '~> 2.1'
+  spec.add_dependency 'roda', '3.5.0'
+  spec.add_dependency 'puma', '~> 3.9'
   spec.add_dependency 'prawn', '2.1.0'
   spec.add_dependency 'prawn-layout', '0.8.4'
 

data/lib/invoice_printer.rb

@@ -1,7 +1,12 @@
+require 'json'
 require 'invoice_printer/version'
+require 'invoice_printer/document'
 require 'invoice_printer/document/item'
 require 'invoice_printer/pdf_document'
 
+# Skip warning for not specifying TTF font
+Prawn::Font::AFM.hide_m17n_warning = true
+
 # Create PDF versions of invoices or receipts using Prawn
 #
 # Example:

data/lib/invoice_printer/document.rb

@@ -1,5 +1,3 @@
-require 'json'
-
 module InvoicePrinter
   # Invoice and receipt representation
   #

data/lib/invoice_printer/document/item.rb

@@ -1,5 +1,3 @@
-require 'invoice_printer/document'
-
 module InvoicePrinter
   class Document
     # Line items for InvoicePrinter::Document

data/lib/invoice_printer/server.rb

@@ -0,0 +1,82 @@
+require 'base64'
+require 'roda'
+require 'invoice_printer'
+
+class InvoicePrinter::Server < Roda
+  route do |r|
+    response['Content-Type'] = 'application/json'
+
+    # Assign params
+    if r.content_type == 'application/json'
+      begin
+        params = JSON.parse(r.body.read, symbolize_names: true)
+      rescue => e
+        response.status = 400
+        response.write({ result: 'error', error: 'Invalid JSON.' }.to_json)
+        r.halt
+      end
+
+      labels   = params[:labels]
+      document = params[:document]
+      stamp    = params[:stamp]
+      logo     = params[:logo]
+      font     = params[:font]
+    else
+      response.status = 400
+      response.write({ result: 'error', error: 'No JSON. Did you set Content-Type to application/json?' }.to_json)
+      r.halt
+    end
+
+    # Initialize InvoicePrinter::Document from given JSON
+    begin
+      document[:items] ||= []
+      items = document[:items].map { |item| InvoicePrinter::Document::Item.new(**item) }
+      document[:items] = items
+
+      document = InvoicePrinter::Document.new(**document)
+    rescue => e
+      response.status = 400
+      response.write({ result: 'error', error: 'Invalid JSON document.' }.to_json)
+      r.halt
+    end
+
+    # POST /print
+    r.post 'print' do
+      filename = params[:filename] || 'document.pdf'
+
+      begin
+        InvoicePrinter.print(
+          document:  document,
+          font:      font,
+          stamp:     stamp,
+          logo:      logo,
+          file_name: filename
+        )
+
+        { result: 'ok', path: filename }.to_json
+      rescue => e
+        response.status = 400
+        response.write({ result: 'error', error: e.message }.to_json)
+        r.halt
+      end
+    end
+
+    # POST /render
+    r.post 'render' do
+      begin
+        stream = InvoicePrinter.render(
+          document: document,
+          font:     font,
+          stamp:    stamp,
+          logo:     logo
+        )
+
+        { result: 'ok', data: Base64.encode64(stream) }.to_json
+      rescue => e
+        response.status = 400
+        response.write({ result: 'error', error: e.message }.to_json)
+        r.halt
+      end
+    end
+  end
+end

data/lib/invoice_printer/version.rb

@@ -1,3 +1,3 @@
 module InvoicePrinter
-  VERSION = '1.1.0'
+  VERSION = '1.2.0.alpha1'
 end

data/test/api_test.rb

@@ -0,0 +1,78 @@
+require 'test_helper'
+require 'invoice_printer/server'
+
+class ApiTest < Minitest::Test
+  include Rack::Test::Methods
+  include InvoicePrinterHelpers
+
+  def app
+    InvoicePrinter::Server.freeze.app
+  end
+
+  def setup
+    @test_dir = File.absolute_path('./tmp/invoice_printer_api')
+    FileUtils.mkdir_p @test_dir
+  end
+
+  def teardown
+    FileUtils.rm_rf @test_dir if File.exists?(@test_dir)
+  end
+
+  # Test POST /print
+
+  def test_print_with_invalid_json
+    header 'Content-Type', 'application/json'
+    post '/print', nil
+
+    body = JSON.parse last_response.body
+
+    assert !last_response.ok?
+    assert_equal body, { 'result' => 'error', 'error' => 'Invalid JSON.' }
+  end
+
+  def test_print_with_valid_document
+    invoice = InvoicePrinter::Document.new(default_document_params)
+
+    json = {
+      'document' => invoice.to_h,
+      'filename' => "#{@test_dir}/test"
+    }.to_json
+
+    header 'Content-Type', 'application/json'
+    post '/print', json
+
+    body = JSON.parse last_response.body
+
+    assert last_response.ok?
+    assert_equal body, { 'result' => 'ok', 'path' => "#{@test_dir}/test" }
+  end
+
+  # Test POST /render
+
+  def test_render_with_invalid_json
+    header 'Content-Type', 'application/json'
+    post '/render', nil
+
+    body = JSON.parse last_response.body
+
+    assert !last_response.ok?
+    assert_equal body, { 'result' => 'error', 'error' => 'Invalid JSON.' }
+  end
+
+  def test_render_with_valid_document
+    invoice  = InvoicePrinter::Document.new(default_document_params)
+    output   = InvoicePrinter.render(document: invoice)
+
+    json = {
+      'document' => invoice.to_h
+    }.to_json
+
+    header 'Content-Type', 'application/json'
+    post '/render', json
+
+    body = JSON.parse last_response.body
+
+    assert last_response.ok?
+    assert_equal body, { 'result' => 'ok', 'data' => Base64.encode64(output) }
+  end
+end

data/test/test_helper.rb

@@ -1,4 +1,6 @@
+require 'json'
 require 'pdf/inspector'
+require 'rack/test'
 
 lib = File.expand_path('../../lib', __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: invoice_printer
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0.alpha1
 platform: ruby
 authors:
 - Josef Strzibny
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-01-31 00:00:00.000000000 Z
+date: 2018-03-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
@@ -24,6 +24,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: roda
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 3.5.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 3.5.0
+- !ruby/object:Gem::Dependency
+  name: puma
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.9'
 - !ruby/object:Gem::Dependency
   name: prawn
   requirement: !ruby/object:Gem::Requirement
@@ -85,6 +113,7 @@ email:
 - strzibny@strzibny.name
 executables:
 - invoice_printer
+- invoice_printer_server
 extensions: []
 extra_rdoc_files: []
 files:
@@ -93,7 +122,13 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- assets/logo.png
 - bin/invoice_printer
+- bin/invoice_printer_server
+- docs/COMMAND_LINE.md
+- docs/INSTALLATION.md
+- docs/LIBRARY.md
+- docs/SERVER.md
 - examples/background.png
 - examples/complex_invoice.rb
 - examples/czech_invoice.rb
@@ -110,7 +145,9 @@ files:
 - lib/invoice_printer/document.rb
 - lib/invoice_printer/document/item.rb
 - lib/invoice_printer/pdf_document.rb
+- lib/invoice_printer/server.rb
 - lib/invoice_printer/version.rb
+- test/api_test.rb
 - test/background_test.rb
 - test/cli_test.rb
 - test/dates_box_test.rb
@@ -139,16 +176,17 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.13
+rubygems_version: 2.6.14
 signing_key: 
 specification_version: 4
 summary: Super simple PDF invoicing in pure Ruby
 test_files:
+- test/api_test.rb
 - test/background_test.rb
 - test/cli_test.rb
 - test/dates_box_test.rb