server_opts: Presser web server options

Description Usage Arguments Value Logging Examples

View source: R/server.R

Description

Presser web server options

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
server_opts(
  remote = FALSE,
  port = NULL,
  num_threads = 1,
  interfaces = "127.0.0.1",
  enable_keep_alive = FALSE,
  access_log_file = remote,
  error_log_file = TRUE,
  tcp_nodelay = FALSE,
  throttle = Inf
)

Arguments

remote

Meta-option. If set to TRUE, presser uses slightly different defaults, that are more appropriate for a background server process.

port

Port to start the web server on. Defaults to a randomly chosen port.

num_threads

Number of request handler threads to use. Typically you don't need more than one thread, unless you run test cases in parallel or you make concurrent HTTP requests.

interfaces

The network interfaces to listen on. Being a test web server, it defaults to the localhost. Only bind to a public interface if you know what you are doing. presser was not designed to serve public web pages.

enable_keep_alive

Whether the server keeps connections alive.

access_log_file

TRUE, FALSE, or a path. See 'Logging' below.

error_log_file

TRUE, FALSE, or a path. See 'Logging' below.

tcp_nodelay

if TRUE then packages will be sent as soon as possible, instead of waiting for a full buffer or timeout to occur.

throttle

Limit download speed for clients. If not Inf, then it is the maximum number of bytes per second, that is sent to as connection.

Value

List of options that can be passed to presser_app$listen() (see new_app()), and new_app_process().

Logging

<log-dir> is set to the contents of the PRESSER_LOG_DIR environment variable, if it is set. Otherwise it is set to <tmpdir>/presser for local apps and <tmpdir>/<pid>/presser for remote apps (started with new_app_procss()).

<tmpdir> is the session temporary directory of the main process.

<pid> is the process id of the subprocess.

Examples

1
2
# See the defaults
server_opts()

presser documentation built on July 1, 2020, 5:49 p.m.