einvoicing 0.2.0 → 0.3.0

data/lib/einvoicing/xml_builder.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module Einvoicing
+  # Minimal zero-dependency XML builder used internally by format generators.
+  # Produces indented XML with proper attribute and text escaping.
+  class XMLBuilder
+    def initialize
+      @parts = ['<?xml version="1.0" encoding="UTF-8"?>']
+      @depth = 0
+    end
+
+    # Build a non-empty element with an optional block for children.
+    # If the block yields no content, the element is omitted entirely.
+    def tag(name, attrs = {}, &block)
+      attr_str = serialize_attrs(attrs)
+      if block
+        opening = "#{indent}<#{name}#{attr_str}>"
+        @parts << opening
+        size_before = @parts.size
+        @depth += 1
+        yield
+        @depth -= 1
+        if @parts.size == size_before
+          # Block yielded nothing — remove the opening tag.
+          @parts.pop
+        else
+          @parts << "#{indent}</#{name}>"
+        end
+      else
+        @parts << "#{indent}<#{name}#{attr_str}/>"
+      end
+    end
+
+    # Build a text element: <Name>value</Name>.
+    def text(name, value, attrs = {})
+      return if value.nil?
+
+      attr_str = serialize_attrs(attrs)
+      @parts << "#{indent}<#{name}#{attr_str}>#{escape(value.to_s)}</#{name}>"
+    end
+
+    def to_xml
+      @parts.join("\n")
+    end
+
+    private
+
+    def indent
+      "  " * @depth
+    end
+
+    def escape(str)
+      str
+        .gsub("&", "&amp;")
+        .gsub("<", "&lt;")
+        .gsub(">", "&gt;")
+        .gsub('"', "&quot;")
+        .gsub("'", "&apos;")
+    end
+
+    def serialize_attrs(attrs)
+      return "" if attrs.empty?
+
+      attrs.map { |k, v| %( #{k}="#{escape(v.to_s)}") }.join
+    end
+  end
+end

data/lib/einvoicing.rb

@@ -1,10 +1,50 @@
 # frozen_string_literal: true
 
+require "date"
+require "bigdecimal"
+require "bigdecimal/util"
+
 require_relative "einvoicing/version"
+require_relative "einvoicing/tax"
+require_relative "einvoicing/party"
+require_relative "einvoicing/line_item"
+require_relative "einvoicing/invoice"
+require_relative "einvoicing/xml_builder"
+require_relative "einvoicing/formats/cii"
+require_relative "einvoicing/formats/ubl"
+require_relative "einvoicing/formats/facturx"
+require_relative "einvoicing/i18n"
+require_relative "einvoicing/validators/base"
+require_relative "einvoicing/validators/fr"
+require_relative "einvoicing/invoiceable"
+require_relative "einvoicing/rails/concern"
+require_relative "einvoicing/ppf"
+
+# Optional Rails engine — only load when Rails is available.
+if defined?(Rails::Engine)
+  require_relative "einvoicing/rails/engine"
+end
 
-# einvoicing — EU electronic invoicing for Ruby
-# EN 16931, Factur-X (PDF/A-3), UBL 2.1, French B2B compliance.
+# Einvoicing — EU electronic invoicing for Ruby.
+#
+# Generates EN 16931-compliant invoices in Factur-X (PDF/A-3 + CII XML),
+# UBL 2.1, and CII D16B formats. Validates French B2B compliance (SIREN,
+# SIRET, TVA). Provides a Rails concern for ActiveRecord models.
+#
+# @example Quick start
+#   seller = Einvoicing::Party.new(name: "Acme SAS", siren: "356000000", vat_number: "FR83356000000")
+#   buyer  = Einvoicing::Party.new(name: "Client SA", siren: "552032534")
+#   line   = Einvoicing::LineItem.new(description: "Consulting", quantity: 1, unit_price: 1000.00)
+#
+#   invoice = Einvoicing::Invoice.new(
+#     invoice_number: "INV-2024-001",
+#     issue_date: Date.today,
+#     seller: seller,
+#     buyer: buyer,
+#     lines: [line]
+#   )
 #
-# This gem is under active development. A full release is coming soon.
-# See https://github.com/sxnlabs/einvoicing for updates.
-raise NotImplementedError, "einvoicing gem is not yet available. Check back soon."
+#   xml = Einvoicing::Formats::CII.generate(invoice)
+#   ubl = Einvoicing::Formats::UBL.generate(invoice)
+module Einvoicing
+end

metadata

@@ -1,28 +1,154 @@
 --- !ruby/object:Gem::Specification
 name: einvoicing
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Nathan Le Ray
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
-dependencies: []
-description: E-invoicing gem for Ruby targeting the French September 2026 mandate.
-  Full release coming soon. See https://github.com/sxnlabs/einvoicing
+date: 2026-03-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: hexapdf
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.65'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.65'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: rexml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: prawn
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: |
+  EN 16931-compliant e-invoicing for Ruby. Generates Factur-X (PDF/A-3 + CII XML),
+  UBL 2.1, and CII D16B. Validates French B2B requirements (SIREN, SIRET, TVA).
+  Rails concern for ActiveRecord models. Targets French September 2026 mandate.
 email:
-- contact@sxnlabs.com
+- nathan@sxnlabs.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
+- README.md
+- config/locales/einvoicing.en.yml
+- config/locales/einvoicing.fr.yml
 - lib/einvoicing.rb
+- lib/einvoicing/data/srgb.icc
+- lib/einvoicing/formats/cii.rb
+- lib/einvoicing/formats/facturx.rb
+- lib/einvoicing/formats/ubl.rb
+- lib/einvoicing/i18n.rb
+- lib/einvoicing/invoice.rb
+- lib/einvoicing/invoiceable.rb
+- lib/einvoicing/line_item.rb
+- lib/einvoicing/party.rb
+- lib/einvoicing/ppf.rb
+- lib/einvoicing/ppf/client.rb
+- lib/einvoicing/ppf/errors.rb
+- lib/einvoicing/ppf/invoice_adapter.rb
+- lib/einvoicing/ppf/submitter.rb
+- lib/einvoicing/rails/concern.rb
+- lib/einvoicing/rails/engine.rb
+- lib/einvoicing/tax.rb
+- lib/einvoicing/validators/base.rb
+- lib/einvoicing/validators/fr.rb
 - lib/einvoicing/version.rb
+- lib/einvoicing/xml_builder.rb
 homepage: https://github.com/sxnlabs/einvoicing
 licenses:
 - MIT
 metadata: {}
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -37,7 +163,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
-summary: EU electronic invoicing for Ruby — EN 16931, Factur-X, UBL 2.1 (coming soon)
+summary: EU electronic invoicing for Ruby — EN 16931, Factur-X, UBL 2.1
 test_files: []