ridhamtarpara / url_shortner

URL shortner with node, couchbase and redis

Node Url Shortener

URL shortener using Node.js and Redis.

Using

• Express 4
• Redis

Quick Start

$ git clone https://gitlab.com/ridhamtarpara/url_shortner.git
$ cd url_shortner
$ npm install
$ node app

v2

Updated project with the use of couchbase

• write readme

v1

Command Line Options

$ node app -h

Usage: app [options]

Options:
  -u, --url     Application URL               [default: "http://127.0.0.1:3000"]
  -p, --port    Port number for the Express application          [default: 3000]
  --redis-host  Redis Server hostname                     [default: "localhost"]
  --redis-port  Redis Server port number                         [default: 6379]
  --redis-pass  Redis Server password                           [default: false]
  --redis-db    Redis DB index                                      [default: 0]
  -h, --help    Show help                                              [boolean]

Installation on production

$ git clone https://gitlab.com/ridhamtarpara/url_shortner.git
$ cd nus
$ npm install --production
$ NODE_ENV=production node app --url "http://example.com"

if PM2 then use following command

$ NODE_ENV=production pm2 start app.js -- -u "http://example.io"

RESTful API

POST /api/v1/shorten with raw json data long_url=http://google.com

{
  "hash": "rnRu",
  "long_url": "http://google.com",
  "short_url": "http://127.0.0.1:3000/rnRu",
  "status_code": 200,
  "status_txt": "OK"
}

GET /api/v1/expand/:hash with query rnRu

{
  "clicks": "1",
  "hash": "rnRu",
  "long_url": "http://google.com",
  "status_code": 200,
  "status_txt": "OK"
}

Tests

To run the test suite, first install the dependencies, then run npm test:

$ npm install
$ npm test