warp-proxy

warp-proxy

Proxy it. No wait, mock it!!!
Just delicious when testing and developing
Relies on node-http-proxy and node http api

Description

A simple command line to quickly start a web server which proxys your requests to an external server or to local files (JSON). Very helpful for testing and development.

Not made to be used in production. Use at your own risk.

Getting Started

Install warp-proxy using npm:

npm install warp-proxy # globally accessible

npm install warp-proxy --save-dev # only accessible via npm package.json commands

Usage

# Proxing all requests to a remote server
warp-proxy web --port 6543 --target http://mydesiredserver:1234 

# Proxing all request to local json files
warp-proxy mock --port 6543 --directory ./mymocksfolder/

# Using a config.js file
warp-proxy run --config ./proxy-config.js

# Using npx, you don't even need to install the package
npx warp-proxy start --port 6543 --target http://mydesiredserver:1234

Configuration

Using the run command you can pass a custom configuration via --config argument.

module.exports = {
  mode: 'web', // or 'mock'
  port: 1234,

  // Proxying external servers
  target: 'http://mydesiredserver:1234',

  // Proxying local files
  directory: './folder/with/mocks',
}

Proxying web target

Relies on all properties from node-http-proxy

Feel free to extend your config file with any property from node-http-proxy

module.exports = {
  port: 1234,
  target: 'http://mydesiredserver:1234',
  ...node_http_proxy_properties
}

Proxying local files

Mocking the following request and having the directory like --directory ./root/

[GET] http://address:1234/repositories/administrators/1234?param=value
└───────────────────────┘ └──────────┘ └────────────┘ └──────────────┘
   root folder + /GET/   |   FOLDER   |    FOLDER    |    JSON FILE

Your folder structure should look like this

└─root
  └─GET
    └─repositories
      └─administrators
        └─1234?param=value.json

in second example

[PUT] http://address:1234/language/countries/`
└───────────────────────┘ └──────┘ └───────┘
   root folder + /PUT/   | FOLDER |JSON FILE

your folder structure should look like this

└─root
  └─PUT
    └─language
      └─countries.json

License

MIT licensed