5.8.3 ā€¢ Published 3 months ago

genserve v5.8.3

Weekly downloads
-
License
MIT
Repository
-
Last release
3 months ago
Genserve is a server generator to help manage non-blocking servers.
You can control spawned servers via command lines or within your code.
It can be used with a CI system, in a development environment, in production, etc.


1. Installation

npm install genserve -g

Windows

No extra configuration required

Linux

In the module, servers created with sudo and the standard user do not share the same directory.

Consequentially, genserve scan and sudo genserve scan may not give the same result.

To make both users use the same data directory, you can define the property GENSERVE_DATA to a shared location.

# Find the directory used by the default user
$> genserve show location main          # => /home/<user>/.local/shared

# Assign it to root
$> sudo genserve define GENSERVE_DATA "/home/<user>/.local/shared"

** You may need to review the permissions set on the shared folder (chmod)


It is also possible to set a value to GENSERVE_DATA as an environment variable

For instance:

# Define the environment variable GENSERVE_DATA
$> export GENSERVE_DATA="/home/user/data"

2. Usage

In a Terminal

$> genserve [command] [target] [--port number] [--dir path]

In a script

For CommonJs

// CommonJs
const {startGenServer, stopGenServer, infoGenServer} = require("genserve");

await startGenServer({...});                    // Start a server
await stopGenServer({...});                     // Stop a server
const json = await infoGenServer({...});        // Get server info in a JSON formatted string

For ESM

// ESM
import {startGenServer, stopGenServer, infoGenServer} from "genserve";

await startGenServer({...});
await stopGenServer({...});
const json = await infoGenServer({...})

3. Notes

  • v5 is downward compatible with v4
  • v4 is downward compatible with v3
  • v3 is not downward compatible
  • v3 up to 3.7.0 is not production ready
  • v2 is not downward compatible and production-ready
  • v1 is not production ready and uses a different engine
  • v5 offers greater stability and security
  • v4 offers mitigated stability and security (after numerous testing)
  • v3 offers poor stability and security
  • v1 and v2 should be used in development mode only
  • The module name may change
  • The latest code is only available in the npm package (MIT License) and is constantly tested for bugs and security issues
  • Bug reports can still be posted at https://github.com/thimpat/genserve/issues
  • Many GenServe functionalities are still undocumented. Some updates soon.

4. Quick start

Start a server

$> genserve start

Display the server status

$> genserve status            # The server [randomname] is up

Restart the server using port 5000 and serving a different directory

$> genserve restart --port 5000 --dir myfolder

Stop the server

$> genserve stop

Stop all registered servers

$> genserve shutdown

5. Overview

Launch a server in the background and run some tests (using that server) in the same terminal
  • Step 1: Spawn a non-blocking server
$> genserve start server
  • Step 2: Run tests (from the same terminal)
$> npm test
  • Step 3: Stop the server
$> genserve stop server

tests-from-shell.gif


6. Commands

In the descriptions below, \<servername> is a placeholder.

NOTE: Server names and namespaces should be lowercase with no dot symbols


backup

Save namespace

# Save namespace to ./out/ns1.zip
$> genserve backup ns1 ./out

build

Build a set of commands

sophia.default.json
{
    ...
    "build": [
        "node ./node_modules/stylus/bin/stylus -m ./stylus --out ./css",
        "node ./node_modules/sass/sass.js ./scss:./css"
    ]
    ...
}
// Will generate a build based on the build field content
$> genserve build config ./sophia.default.json 

If the server is already created, genserve build sophia is enough

```bash
$> genserve build sophia 

clone

Clone a server

$> genserve clone servername <servertarget>
Example
$> genserver clone genesis1 genesis2  

create

Create a server without starting it

$> genserve create <servername>

or

# Create a server from a configuration file
$> genserve create config <filepath>
Example
# Create a server with property port = 3001
$> genserver create genesis1 --port 3001  

# Start server on port 3001
$> genserver start genesis1  

# Stop server
$> genserver stop genesis1

delete

Alias of the remove command

$> genserve delete <servername>

deploy

Unpack a server archive and start a server against the deployed folder

$> genserve deploy mypacked.zip ./target

description

Show a server description

$> genserve description <servername>

To set a description, you can use the set command

$> genserve set genesis --description "PNG server"

edit

Edit session file in the O.S. default editor

To edit server settings
$> genserve edit server <servername> 

examples:

$> genserve edit server genesis             # Edit settings against the registered server
$> genserve edit settings genesis           # Same as above
$> genserve edit genesis                    # Same as above

To edit global settings, omit the server name

$> genserve edit settings                     # Edit global settings
$> genserve edit logs                         # Edit global logs

enable

Enable a property on a server

šŸš« Note: Users must stop the server before being able to change properties.

$> genserve enable <servername> propertyname 
Example
$> genserve enable genesis cors

Activatable Options

OptionsdefaultExpectDescription
corsfalsebooleanEnable CORS on selected server
sslfalsebooleanEnable SSL on selected server
exploretruebooleanEnable listing mode on selected server

NOTE: There are two ways to enable/disable one of these options

Via enable/disable commands

$> genserve <enable|disable> <servername> [options]

# example
$> genserve disable genesis explore

2- Via flags

$> genserve <commands> <servername> <--options on|off> 

# example
$> genserve start genesis --explore off

Explorer view example:

tests-from-shell.gif


erase

Remove namespace reference.

You must stop all servers on this namespace; otherwise, the command will fail.

$> genserve erase ns1

exec

Execute the given script file

Example

$> genserve exec /path/to/my-script.genserve

Content example

# Comments start with a hash.

start my-server-1

scan

list

stop my-server-1

The command exec will execute every line from "my-script.genserve" except for the first line (comment).


flush

Remove all registered servers (must be stopped and unprotected).

$> genserve flush

get

Display server property (Use $> genserve info command to also have the server instance).

šŸš« Note: Users must stop the server before being able to change properties.

$> genserve get tom

info

Display server information

$> genserve info genesis

šŸ’»ā†“

              serverName: genesis
             defaultPage: index.html
                protocol: http://
                    host: localhost
                    port: 57485
               enableapi: true
                 timeout: 12000
               namespace: default
       perMessageDeflate: false
            showRequests: no
   exitWithParentLatency: 30000
       noActivityTimeout: 0
        strictServerPort: yes
                     ssl: off
         allowSelfSigned: no
              enablecors: off
           enableexplore: on
             monitorDirs:
             dynamicExts: .server.[cm]?js
                    runs: 1
                   fails: 0
          serverFullName: genesis.default
                  active: false

investigate

Display various information (port related)

$> genserve investigate port 16033

šŸ’»ā†“

 [17:55:37]     CLIENT: (4308) ā–¶  Server using port 16033:
 [17:55:37]     CLIENT: (4212) ā–¶  [server1.genserve-e2e-terminal] is not running, but set to port 16033
 [17:55:37]     CLIENT: (4312) āœØ  [server2.genserve-e2e-terminal] is currently using the port 16033

list

Show list(s) of created named servers.

$> genserve list [all]

The option "all" will do the listing on all declared namespaces.


load

Load a server configuration from a file then restart the targeted server.

# Load server configuration using a filename
# The file must be located in the current directory. Format: <servername>.<activeNamespace>.json
$> genserve load testfile         # => ./testfile.default.json

or

# Load server configuration from a file path
$> genserve load ./some/path/testfile.default.json

# or

$> genserve load config ./some/path/testfile.default.json

lock

Prevent a server from being stopped. The commands stop [all], start [all], restart [all], set [all]will have no effect on this server.

$> genserve lock <servername>

or

$> genserve start <servername> --lock

log

Display log for a server. If you set the --open option, genserve will try to open the log in an editor.

$> genserve log <servername> [--open]

pack

Create

Create an archive containing all of the files the server uses in its configuration (staticDirs, dynamicDirs, etc.) This command is useful when you want to run a server in isolation (During a deployment for instance)

$> genserve pack

path

Show path to a server settings file:
$> genserve path settings <servername>

ping

Tell whether the server API is active

$> genserve ping <servername>

project

To generate a GenServe project in the current working directory.

$> genserve project <projectname>
Example
$> genserver project myproj  

The generated project will follow this structure:

šŸ“ projectname                 
ā”‚
ā””ā”€ā”€ā”€šŸ“ build                      ā‡½ A build directory that triggers auto-reload on changes
ā”‚
ā””ā”€ā”€ā”€šŸ“ dynamic                    ā‡½ Directory to hold dynamic pages
ā”‚           šŸ“ index.server.cjs   ā‡½ A dynamic page example
ā”‚           
ā””ā”€ā”€ā”€šŸ“ stats               
ā”‚                                 ā‡½ The statistic plugin installed by default (in a subfolder)
ā”‚
ā””ā”€ā”€ā”€šŸ“ static                     ā‡½ Directory for static pages
ā”‚          šŸ“ index.html          ā‡½ A static page example   
ā”‚   
ā””ā”€ā”€ā”€šŸ“ src                        ā‡½ Source directory (not used by the system)
ā”‚
ā””ā”€ā”€ā”€šŸ“ start
           šŸ“ start.js**          ā‡½ Every time the server starts or restarts, it will launch this script.  
** To disable loading plugins, pass an empty array to the "plugins" property in the server configuration.

** To disable the launching script (start.js), override the "dynStart" property in the server configuration.

protect

Prevent a server from being removed from the registered server list. The commands flush, remove [all] will not affect this server.

$> genserve protect <servername>

or

$> genserve start <servername> --protect

pull

Write server info into a file. The filename depends on the server name.

// Create the config file [tom.default.info.json] 
$> genserve get tom

push

Update server properties with the one written in the pulled one.

// Will update the tom server with the content from [tom.default.info.json] 
// You must pull the server config, edit the file, and then push it.
$> genserve push tom 

remove

Remove a server from the registered server list.

$> genserve remove <servername>

rename

Rename a server

$> genserve rename servername <servertarget>

reset

Reset application default values to factory values

$> genserve reset

restart

Restart a server

$> genserve restart <servername>

restore

Restore namespace

# Restore namespace from a folder or a file
$> genserve restore ./out/ns1.zip

save

Save server configuration

# Save server configuration into a ./testfile.json file
$> genserve save testfile

scan

Show a list of servers along with which ones are running.

$> genserve scan [all]

The option all will scan all declared namespaces.

examples

# Scan the default namespace
$> genserve scan
# Scan a namespace called "special"
$> genserve scan special

search

Returns server names with given properties.

$> genserve search <props>

examples

# Look for a server whose port equals 16042 in all namespaces
$> genserve search port:16042

šŸ’»ā†“

 [19:04:29]     CLIENT: (4412)   Found [server1.genserve-e2e-terminal]
 [19:04:29]     CLIENT: (4412)   Found [server2.genserve-e2e-terminal]

set

Modify server property if not locked.

šŸš« Note: If the server is running, it will be stopped and then restarted right after the modifications

$> genserve set tom --port 6000 --dir public 

show

Display various pieces of information

# Show all running servers
$> genserve show up
# Show all inactive servers
$> genserve show down
# Show all servers
$> genserve show servers
# Display namespace list
$> genserve show namespaces
# Show active namespace
$> genserve show active namespace
# Show running servers
$> genserve show active servers
# Show default namespace
$> genserve show default namespace
# Show default server for a directory
$> genserve show default server
# Show application data directory
$> genserve show location data
# Show namespaces location
$> genserve show location namespaces
# Show namespace location for "default" namespace 
$> genserve show location namespace default
# Show server setting location for "genesis"  
$> genserve show location server genesis
# Show the server name that will be used against the current directory
# if a command is started with no option 
options
$> genserve show linked server        # i.e. genesis => [genserve start] will launch the "genesis" server
# Show all servers which project root is set to the current directory
$> genserve show linked servers

Shutdown

Stop all non-locked servers from all namespaces.

$> genserve shutdown [now]

Use $> genserve shutdown now to perform the action immediately.


start

Start a server named <servername> on any available port serving the current directory.

When servername is missing, it uses "default" as a name or generates a random name depending on the configuration.

$> genserve start <servername>
Example
# Will generate a server running against the current directory 
$> genserve start
# Will generate a server named genesis
$> genserve start genesis
# Will generate a server from a config file
$> genserve start config ./some/path/genesis.default.json

Start from a config file

You can also start the server from a configuration file after its creation.

Example
# Create a server called genesis 
$> genserve create genesis

# Pull the configuration to the current directory =>  /current-location/genesis.default.json
# You can edit the file (genesis.default.json) to apply your settings.
$> genserve pull genesis

# Start the server from the pulled configuration file
$> genserve start --config ./genesis.default.json
Now, you can always use this file to start your server, which should also ease sharing server configurations.

By default, when a server configuration file is named ".genserverc", you won't need to specify a value for the --config option

$> genserve start --config

# Same as
$> genserve start --config .genserverc

status

Display a server status

$> genserve status genesis

stop

Stop a server

$> genserve stop <servername>

unlock

Unlock a locked server.

$> genserve unlock genesis

unpack

Unpack a previously packed archive

$> genserve unpack mypacked.zip ./target/folder

7. Namespaces

All servers are created in the "default" namespace. It is, however, possible to add more than one namespace.

namespace

To select a namespace by defining a namespace by default:
# The namespace "ns1" will be the default for all GenServe commands
$> genserve namespace ns1
To select a namespace with the --namespace option
# It will override the default namespace
$> genserve start myserver --namespace ns2
To select a namespace using the canonical form
# Examples:
$> genserve start myserver.ns2      # server = myserver / namespace = ns2    
$> genserve stop myserver.ns2
$> genserve info myserver.ns2
$> genserve remove myserver.ns2
$> genserve enable myserver.ns2 cors
$> genserve disable myserver.ns2 ssl

GENSERVE_NAMESPACE environment variable

You can also define the environment variable GENSERVE_NAMESPACE with the namespace value you want, and it will be used by all commands.

  • On Windows Powershell:
PS C:\path> $env:GENSERVE_NAMESPACE = "ns3"
PS C:\path> genserve start myserver
  • On Linux & MAC:
$> export GENSERVE_NAMESPACE = "ns3"
$> genserve start myserver
  • On Windows CMD:
$> set GENSERVE_NAMESPACE=ns3
$> genserve start myserver

Refer to your O.S. for more advanced options for setting up environment variables.


8. Batch Operations

The option "all" allows targeting all elements in a namespace

Examples

# Start all registered and unlocked servers.
$> genserve start all

# Restart all registered and unlocked servers
$> genserve restart all

# Stop all running and unlocked servers.
$> genserve stop all

# Remove all registered and unprotected servers.
$> genserve remove all

# Display all registered servers' statuses.
$> genserve status all

# Lock all registered servers.
$> genserve lock all

# Unlock all registered servers.
$> genserve unlock all

### etc.

9. Selected/Selecting

The options "selected" or "selecting" allow targeting elements defined by a regular expression

All the commands supporting the "all" extension also support the "selected" extension.

# GenServe will start all servers whose names start with "myserver"
$> genserve start selected "^myserver.*"

or

$> genserve start selecting "^myserver.*"

However, the "create" and "project" command requires the use of the option --namespace

# Invalid:
$> genserve create myserver.ns2

# Valid
$> genserve create myserver --namespace ns2

10. Options

Options modifiable via CLI

The options can be set with the set command. They can also be defined with start, restart, stop
commands.

OptionsdefaultExpectDescription
--blockmodefalsebooleanRun the server without quitting (start and restart commands). The server stops with CTRL + C
--buildfalsebooleanExecute build before starting a server
--cert""stringPath to ssl cert file
--cleanfalsebooleanAlso delete the log file when a server or a namespace is erased/deleted
--defaultPageindex.htmlstringDefault page to serve
--dir.string[]Directories to serve
--dynStart""stringRun some JavaScript files before the server starts in the same process as the server
--forcefalsebooleanForce the execution of a command even if one or more servers run
--helpfalsebooleanDisplay help
--key""stringPath to ssl key file
--mode"""production", "development"Server mode
--noActivityTimeout0numberStop server if no activity is detected after x milliseconds (0 for infinity)
--openPage""stringOpen the given page in a browser when the server starts
--openApp""string[]Run passed processes or JavaScript files before the server start
--platform"default""darwin", "linux", "win32", ...Tell GenServe what platform the host is to load its configuration
--portrandomintegerPort to run the server on
--projectroot""stringProject root directory
--protocolhttp://stringProtocol used by server
--silentfalsebooleanWhether to display messages
--ssloffon/offEnable https
--unprocessed""stringURI to a static or a dynamic page to handle missing and unprocessable requests
--versionfalsebooleanDisplay version
--remoteapifalsebooleanEnable remote server API
--apiportrandomintegerPort to control server

--cert

Pass to a server ssl certificate

$> genserve --cert path

--key

Pass to a server private key

$> genserve --key path

--openApp

This option allows invoking processes before the server starts

$> genserve start [--openApp <myBinary>] [--openApp <myBinary>] ...

example:

# Open http://localhost:12000 in Chrome (Canary) with the Chrome flag --no-sandbox enabled 
$> genserve start --openApp "'C:/Users/<me>/AppData/Local/Google/Chrome SxS/Application/chrome.exe' 'http://localhost:12000' --ignore-certificate-errors""

--clean

This option allows deleting all created log files for a server or namespace when destroyed

# Delete server and logs
$> genserve remove genesis4 --clean

# Delete all servers in mynamespace + logs
$> genserve erase mynamespace --clean

--platform

This option allows loading some configurations depending on the platform they are running on. It is helpful to make differences between paths, for instance (Win32, Linux, Mac).

{
    "staticDirs": ["/home/user/mydir"],
    "platforms": {
        "linux": {
            "staticDirs": ["/home/user/mydir1", "/home/user/mydir2"]
        },
        "darwin": {
            "staticDirs": ["/home/user/mydir1", "/home/user/mydir2"]
        },
        "win32": {
            "staticDirs": ["C:/projs/mydir1", "C:/projs/mydir2"]
        },
        "custom": {
            "staticDirs": ["./anywhere"]
        },
        "default": {
            "staticDirs": ["/home/user/mydir"]
        }
    }
}

In this example, the "linux" section will override the default configuration.

$> genserve start server1 --platform linux  

If platform is not specified, the system detect which platform it is running on and load the appropriate section if defined.


--section

This option allows loading some custom configurations depending on the value set to --section

{
    "sections": {
        "localth1": {
            "port": 10230,
            "staticDirs": ["/home/user/mydir1", "/home/user/mydir2"]
        },
        "localth2": {
            "port": 10232,
            "staticDirs": ["/home/user/mydir3", "/home/user/mydir3"]
        }
    }
}

In this example, the "localth1" section will override the default configuration.

$> genserve start server1 --section localth1  

--ssl

  • Option 1

Enable SSL via command line:

$> genserve --ssl --cert /path/to/cert --key /path/to/key

Enable SSL via config file (See config section for more info)

  • Option 2

Stop the server

# default is the namespace by default. You can ignore it if you never use the option.
$> genserve stop yourservername --namespace default     

Locate the configuration file

$> genserve path settings <servername> --namespace default        # => Then edit the given path 

### or

# If you have set a default editor in your O.S. 
$> genserve edit server <servername> --namespace default

Edit to update it

{
  "yourservername": {
    "serverName": "yourservername",
    "defaultPage": "index.html",
    "protocol": "https://",
    "host": "yourservername.live",
    "port": 443,
    "serverUrl": "https://yourservername.com/",
    "ssl": "on",
    "cert": "/path/to/certificates/ssl/yourservername.crt",
    "key": "/path/to/certificates/yourservername/ssl/yourservername.key",
    "ca": "/path/to/certificates/yourservername/ssl/yourservername.ca-bundle",
      ...
  }
}

Start the server

$> genserve start yourservername --namespace default     

Enable CORS

To enable CORS:

$> genserve enable servername cors

To customise CORS, edit the server's file.

$> genserve edit server <servername>

Global Options modifiable Via Configuration file

To get the path to the file that holds default global settings:

$> genserve path settings --global

To edit

$> genserve edit settings --global

šŸ“ .genserve.cjs ā†“

module.exports = {
    "protocol": "http://",
    "host"    : "desktop-amd",
    API       : {
        "GREETINGS"    : "Hello!",
        "SERVER_STATUS": {
            "SERVER_STARTED" : "SERVER_STARTED",
            "SERVER_RUNNING" : "SERVER_RUNNING",
            "GET_SERVER_INFO": "GET_SERVER_INFO"
        }
    }
};

staticDirs: Directories to serve (The first directory specified has precedence over the other and so on)


11. Examples

Start server serving multiple directories

$> genserve start --dir public --dir build

Stop default server

$> genserve stop

Start a named server on port 10040 serving the working directory

$> genserve start genesis --port 10040

Stop the named server

$> genserve stop genesis

Show list of registered servers

$> genserve scan

šŸ’»ā†“

active ā”‚ serverName ā”‚ serverUrl                 ā”‚ port  ā”‚ staticDirs                         ā”‚ defaultPage  ā”‚
ā”€ā”€ā”€ā”€ā”€ā”€ ā”‚ ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ ā”‚ ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ ā”‚ ā”€ā”€ā”€ā”€ā”€ ā”‚ ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ ā”‚ ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ ā”‚
false  ā”‚ default    ā”‚ http://localhost:60287/   ā”‚ 60287 ā”‚ C:\projects\genserve\public        ā”‚ index.html   ā”‚
false  ā”‚ genesis    ā”‚ http://localhost:10040/   ā”‚ 10040 ā”‚ C:\projects\genserve               ā”‚ index.html   ā”‚

It is possible only to show some columns with the option --columns.

# This command will only present the columns active, serverUrl, port and serverName
$> genserve scan --columns "serverUrl,port"

šŸš« Note: The column "serverName" is always displayed


Run server from a shell or in a CI system

# Start the server in the background
$> genserve start testserver --dir . --port 5000

# Run your tests
$> npm test

# Stop the server
$> genserve stop testserver

Run a server from within a script

(async function ()
{

    const {startGenServer, stopGenServer, infoGenServer} = require("genserve");

    // Server name
    const SERVER_NAME = "my-test-server";

    // Start the server, which name will be "my-test-server"
    const serverStarted = await startGenServer({name: SERVER_NAME, port: 9880});
    if (!serverStarted)
    {
        console.error("Failed to start server");
        return ;
    }

    // Display info server (Optional)
    const data = await infoGenServer({name: SERVER_NAME});
    console.log(data);

    // Stop the server "my-test-server"
    await stopGenServer({name: SERVER_NAME});

}())

12. How to

https://genserve.net/help.html


13. Stats Plugins

Web-Analyst plugin is a plugin for Genserve: https://www.npmjs.com/package/web-analyst

Screenshot


14. Performance

Node v16.17.0 | O.S.: Windows 11 | Processor: AMD

Performance Tests

Five round of short sessions + one longer session

# 5 rounds
$> loadtest -c 10 --rps 500 -t 10 http://127.0.0.1:xxxx/random.html
$> loadtest -c 10 --rps 500 -t 10 http://127.0.0.1:xxxx/random.html
$> loadtest -c 10 --rps 500 -t 10 http://127.0.0.1:xxxx/random.html
$> loadtest -c 10 --rps 500 -t 10 http://127.0.0.1:xxxx/random.html
$> loadtest -c 10 --rps 500 -t 10 http://127.0.0.1:xxxx/random.html

# 1 round
$> loadtest -c 10 --rps 1000 -t 20 http://127.0.0.1:xxxx/random.html

Every engine uses its default configuration

EngineVersionRPS*(5 rounds) Completed Requests in 10s(1 round) Completed requests in 20s
nginx1.22.04684728 - 4721 - 4717 - 4804 - 474019571
xampp14.0.03954663 - 4704 - 4834 - 4747 - 478319527
genserve4.0.64704750 - 4723 - 4705 - 4711 - 478919583
http-server14.0.04684716 - 4712 - 4800 - 4804 - 469617940
*  Requests per seconds

15. Stability

Node v16.17.0 | O.S.: Windows 11 | Processor: AMD

Stability Tests

Increasing number of requests per seconds

# Increasing requests per session
$> loadtest -c 20 --rps 2000 -t 20 http://127.0.0.1:xxxx/random.html
$> loadtest -c 50 --rps 5000 -t 20 http://127.0.0.1:xxxx/random.html
$> loadtest -c 100 --rps 10000 -t 20 http://127.0.0.1:xxxx/random.html

Every engine uses its default configuration

EngineVersionCompleted requests in 20s at 1000 RPS*2000 RPS5000 RPS10000 RPS
nginx1.22.01957138711Errors (1464)Errors (20385)
xampp14.0.0195273883449226Errors (28076)
genserve4.0.6195833899646223Errors (461)
http-server14.0.017940Errors (19579)Errors (19184)Errors (18156)
*  Requests per seconds

Changelog

current:
  • Apply --json option to shutdown command
5.8.1:
  • Fix url incorrectly generated when missing forward slashes in urls
5.8.0:
  • Fix commands not generating slug for server name
  • Check whether project root exists
  • Fix --json option not applied on errors
  • Add --blockmode option to non-cli commands
  • Add support to dir option for command run from code (non-cli)
5.7.2:
  • Set project root programmatically
5.7.0:
  • Fix scan all with enabled --json option
  • Enable --json option for scan command
5.6.0:
  • Fix formatted output for --js option
5.5.0:
  • Increase server starting speed
  • Fix server hanging when plugin code not following new convention
  • Add an extra special callback system to plugins
5.4.7:
  • Add an error message in the info command
5.4.6:
  • Fix validator not set on the correct static directory
5.4.5:
  • Fix staticDirs populated with same values
5.4.4:
  • Fix plugin not working with dependent servers
  • Fix full server name evaluation
5.4.3:
  • Fix pack process for deployment
5.4.2:
  • Fix plugin support on configuration multi-domains
5.4.1:
  • Always pack on the deploy command even when all files on the remote are up-to-date
  • Fix SSH connection not close on remote file listing
5.4.0:
  • Fix local deployment
  • Add an index command
  • Reduce generated pack file for deployment to a minimum size by comparing indexes
  • Fix validators not set correctly
5.3.2:
  • Display a message instead of an error when a staticDirs item is not set on disk
5.3.1:
  • Fix deployment closing prematurely
5.3.0:
  • Add post-pack build step
  • Add a post-build field
5.2.0:
  • Show process id (pid) on scan command
  • Add more information to the info command
  • Display server names using the same port instead of host names
5.1.0:
5.0.0:
  • Fix the errors field
  • Show CPU usage and memory consumption of server child
  • Add --monitor option to monitor cpu usage and memory consumption
  • Generate a README file on deployment
  • Update libutils dependency to fix plugin installation breaking
  • Fix platforms fields overwritting sections and remotes fields
  • Fix extra values added to server configuration on pack command
  • Always display output on npm install
  • Remove devDendencies from package.json on deployment
  • Display additionnal information on remote install
  • Display messages instantly on remote install
  • Fix generated archive
  • Display more messages on publish
  • Fix publish commands using erroneous arguments
  • Fix publish missing .genserverc file
  • Fix an issue with the publish command
  • Fix deploy to remote command
  • Fix deploy command not working with bare --config
  • Allow using the --config option with no predefined value
  • Fix options --section and --platform not working with the deploy command
  • Restore sections functionalities
  • Fix unsupported request error on child server
  • Prettify json generated files
  • Add property modulelink to plugin field for helping with debugging
  • Display installed plugins versions
  • Display installed dependencies versions
  • Do not serve current folder on project command
  • Fix autoreload not working with relative paths
  • Add enable property to disable a plugin
  • Restore and Reimplement reset command
  • Display more messages when publishing
  • Fix server not starting on undefined session child
  • Fix remove command with --force option
  • Fix application not finding template path
  • Allow deleting default attached server with the --force option
  • Fix project command not finding the web-analyst plugin
  • Fix backup command
  • Fix progress bar on upload
  • Allow assigning namespace from a remote field
  • Fix publicDirs property not updated on remote
  • Show progress bar on uploading to remote
  • Display generated archive size
  • Add publicDirs property
  • Set highest priority on values set directly on a remote field instead of an external configPath
  • Fix errors not showing on npm install
  • Fix permission error on directories
  • Fix js function error not found
  • Add basic forwarding port
  • Fix publish command to remote
  • Review session variable solver
  • Add more recognisable variables
  • Fix statistic plugin integration
  • Update statistics plugin
  • Review statistic plugin
  • Add default as alias for show default
  • Fix error on info command with port option
  • Allow installing by copy or not the node_modules directory with the --whole option
  • Add a --whole option to force copy the node_modules directory during packing and deploying
  • Show why a port is unavailable when starting a server
  • Remove symbols on search command
  • Add search command
  • Add --section option
  • Display log from build section quicker
  • Fix error uninitialised session
  • Show an error if certain symbols are not exported
  • Fix the eventually property ignored when triggered on server side
  • Fix module not found error after minification
  • Cancel operation when cannot overwrite log file
  • Fix unauthorized message displayed instead of unsupported request message
  • Review plugin system
  • Review auto-reload
  • Fix staticDirs.filter not a function error
  • Add validators for restricting access to directories
  • Take projectRoot field into account when solving directories
  • Convert tilde ~ symbol when passing the --config option
  • Review priorities for attributing deployment server name
  • Add a message during clean remote deployment
  • Fix html error page not showing
  • Fix remote deployment
  • Review remote deployment
  • Add --clean option force clean deployment
  • Fix local deployment
  • Allow passing --config option without .zip package to deploy command
  • Fix an error with non-existent path
  • Allow rendering HTML via configuration errors field
  • Fix error key not taken into account
  • Display server urls by ip
  • Allow using tilde symbol ~ in the --config option
  • Fix remote deployment with the --config option
  • Look for config path in the same location as the session referencing it
  • Review displayed messages
  • Set hostname on deployed file after installation
  • Stop remote deployment earlier when econfig path is non-existent
  • Add --config option to the update command
  • Restore note info 4568
  • Fix commands using short filename as server
  • Fix various commands with options
  • Fix commands using batch options
  • Add command show active with no extra options
  • Add command show default with no extra options
  • FIX create config command with absolute path
  • Fix error 4199
  • Allow deployment to remote
  • Remove extra error message on failing deployments
  • Fix local deploy command
  • Remove extra error message when a config file is not found
  • Remove [] when config to filepath is miscalculated
  • Fix push command
  • File load command
  • Fix server selection when no options is passed to a command
  • Fix default platform section automatically applied
  • Fix added command set when executing stop command
  • Fix error 3131
  • Fix the erase all command
  • Fix update command
  • Fix create command
  • Add update command
  • Fix flush command
  • Fix deployment tests

5.8.3

3 months ago

5.8.2

7 months ago

5.8.1

7 months ago

5.8.0

7 months ago

5.7.3

8 months ago

5.7.2

8 months ago

5.5.0

9 months ago

5.6.1

9 months ago

5.7.1

8 months ago

5.7.0

8 months ago

5.0.0-beta.6

1 year ago

5.0.0-beta.7

1 year ago

5.0.0-beta.0

1 year ago

5.0.0-beta.1

1 year ago

3.13.1

2 years ago

4.0.5

2 years ago

4.4.0

2 years ago

4.0.4

2 years ago

4.0.7

2 years ago

4.0.6

2 years ago

4.0.1

2 years ago

4.0.0

2 years ago

4.0.3

2 years ago

4.0.2

2 years ago

5.4.7

1 year ago

5.0.2

1 year ago

5.0.1

1 year ago

5.0.0

1 year ago

4.0.9

2 years ago

4.0.8

2 years ago

3.13.0

2 years ago

4.3.1

2 years ago

4.3.3

2 years ago

4.3.0

2 years ago

3.15.0

2 years ago

3.15.2

2 years ago

3.15.1

2 years ago

3.15.3

2 years ago

5.0.0-beta.12

1 year ago

5.0.0-beta.10

1 year ago

5.0.0-beta.16

1 year ago

5.0.0-beta.13

1 year ago

5.0.0-beta.14

1 year ago

4.2.0

2 years ago

4.1.0

2 years ago

3.7.5

2 years ago

3.7.4

2 years ago

3.3.8

2 years ago

3.7.3

2 years ago

3.3.7

2 years ago

3.3.6

2 years ago

3.7.6

2 years ago

3.2.1

2 years ago

3.6.1

2 years ago

3.6.0

2 years ago

3.12.0

2 years ago

3.1.0

2 years ago

3.5.3

2 years ago

3.5.2

2 years ago

3.5.1

2 years ago

3.5.0

2 years ago

3.9.0

2 years ago

3.0.3

2 years ago

3.10.0

2 years ago

3.4.3

2 years ago

3.4.2

2 years ago

3.3.1

2 years ago

3.3.0

2 years ago

3.11.0

2 years ago

3.7.1

2 years ago

3.3.5

2 years ago

3.7.0

2 years ago

3.3.4

2 years ago

3.3.3

2 years ago

3.3.2

2 years ago

2.1.0-beta-2

2 years ago

2.1.0-beta-1

2 years ago

2.0.3-beta.0

2 years ago

2.4.1

2 years ago

2.4.0

2 years ago

2.6.0

2 years ago

2.8.0

2 years ago

2.0.1-beta.0

2 years ago

2.3.0

2 years ago

2.5.0

2 years ago

2.7.0

2 years ago

2.9.0

2 years ago

2.7.2

2 years ago

2.7.1

2 years ago

2.0.2-beta.0

2 years ago

2.0.0-beta.0

2 years ago

2.1.0

2 years ago

2.1.0-beta.0

2 years ago

2.1.0-beta.3

2 years ago

2.1.0-beta.5

2 years ago

2.1.0-beta.4

2 years ago

1.31.0

2 years ago

1.30.0

2 years ago

1.29.5

2 years ago

1.29.4

2 years ago

1.29.3

2 years ago

1.29.2

2 years ago

1.29.1

2 years ago

1.29.0

2 years ago

1.28.0

2 years ago

1.27.0

2 years ago

1.26.0

2 years ago

1.26.1

2 years ago

1.25.1

2 years ago

1.25.0

2 years ago

1.24.0

2 years ago

1.23.0

2 years ago

1.22.0

2 years ago

1.21.7

2 years ago

1.21.6

2 years ago

1.21.1

2 years ago

1.21.0

2 years ago

1.19.0

2 years ago

1.18.1

2 years ago

1.17.6

2 years ago

1.17.5

2 years ago

1.17.4

2 years ago

1.17.3

2 years ago

1.17.2

2 years ago

1.17.1

2 years ago

1.17.0

2 years ago

1.16.1

2 years ago

1.16.0

2 years ago

1.14.2

2 years ago

1.14.1

2 years ago

1.14.0

2 years ago

1.13.5

2 years ago

1.13.4

2 years ago

1.13.3

2 years ago

1.13.2

2 years ago

1.13.1

2 years ago

1.13.0

2 years ago

1.12.3

2 years ago

1.12.2

2 years ago

1.12.1

2 years ago

1.10.2

2 years ago

1.10.1

2 years ago

1.10.0

2 years ago

1.9.1

2 years ago

1.9.0

2 years ago

1.7.0

2 years ago

1.6.0

2 years ago

1.5.1

2 years ago

1.5.0

2 years ago

1.4.5

2 years ago

1.4.4

2 years ago

1.4.3

2 years ago

1.4.2

2 years ago

1.4.1

2 years ago

1.4.0

2 years ago

1.3.0

2 years ago

1.2.1

2 years ago

1.2.0

2 years ago

1.1.0

2 years ago

1.0.0

2 years ago