route/vendor/github.com/Xe/x/irc/kcpd/stdlibsvc/README.md

3.2 KiB

Your stdlib service: xena/kcpdwhitelist

This is the README for your service.

A few notes;

package.json is NPM-compatible and contains some stdlib configuration details. .gitignore has also been provided for your convenience.

package.json

This is a standard package.json. You'll notice an additional "stdlib" field. You can configure your service for the stdlib registry using;

name - The name to register on stdlib, in the format of <username>/<service>. In order to compile to the registry you must have permission to compile to the provided username's account.

defaultFunction - Execute if provided no function route (root service). If not specified, your base service route will provide a list of available functions in JSON format.

timeout - The time in ms at which to kill service execution. Free accounts are limited to 30 seconds (30000).

publish - Whether to publish releases (versioned) to the stdlib public directory. Packages pushed to the registry in non-release environments will never be published.

env.json

Environment configuration for your service. Each top level key (i.e. "dev" and "release") specifies their own set of key-value pairs for a specific execution environment. The keys and values specified are automatically added to the process.env variable in Node.js.

"dev" is the non-configurable name of the local environment, but can also be used as an environment name for compilation (i.e. $ lib up development).

"release" is the non-configurable name of the production environment when you create releases with $ lib release.

You can add additional environments and key-value pairs, and use them for compilation with lib up <environment>. Note that free accounts are restricted to one compilation environment (aside from "release").

We recommend against checking this file in to version control. It will be saved with your tarball and is privately retrievable from the stdlib registry using your account credentials. It has been added to .gitignore by default.

f/main/function.json

This is your function definition file. The following fields can be used for execution configuration of specific functions within your service.

name - The function name. This maps to an execution route over HTTP. For example, xena/kcpdwhitelist/main would map to the first function you've created.

description - A brief description of the function. To provide detailed information about function execution, overwrite this README.

args - An Array describing each argument as you expect them to be passed to params.args.

kwargs - An Object describing each keyword argument as you expect them to be passed to params.kwargs

http - Information to provide to function requests over HTTP.

http.headers - HTTP headers to return in the response. Examples are "Content-Type" to specify file type if your function returns a Buffer or "Access-Control-Allow-Origin" to restrict browser-based function requests.

f/main/index.js

The entry point to your function described in f/main/function.json. This is non-configurable. You may add as many subdirectories and supportive files as you like, but index.js will remain the entry point and must export a function to be active.