1.5.0 • Published 7 years ago

debug-utility v1.5.0

Weekly downloads
-
License
ISC
Repository
-
Last release
7 years ago

url-shortener

URL Shortener by Melony Smith for Full Sail University: Deployment of Web Applications Online

Purpose

URL Shortener is a NodeJS based RESTful API that allows you to provide a long, cumbersome link to be returned as a convenient six digit URL. The shortened URL will redirect to the page provided by the original link. This is especially useful for sharing links on social media sites that limit the number of characters you are allowed to post.

Installation

Clone or download this repository using the green "Clone or download" button for this repository. The button can be found up and to the right.

Once cloned, install using:

npm install

Start Server

Start the server using:

node src/server.js

If you would like your server to watch for changes and run continuously you can use nodemon.

npm install nodemon

Start the server using:

nodemon src/server.js

Local Host

https://s29.postimg.org/r6ybuzc1j/localhost01.png

Endpoints

CRUD for URLs

MethodPathResult
POST/api/v1/urlsCreate a shortened URL
GET/api/v1/urlsDisplay all URLS
GET/api/v1/urls/:idDisplays URL based upon id
POST/api/v1/urls/:idUpdate URL based upon id
DELETE/api/v1/urls/:idDelete url based upon id

Routes

RouteResult
/go/:shortURLRedirect user to original URL based on the short URL

Working with the API

There are various ways to work with the API but I recommend using Postman.

https://s29.postimg.org/o1dq4rtfb/postman01.png

https://s29.postimg.org/yphh3m3ef/postman04.png

https://s29.postimg.org/5bqc1rq2f/postman05.png

dotenv

Installation:

npm install dotenv --save

Create and upload a .env (dotenv) file with the following information:

DB_NAME="your_db_name"
DB_USER="username"
DB_PASS="password"
DB_HOST="000.0.0.0"
DB_SCHEMA=mysql
DB_PORT=“0000”

Include and require .env:

require('dotenv').config()

Usage (Debugging)

Debugging = true (on; messages will appear within the console):

DEBUG=true node src/server.js

Debugging = false (off; messages will not appear within the console but will log to a file):

DEBUG=false node src/server.js

Coding Style Guide

This API follows the coding style guide set by Airbnb.

Unit Tests

You will first need to install mocha. In Terminal run the following command for unit testing:

mocha

Code Coverage

For code coverage, check out istanbul.