Skip to content

Commit

Permalink
updates of releases and installation instruction
Browse files Browse the repository at this point in the history
  • Loading branch information
PradheepShrinivasan committed Jan 1, 2016
1 parent 8fcc8aa commit 3f1fb86
Showing 1 changed file with 39 additions and 1 deletion.
40 changes: 39 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,20 @@ I wanted to write a url shortener to improve my understanding of Flask and pymon

The code contains unit tests for all modules and also integration tests for all endpoints.

## Installation

1. To install the application clone the application using

```
git clone https://github.com/PradheepShrinivasan/picourl.git
```
2. Install the required python dependencies using

```
pip install requirements.txt
```
3. Install mongodb using the following commands as mentioned in [mongodb documentation](https://docs.mongodb.org/manual/installation/)


## Configuration
Picourl allows configuration of the following variables in `config.py`
Expand All @@ -18,13 +32,37 @@ Picourl allows configuration of the following variables in `config.py`
SITE_URL - the site prefix in url shortener (default is localhost)
```

## Starting application

To run the application go to the cloned folder and run it using

```
python run.py
```

if you have used the default configuration the system must be listening in port `5000` and you can access it by using
`http://localhost:5000`

The application screen should something like below

![image](https://raw.githubusercontent.com/PradheepShrinivasan/picourl/images/picourl.jpg)

And logged in page looks like below

![image](https://raw.githubusercontent.com/PradheepShrinivasan/picourl/images/picourl_logged_in.png)

one can look at the site hosted at heroku [http://picourl.herokuapp.com/](http://picourl.herokuapp.com/)
## Documentation
The discussion on design and configuration are available in blog post [1](http://pradheepshrinivasan.github.io/mongodb/python/flask/pymongo/2015/12/03/UrlShortener_in_python_Part_1/),[2](http://pradheepshrinivasan.github.io/mongodb/python/flask/pymongo/2015/12/06/UrlShortener_in_python_Part_2/),[3](http://pradheepshrinivasan.github.io/mongodb/python/flask/pymongo/2015/12/06/UrlShortener_in_python_Part_3/)
The discussion on design and configuration are available in blog post [1](http://pradheepshrinivasan.github.io/mongodb/python/flask/pymongo/2015/12/03/UrlShortener_in_python_Part_1/),[2](http://pradheepshrinivasan.github.io/mongodb/python/flask/pymongo/2015/12/06/UrlShortener_in_python_Part_2/),[3](http://pradheepshrinivasan.github.io/mongodb/python/flask/pymongo/2015/12/06/UrlShortener_in_python_Part_3/) [4](http://pradheepshrinivasan.github.io/mongodb/python/flask/pymongo/2015/12/17/UrlShortener_in_python_Part_4/)

## Releases

0.1 - Basic working code with storage to backend mongodb and redirect on using shortURL

0.2 - Added UI and form validation using csrf tokens.

0.3 - Added support to show the users clicked 7 urls.

## LICENCE

The software is provided in BSD licence, see LICENCE file for more details.
Expand Down

0 comments on commit 3f1fb86

Please sign in to comment.