httpdir v2.1.0

Simple, zero dependency command-line HTTP server for static local files

• Installation
• Usage
  • CLI
  • Node module
• Changelog
• License

Installation

This module needs Node >=14.

Install with npm:

$ npm install httpdir --global

Usage

CLI

httpdir <path> <port>

Example:

# This will start a local server on port `8090`,
# with `~/Desktop` as root directory
httpdir ~/Desktop 8090

Default path is ., default port is 8080.

Node module

Import httpdir and create a server:

const httpdir = require('httpdir')
const server = httpdir.createServer({
  basePath: '/some/path', // Optional, default is "."
  httpPort: 9898,         // Optional, default is 8080
})

Main events can be listened to:

server.onStart((settings) => {
  console.log('Server started')
  console.log('Base path is:', settings.basePath)
  console.log('Port is:', settings.httpPort)
  console.log('Available URLs:', settings.urls.join(', '))
})

server.onStop(() => {
  console.log('Server stopped')
})

server.onResponse((response) => {
  console.log('Requested path was:', response.requestedPath)
  console.log('Requested method was:', response.requestedMethod)
  console.log('Response code is:', response.httpCode)
})

server.onError((error) => {
  console.log('Server error', error)
})

After event listeners have been attached if needed, start the server:

server.start()

And stop:

server.stop()

Changelog

This project uses semver.

License

This project is released under the MIT License.