# Repl

Xpresser Repl

Xpresser Repl allows you to interact with your entire Xpresser application on the command line, including the current xpresser instance $.

To enter the repl environment, run the command

xjs repl

This command checks for a file named repl.js and if not found it provides an option to automatically create the needed file for you.

# repl.js

Your repl file is where the XpresserRepl class is called, and the node repl server is booted.

The xjs repl command creates these files for you.

Note: Running the repl file directly e.g node repl.js will start the repl as expected, but you may not get to use top level await function.

# Setup/Configuration

Setting up a perfect repl for your xpresser project is easy with the XpresserRepl class.

# Default Context

The variables listed below are auto-loaded on boot and available in your repl session.

Key Description
$ current xpresser instance

# Add Context

To add a context to your repl session

repl.addContext(key, value);
// Or using object
    key, value,
    key1, value2

# Add files to context

XpresserRepl includes a helper function that can load files into your context by requiring them.

    User: 'backend/models/User.js',
    Mailer: 'backend/libs/Mailer.js'

Key of file path will be used as the content key.

You can also group files into one contentName

    User: 'backend/models/User.js',
    Mailer: 'backend/libs/Mailer.js'
}, 'models')

Incomplete Documentation

This documentation is not yet complete! Check back in some days time.