Skip to content

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

License

Notifications You must be signed in to change notification settings

TheY3TI/UrlShortener

 
 

Repository files navigation

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

About

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

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 88.2%
  • HTML 11.8%