go-utils

Go utils library.

go get github.com/ionv06/go-utils

Contents

Package utils

Function	What it does
Clean(dir string) string	Normalizes a path: strips quotes, cleans it, drops trailing separators
LoadEnv() error	Finds a .env file and loads its keys into the process environment

Package anaf

Function	What it does
Lookup(fiscalCode string) ([]byte, error)	Validates a CUI, downloads the company from ANAF, returns it as JSON
LookupCompany(fiscalCode string) (*Company, error)	Same as Lookup, but returns the struct instead of JSON
CleanFiscalCode(value string) string	Strips the RO prefix and every non-digit, giving the canonical form
UserMessage(err error) (string, bool)	Returns the user-safe text of an error, if it has one

See also Types and sentinel errors for Company, UserError and the Err* values.

Package winsvc

Function	What it does
ConfigFromEnv(run, shutdown) Config	Builds a Config from the service .env variables plus the lifecycle hooks
(Config) Validate() error	Errors when any service identity field is unset, naming the missing env vars
Run(cfg Config) error	Runs the app under the Windows SCM when started as a service, else as a console app
Install(cfg Config) error	Registers the executable as an auto-start Windows service with restart-on-failure recovery
Remove(cfg Config) error	Stops (if running) and deletes the Windows service

Tool genversioninfo — generates versioninfo.json from git metadata.

Package utils

Small helpers for paths and environment.

import "github.com/ionv06/go-utils/utils"

Clean(dir string) string

Normalizes a filesystem path: strips surrounding double quotes, applies filepath.Clean, and removes trailing \ or / separators. Useful for paths that arrive from command-line arguments or config files where the user may have quoted them or left a trailing slash.

utils.Clean(`"C:\data\exports\"`) // -> C:\data\exports

LoadEnv() error

Finds a .env file and loads its keys into the process environment.

Search order (first match wins):

1. .env
2. ../.env
3. ../../.env
4. .env next to the running executable

File format: one KEY=VALUE per line. Blank lines and lines starting with # are ignored. Surrounding double quotes are stripped from the value. Lines without = are skipped.

Variables already present in the environment are not overwritten — real environment variables always win over the .env file.

Returns os.ErrNotExist if no .env file was found in any location.

Package anaf

Downloads Romanian company data from the ANAF public VAT registry web service (webservicesp.anaf.ro, API v9). Each call is bounded by a 20s timeout.

import "github.com/ionv06/go-utils/anaf"

Lookup(fiscalCode string) ([]byte, error)

Validates the Romanian fiscal code (CUI), downloads the company data from ANAF and returns it JSON-encoded (the encoding of Company). Callers must not pre-validate the code — Lookup owns that step.

Accepts the code in any common form: RO12345678, 12345678, with spaces or punctuation.

LookupCompany(fiscalCode string) (*Company, error)

Same as Lookup but returns the *Company struct directly, without the JSON encoding step.

CleanFiscalCode(value string) string

Strips the optional RO prefix and every non-digit character, yielding the canonical digits-only form used for comparisons and storage.

anaf.CleanFiscalCode(" ro 12.345.678 ") // -> 12345678

UserMessage(err error) (string, bool)

Returns the user-safe text of an error, if it has one. Use it to decide what may be shown to an end user: input problems and unknown companies are safe, while network, TLS and decode failures are internal faults and must be logged instead.

data, err := anaf.Lookup(code)
if err != nil {
    if msg, ok := anaf.UserMessage(err); ok {
        http.Error(w, msg, http.StatusBadRequest) // safe to show
        return
    }
    log.Println(err)                              // internal fault
    http.Error(w, "eroare interna", http.StatusInternalServerError)
    return
}

Types and sentinel errors

Company is the normalized subset of the ANAF record:

Field	JSON key	Notes
FiscalCode	fiscal_code	digits only
Name	name
TradeRegisterNo	trade_register_no
Country	country	always Romania
County	county
Locality	locality	Ors. prefix and Sector N removed
Street	street	Str. prefix removed; falls back to address details
Number	number
Sector	sector,omitempty	Bucharest sector number, when present
Attribute	attribute,omitempty	RO when the company is VAT registered

UserError marks an error whose text is safe to show to the end user. The sentinel values:

Error	Message	Meaning
ErrMissingCode	cod fiscal lipsa	no fiscal code supplied
ErrInvalidCode	cod fiscal invalid	not a well-formed Romanian CUI
ErrNotFound	cod fiscal negasit la ANAF	ANAF knows no company with this code

Validation requires 2–10 digits with a correct control digit (the official CUI checksum).

Package winsvc

Installs, removes, and runs a Go program as a Windows service. The Windows implementation is behind the windows build tag; on other platforms Run just runs the app and Install/Remove return ErrUnsupported.

import "github.com/ionv06/go-utils/winsvc"

All three functions take a Config that supplies both the service identity and the lifecycle hooks:

type Config struct {
    ServiceName string // key used by the SCM and by sc / services.msc
    DisplayName string // shown in services.msc
    Description string // shown in services.msc

    Run      func() error              // starts the app, blocks until it stops
    Shutdown func(ctx context.Context) // graceful stop on SCM stop/shutdown; may be nil
}

Run supplies the two app-specific hooks; the identity fields are read from a .env file by ConfigFromEnv, so a program only writes the hooks:

func serviceConfig() winsvc.Config {
    return winsvc.ConfigFromEnv(runApp, func(ctx context.Context) {
        if httpSrv != nil {
            _ = httpSrv.Shutdown(ctx)
        }
    })
}

func installService() error { return winsvc.Install(serviceConfig()) }
func removeService() error  { return winsvc.Remove(serviceConfig()) }
func runService() error     { return winsvc.Run(serviceConfig()) }

ConfigFromEnv(run, shutdown) Config

Loads a .env file via utils.LoadEnv and reads the service identity from these variables:

Variable	Field
SERVICE_NAME	ServiceName
SERVICE_DISPLAY_NAME	DisplayName
SERVICE_DESCRIPTION	Description

run and shutdown are wired straight into the returned Config. A missing .env is not an error here — Install and Remove call Validate to enforce that the identity is present.

(Config) Validate() error

Returns an error naming every missing identity variable, e.g. configurare serviciu incompletă în .env: lipsă SERVICE_NAME, SERVICE_DESCRIPTION. Install and Remove call it first, so they refuse to run against an incomplete .env.

Run(cfg Config) error

Runs cfg.Run. On Windows, if the process was started by the Service Control Manager it runs under the SCM (chdir to the executable's directory first, so a .env next to the binary resolves) and dispatches stop/shutdown to cfg.Shutdown with a 10s deadline; otherwise it runs cfg.Run directly. An app that exits on its own with an error reports a non-zero code so the SCM's recovery actions restart it.

Install(cfg Config) error

Registers the current executable as an auto-start service with recovery actions (restart after 5s / 10s / 30s, failure counter reset daily). Calls cfg.Validate first, so an incomplete .env is rejected before any change. Fails if the service already exists. Must be run from an elevated prompt. Returns ErrUnsupported off Windows.

Remove(cfg Config) error

Stops the service (best effort) and deletes it by cfg.ServiceName. Calls cfg.Validate first. Fails if the service is not installed. Must be run from an elevated prompt. Returns ErrUnsupported off Windows.

Tool genversioninfo

Generates a versioninfo.json in the current directory from git metadata, for embedding version information into Windows executables.

go run github.com/ionv06/go-utils/tools/genversioninfo [flags]

The version comes from git describe --tags --abbrev=0 (falling back to v0.0.0) and is split into major/minor/patch. The short commit hash from git rev-parse --short HEAD (falling back to abcd) is written to the Comments field.

Flag	Default
-CompanyName	Cometa SRL
-FileDescription	ContabSQL Tools
-InternalName	contab_tools
-OriginalFilename	saft-xml2xlsx.exe
-ProductName	ERP Tools