Skip to content

Commit

Permalink
Sort example config alphabetically
Browse files Browse the repository at this point in the history
  • Loading branch information
wolfgangwalther committed Jan 24, 2022
1 parent f4637c6 commit d2791ea
Showing 1 changed file with 46 additions and 45 deletions.
91 changes: 46 additions & 45 deletions src/PostgREST/CLI.hs
Original file line number Diff line number Diff line change
Expand Up @@ -125,43 +125,42 @@ readCLIShowHelp =

exampleConfigFile :: [Char]
exampleConfigFile =
[str|## The standard connection URI format, documented at
|## https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-CONNSTRING
|db-uri = "postgresql://"
|
|## The name of which database schema to expose to REST clients
|db-schemas = "public"
[str|## Admin server used for checks. It's disabled by default unless a port is specified.
|# admin-server-port = 3001
|
|## The database role to use when no client authentication is provided
|# db-anon-role = "anon"
|
|## Number of open connections in the pool
|db-pool = 10
|## Notification channel for reloading the schema cache
|db-channel = "pgrst"
|
|## Time to live, in seconds, for an idle database pool connection
|db-pool-timeout = 10
|## Enable or disable the notification channel
|db-channel-enabled = true
|
|## Enable in-database configuration
|db-config = true
|
|## Extra schemas to add to the search_path of every request
|db-extra-search-path = "public"
|
|## Limit rows in response
|# db-max-rows = 1000
|
|## Stored proc to exec immediately after auth
|# db-pre-request = "stored_proc_name"
|## Number of open connections in the pool
|db-pool = 10
|
|## Notification channel for reloading the schema cache
|db-channel = "pgrst"
|## Time to live, in seconds, for an idle database pool connection
|db-pool-timeout = 10
|
|## Enable or disable the notification channel
|db-channel-enabled = true
|## Stored proc to exec immediately after auth
|# db-pre-request = "stored_proc_name"
|
|## Enable in-database configuration
|db-config = true
|## Enable or disable prepared statements. disabling is only necessary when behind a connection pooler.
|## When disabled, statements will be parametrized but won't be prepared.
|db-prepared-statements = true
|
|## Determine if GUC request settings for headers, cookies and jwt claims use the legacy names (string with dashes, invalid starting from PostgreSQL v14) with text values instead of the new names (string without dashes, valid on all PostgreSQL versions) with json values.
|## For PostgreSQL v14 and up, this setting will be ignored.
|db-use-legacy-gucs = true
|## The name of which database schema to expose to REST clients
|db-schemas = "public"
|
|## How to terminate database transactions
|## Possible values are:
Expand All @@ -175,23 +174,26 @@ exampleConfigFile =
|## Transaction is rolled back, but can be overriden with Prefer tx=commit header
|db-tx-end = "commit"
|
|## Enable or disable prepared statements. disabling is only necessary when behind a connection pooler.
|## When disabled, statements will be parametrized but won't be prepared.
|db-prepared-statements = true
|## The standard connection URI format, documented at
|## https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-CONNSTRING
|db-uri = "postgresql://"
|
|server-host = "!4"
|server-port = 3000
|## Determine if GUC request settings for headers, cookies and jwt claims use the legacy names (string with dashes, invalid starting from PostgreSQL v14) with text values instead of the new names (string without dashes, valid on all PostgreSQL versions) with json values.
|## For PostgreSQL v14 and up, this setting will be ignored.
|db-use-legacy-gucs = true
|
|## Unix socket location
|## if specified it takes precedence over server-port
|# server-unix-socket = "/tmp/pgrst.sock"
|# jwt-aud = "your_audience_claim"
|
|## Unix socket file mode
|## When none is provided, 660 is applied by default
|# server-unix-socket-mode = "660"
|## Jspath to the role claim key
|jwt-role-claim-key = ".role"
|
|## Admin server used for checks. It's disabled by default unless a port is specified.
|# admin-server-port = 3001
|## Choose a secret, JSON Web Key (or set) to enable JWT auth
|## (use "@filename" to load from separate file)
|# jwt-secret = "secret_with_at_least_32_characters"
|jwt-secret-is-base64 = false
|
|## Logging level, the admitted values are: crit, error, warn and info.
|log-level = "error"
|
|## Determine if the OpenAPI output should follow or ignore role privileges or be disabled entirely.
|## Admitted values: follow-privileges, ignore-privileges, disabled
Expand All @@ -200,18 +202,17 @@ exampleConfigFile =
|## Base url for the OpenAPI output
|openapi-server-proxy-uri = ""
|
|## Choose a secret, JSON Web Key (or set) to enable JWT auth
|## (use "@filename" to load from separate file)
|# jwt-secret = "secret_with_at_least_32_characters"
|# jwt-aud = "your_audience_claim"
|jwt-secret-is-base64 = false
|
|## Jspath to the role claim key
|jwt-role-claim-key = ".role"
|
|## Content types to produce raw output
|# raw-media-types="image/png, image/jpg"
|
|## Logging level, the admitted values are: crit, error, warn and info.
|log-level = "error"
|server-host = "!4"
|server-port = 3000
|
|## Unix socket location
|## if specified it takes precedence over server-port
|# server-unix-socket = "/tmp/pgrst.sock"
|
|## Unix socket file mode
|## When none is provided, 660 is applied by default
|# server-unix-socket-mode = "660"
|]

0 comments on commit d2791ea

Please sign in to comment.