Navigator Prefabricating Marinates

    file-morgan

    2.0.0 • Public • Published

    file-morgan

    NPM Version NPM Downloads Dependencies Build Status Test Coverage Join the chat at https://gitter.im/file-morgan/Lobby

    HTTP request logger middleware for node.js

    Log HTTP requests to the file system

    API

    var fileMorgan = require('file-morgan')

    fileMorgan(format, options)

    Create a new file-morgan logger middleware function using the given format and options. The format (same as morgan module) argument may be a string of a predefined name (see morgan predefined name) or a string of compiled format string (see morgan compile function).

    // BASIC EXAMPLE: save logs to a file named `access.log` placed in the `logs` directory
    fileMorgan('common')

    This will log all requests with error code 400 or higher to logs/access.log.

    This will only occur if NODE_ENV is set to production or forceProductionMode is set to true. Else all requests will be logged to the console ('dev' format).

    Options

    Options is the same as morgan module. Just added the following properties:

    • forceProductionMode
    • useStreamRotator
    • dateFormat
    • fileName
    • directory

    The option stream is removed/overwriten.

    forceProductionMode

    Used for developers to force logging when your application is not running in production mode. Default is false

    watchFiles

    For performance watching files is optional. When watching files on changes an change event is emitted. Default is false

    useStreamRotator

    When set to true a new log file will be created on daily basis. The format of the file is filename-date.log, where the filename is default access and the date is formatted as year-month-day (YYYYMMDD).

    dateFormat

    Will be used when useStreamRotator is set to true and will overwrite the default setting (YYYYMMDD).

    fileName

    Default is access.log.

    directory

    Default is logs

    // EXAMPLE: save logs to a file named 'errors-28022017.log'
    fileMorgan('common', {
        useStreamRotator: true,
        dateFormat: 'DDMMYYYY',
        fileName: 'errors.log',
        directory: 'logfiles'
    })

    Events

    For now file-morgan emits one event called change, as defined in SUPPORTED_EVENTS. To listen to events call on(eventName, listener) or addListener(eventName, listener)

    change

    The change event is emitted when a file has changed in the directory where logs are saved.

    Methods

    To listen to events there are two methods that can be used.

    addListener(eventName, listener)

    Alias for on(eventName, listener).

    on(eventName, listener)

    Adds the listener function for the event named eventName. The listener callback gets two arguments (path, stats). path is the path of the file that has changed, and stats are the stats (see fs.stats) of the file that has changed.

    fileMorgan.on('change', function(path, stats) {
        console.log('File ' + path + ' changed size to ' + stats.size)
    })

    To Do

    • Add eslint
    • Replace Object.assign with object-assign module
    • Check dependencies
    • Add GitHub information to package.json
    • Add tests
    • Add code coverage
    • Improve tests for default options
    • Improve code coverage
    • Fire event when log file is changed
    • Add npm information
    • Finish README
    • Add travis

    License

    MIT

    Install

    npm i file-morgan

    DownloadsWeekly Downloads

    2

    Version

    2.0.0

    License

    MIT

    Unpacked Size

    14.2 kB

    Total Files

    5

    Last publish

    Collaborators

    • tarabass