/UrlShortener

Shortens long urls. Select from a list of available hosts.

Primary LanguagePythonMIT LicenseMIT

UrlShortener

forthebadge
Build Status Open Source Love

A Django web app that shortens long urls. User may select from a list of available hosts.

Available Hosts

  • Tinyurl
  • Is.gd
  • Bit.ly
  • Google URL Shortener
  • Rebrand.ly

Pre-reqs

Virtualenv - Install required packages in a virtual enviroment. Not necessary, but recommended.

Installation

  1. virtualenv YOURENVNAME - Create new virtualenv for this project
  2. Navigate to directory containing 'requirements.txt'
  3. pip install -r requirements.txt - Install required packages

Usage

On first usage you'll need to apply database migrations: python manage.py migrate

Otherwise run development server using: python manage.py runserver

Testing

Tests are run using pytest

For more information: pytest

Contributions

Getting Started

  1. Create a fork and then clone your fork of the repo
  2. Follow steps for Installation
  3. Ensure project runs: Usage
  4. Ensure tests pass: Testing
  5. Implement your changes along with tests for your change
  6. Push changes to your fork and submit a pull request

Adding a new host

This project uses the pyshorteners library for url shortening, read their documentation for more information on implementing a new host: pyshorteners