README
¶
karbur
Local Development
Requirements
- Docker or Podman with docker compatibility
- Direnv: https://direnv.net/docs/installation.html
- mkcert:
go install filippo.io/mkcert@latest
Setup
You may initialize your local environment for developing this package with the following command, executed in the root of the repository:
$ ./_scripts/env_init.bash
$ ./_scripts/db_init.bash
$ ./_scripts/cert_init.bash
Environment Variables
A direnv-managed .envrc file should exist at the root of the repository,
although that file is not version-controlled. The env_init.bash script
creates it with default values. Required variables are (values may be adjusted
as needed):
PGPASSFILE=$(pwd)/_db/secrets/pgpassPGHOST=localhostPGPORT=5432PGCONNECT_TIMEOUT=10PGUSER=postgresPGDATABASE=postgres
Extra variables are required for the TLS tests, created automatically by the
cert_init.bash script:
KARBUR_TEST_LOCALHOST_CERT=$(pwd)/_certs/cert.pemKARBUR_TEST_LOCALHOST_KEY=$(pwd)/_certs/key.pem
License
The BSD 3-Clause license.
Directories
¶
| Path | Synopsis |
|---|---|
|
Package errors provides functions and types to define and manipulate errors.
|
Package errors provides functions and types to define and manipulate errors. |
|
Package pgdb streamlines the database API by exposing only the context-aware version of methods and enhances querying by supporting scanning into structs and slices.
|
Package pgdb streamlines the database API by exposing only the context-aware version of methods and enhances querying by supporting scanning into structs and slices. |
|
migrate
Package migrate implements a postgresql database migrations runner based on pgdb.
|
Package migrate implements a postgresql database migrations runner based on pgdb. |
|
pgxadapt
Package pgxadapt provides functions to adapt types specific for the pgx postgresql driver to the common abstract database interfaces.
|
Package pgxadapt provides functions to adapt types specific for the pgx postgresql driver to the common abstract database interfaces. |
|
sqladapt
Package sqladapt provides functions to adapt types for the stdlib's database/sql package to the common abstract database interfaces.
|
Package sqladapt provides functions to adapt types for the stdlib's database/sql package to the common abstract database interfaces. |
|
testdb
Package testdb provides functions to test a pgdb project using a real, non-mocked but isolated test database.
|
Package testdb provides functions to test a pgdb project using a real, non-mocked but isolated test database. |
|
middleware
Package middleware provides middleware commonly-required for Web servers.
|
Package middleware provides middleware commonly-required for Web servers. |
|
webpages
Package webpages parses templates used to render pages.
|
Package webpages parses templates used to render pages. |
Click to show internal directories.
Click to hide internal directories.