https://github.com/jeff1evesque/interview-usnews

Simple interview exercise
https://github.com/jeff1evesque/interview-usnews

Last synced: 3 days ago
JSON representation

Simple interview exercise

• Host: GitHub
• URL: https://github.com/jeff1evesque/interview-usnews
• Owner: jeff1evesque
• Created: 2015-03-30T21:14:53.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2015-03-31T15:22:06.000Z (almost 10 years ago)
• Last Synced: 2024-11-08T06:06:15.739Z (about 2 months ago)
• Language: Python
• Homepage:
• Size: 355 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
interview-usnews

================

A coding [exercise](https://github.com/jeff1evesque/interview-usnews/blob/master/data/coding_assessment_instructions.txt) was given to me, when I interviewed for a Software Developer position at the [US News & World Report](http://www.usnews.com/).  The exercise was restricted to 2 hours, and to be submitted within 5 business days.  Since this exercise was rather primitive, and the position premised on the python language, no arbitrary css, or javascipt was coded.

**Note:** the exercise [instructions](https://github.com/jeff1evesque/interview-usnews/blob/master/data/coding_assessment_instructions.txt) can be found in the [`data/`](https://github.com/jeff1evesque/interview-usnews/tree/master/data/) subdirectory.

## Installation

###Linux Packages

The following packages are needed to be installed:

```

# General Packages:

sudo apt-get install python-pip

sudo pip install Flask

sudo pip install requests

```

**Note:** This project assumes [Ubuntu Server 14.04](http://www.ubuntu.com/download/server) as the operating system. If another system is preferred, simply download the above requirements, with respect to the systems *package manager* equivalent.

## Configuration

###GIT

Fork this project in your GitHub account, then clone your repository:

```

cd /var/www/

sudo git clone https://[YOUR-USERNAME]@github.com/[YOUR-USERNAME]/interview-usnews.git

```

Then, change the *file permissions* for the entire project by issuing the command:

```

cd /var/www/interview-usnews/

sudo chown -R jeffrey:sudo interview-usnews

```

**Note:** change 'jeffrey' to the user account YOU use.

Then, add the *Remote Upstream*, this way we can pull any merged pull-requests:

```

cd /var/www/interview-usnews/

git remote add upstream https://github.com/[YOUR-USERNAME]/interview-usnews.git

```

###Flask

Python's [Flask](http://flask.pocoo.org/), is a microframework based on [Werkzeug](http://werkzeug.pocoo.org/).  Specifically, it is a [web framework](http://en.wikipedia.org/wiki/Web_application_framework), which includes, a development server, integrated support for [unit testing](http://en.wikipedia.org/wiki/Unit_testing), [RESTful](http://en.wikipedia.org/wiki/Representational_state_transfer) API, and [Jinja2](http://jinja.pocoo.org/) templating.

This project implements flask, by requiring [`app.py`](https://github.com/jeff1evesque/interview-usnews/blob/master/app.py) to be running:

```

cd /var/www/html/interview-us-news/

python app.py

```

**Note:** the [`run()`](http://flask.pocoo.org/docs/0.10/api/#flask.Flask.run) method within `app.py`, runs the local developement server, and has the ability of defining the host, port, debug feature, and several other options. If none of these attributes are passed into the method, the server will default to running `localhost` on port `5000`, with no [`debug`](http://flask.pocoo.org/docs/0.10/quickstart/#debug-mode) features enabled.

**Note:** when running the above `app.py`, ensure that the terminal window is not used for any other processes, while the web application is available to others.

##Execution

Once `app.py` is running on a dedicated terminal window, this application can be accessed via any web-browser:

```

http://localhost:5000/

```