Skip to main content

Crate factura

Crate factura 

Source
Expand description

Generate pdf and html invoices.

§SimpleInvoice

Allows generating simple invoices in either html or pdf, requires a parameter of type RawInvoice, that defines the invoice data. That raw invoice type is then parsed, and the total/tax values are calculated, resulting in a ParsedInvoice.

§FromFile

Helper struct that can read either a json or toml file, and convert that raw file string into a RawInvoice type.

§extensibility

You can of course, create your own invoices, with knowledge of HTML+Askama or GenPdf.
The SimpleInvoice implementation can be used as an example, and there is a lot to extend from it:

  • Custom colors
  • Setting an svg as a watermark for your invoice
  • Reorganizing the items in different ways
  • Removing invoice data that you don’t need
  • etc
§upcoming

planned

  1. SVG Watermark on the background of SimpleInvoice, or some other new invoice, perhaps WaterMarkedInvoice
  2. Other styles of invoices

unplanned

  • I would like to make the invoice types more generic, allowing you to use the default provided types, or make your own raw-invoice types. 1

  1. It’s not really a priority, since my use-case is already fulfilled by the prior plans. ↩

Modules§

types

Structs§

InvoiceReader
Allows generating an invoice from a json/toml file.
SimpleInvoice
Simple invoice implementation, the style is nothing special, but it does it’s job. Could return either HTML or PDF, depending on the enabled feature flags. Use this as an example to create your own invoices with genpdf or askama.

Traits§

ExportsHTML
Allows an invoice format to be formatted into an HTML file
ExportsPDF
Allows an invoice format to be formatted into a PDF file
Invoice
Trait that represents an invoice, this can be used to create your own invoice format