Skip to content

Latest commit

 

History

History
98 lines (56 loc) · 3.46 KB

README.md

File metadata and controls

98 lines (56 loc) · 3.46 KB

Development

Please have python3 installed to run this project on terminal: Python3 Installation

Project Title

A URL Shortener is a tool that creates a short, unique URL that will redirect to the specific website of your choosing

Prerequisites

Modules used in this app are Flask and PyShortener.

Steps:

Start MySQL and Apache server on Xampp.

Initialize Database schema by going to MySQL Server admin page by passing the queries in initialize.sql

Install the Virtual Environment module

pip install virtualenv

Create a virtual environment

virtualenv venv

Activate the Virtual Environment

venv\scripts\activate.bat

Install the required modules

pip install -r requirements.txt

How to run the project

Steps:

Run the app

flask run

How to contribute

Check out our Contributing Documentation

Note

  1. First create issue for the task which you would like to contribute to by explaining your approach in it.
  2. Project maintatiners will assign the issue to you if it's worthy and not repeated.
  3. While creating pull request mention the issue number in it.

Guidelines

The first step is to register yourself on the Hacktoberfest website using your Github account and sign up as a student.

Find the open source repositories which interest and go try to pick up issues which you can solve.If you don't find one and think you can improve the codebase create a issue stating the problem you want to solve using the proper guidelines. Once the issue is assigned to you, code away till you resolve the issue 🤓 . Once you are done with the coding create a pull request by following the proper CONTRIBUTING.md file given in the repository. If the repository doesn't have one, make a pull request following the accepted rules in the open source community 🤗

You have to make 4 pull requests on any valid repositories. Once you make the pull request, there is a review period of two weeks. PLEASE MAKE QUALITY PULL REQUESTS AND NOT SPAM 😡 If you make spam pull requests your pull request will be deemed invalid/spam and you will be unelligible to win swag

Prizes

Make 4 valid Pull requests in the month of October to be elligible for a limited edition T-shirt or plant a tree 😇. The first 50,000 winners are elligible for the prizes.

If this repository helped you in anyway, please leave a star ⭐ on our repository 😊

Screenshots of the project

Login/Register:

A user can create an account by registering and later use the credentials to login to use our tool. Login/register credentials are stored in the MySQL database.

Login Page

Register Page

Url Shortener tool:

A user can shorten their(Long) Urls using our shortener tool by entering the url and assigning a nickname to it So that later when he checks the history they’ll get to know which link corresponds to which website.

Url Shortener

Url Result

History:

All the URLs shortened by a user are stored in the MySQL database which are later displayed in the history section.

History

Profile:

This page shows the user details and the user has an option to update his profile.

Profile