🌍 Language: 🇩🇪 German →
![]() |
GSF-NexFact-Assets A dedicated central test asset repository for the GSF-NexFact e-invoicing ecosystem. |
GSF stands for Go Small Frameworks — minimalist tools for robust applications.
This project is developed and maintained on Codeberg.
Canonical repository:
GitHub is an automated mirror of the Codeberg repository:
GitHub mirror:
GSF-nexfact-assets is the dedicated central test asset repository for the GSF-nexfact e-invoicing
ecosystem. It stores shared test environments (env), reference resources (schemas, templates, mock
profiles), and sample invoice files used across nexfact, nexfact-server, and related microservices.
By isolating heavy binary test fixtures into this repository, core source
repositories (nexfact, nexfact-server, nexutils) remain lightweight and fast to clone.
This project is part of the tiny-frameworks initiative.
nexfact-assets/
├── setup.go # Creates isolated working directory & free dynamic ports
├── env/ # Reference nexfact environment templates & schemas
└── testdata/
└── resources/ # Test input files (PDFs, XMLs, JSON payloads, images)
├── test_generate_fx.json
├── test_combine_invoice.pdf
├── test_combine_invoice.xml
└── test_attachment.png
To guarantee that tests remain strictly deterministic and side-effect-free, tests must never write directly to this asset repository.
Instead, tests follow the TempDir Isolation Pattern:
┌───────────────────────────┐
│ nexfact-assets │ (Read-Only Master Templates & Fixtures)
└─────────────┬─────────────┘
│ 1. Copy on Test Startup
▼
┌───────────────────────────┐
│ tempDir │ (Isolated Temporary Working Directory)
│ ├── env/ │
│ └── resources/ │
└─────────────┬─────────────┘
│ 2. Process, Write Output & Assert
▼
┌───────────────────────────┐
│ os.RemoveAll() │ (Manual/Deferred Cleanup by Caller)
└───────────────────────────┘
import "codeberg.org/tiny-frameworks/nexfact-assets"
func TestMyServer(t *testing.T) {
setupMap, err := assets.SetupTestEnv("native")
if err != nil {
t.Fatalf("failed to create testSetup: %v", err)
}
envRoot := setupMap["envRoot"]
resourcePath := setupMap["resourcePath"]
tempDir := setupMap["tempDir"]
defer os.RemoveAll(tempDir)
// ... execute tests ...
}This repository is designed to be used alongside related tiny-frameworks modules (nexfact, nexfact-server, nexutils).
For local development, place the repositories side-by-side in a shared workspace directory.
- Copyright: © 2026 Georg Hagn.
- Repository:
codeberg.org/tiny-frameworks/nexfact-assets - License: Apache License, Version 2.0.
GSF-NexFact-Assets is an independent open-source project and is not affiliated with any corporation of a similar name.
For inquiries, architectural discussions, or security issues, please contact:
📧 georghagn [at] tiny-frameworks.io
