Add initial Vagrantfile

This is the beginning of putting together a Vagrant box for people who
would like to contribute to nycpython.com. The Vagrantfile (via
bootstrap.sh) installs all of the dependencies.

The README is being updated to reflect this change in setup. It's also
being changed from Markdown to reStructuredText. Why? Because Python.

Flask-SQLAlchemy is being removed as a dependency for the time being
because we aren't yet using a database. Once it's placed back,
SQLAlchemy, psycopg2, and PostgreSQL will need to be added as well, with
Postgres being handled by Vagrant.

Author: dirn

.gitignore

@@ -9,6 +9,9 @@
 # The test db
 dev.db
 
+# Vagrant
+.vagrant
+
 # Github's default python gitignore
 *.py[cod]
 

README.md

@@ -0,0 +1,100 @@
+nycpython.com
+=============
+
+The official website of the NYC Python meetup group.
+
+Technologies
+++++++++++++
+
+We will be using the following technologies
+
+- `Python 3`_
+- Flask_, a microframework
+- Jinja2_, a template engine
+
+.. _Flask: http://flask.pocoo.org/docs/
+.. _Jinja2: http://jinja.pocoo.org/docs/
+.. _Python 3: http://docs.python.org/3/
+
+Getting Started
++++++++++++++++
+
+Here's everything you need to know to get a copy of nycpython.com running
+locally.
+
+What You Need
+-------------
+
+- Git_
+- `A GitHub account`_
+- `The code`_
+- VirtualBox_
+- Vagrant_ (`docs <http://docs.vagrantup.com/v2/>`_)
+
+.. _Git: http://git-scm.com/downloads
+.. _A GitHub account: https://github.com
+.. _The code: https://github.com/NYCPython/nycpython.com
+.. _Vagrant: http://downloads.vagrantup.com/
+.. _VirtualBox: https://www.virtualbox.org/wiki/Downloads
+
+Setup
+-----
+
+After installing VirtualBox and Vagrant, `fork the code on GitHub`_ and clone it
+locally by executing the following command, replacing ``USERNAME`` with your
+GitHub username::
+
+    $ git clone [email protected]:USERNAME/nycpython.com.git
+
+After doing that, execute the following command to build your local virtual
+machine::
+
+    $ vagrant up
+
+You can access all of your code locally, but you will need the virtual machine
+to access the server. To access the virtual machine's command line interface,
+execute the following command::
+
+    $ vagrant ssh
+
+To run the nycpython.com server, execute the following commands on the virtual
+machine::
+
+    $ workon nycpythoncom
+    $ python src/server.py
+
+The site can be accessed in your browser by visiting `localhost:5050`_.
+
+.. _fork the code on GitHub: https://github.com/NYCPython/nycpython.com/fork
+.. _localhost:5050: http://localhost:5050
+
+Meetup API
+----------
+
+In order to work with the `Meetup API`_, you will first need to create a `Meetup
+API Key`_.
+
+.. _Meetup API: http://www.meetup.com/meetup_api/
+.. _Meetup API Key: http://www.meetup.com/meetup_api/key/
+
+Twitter API
+-----------
+
+In order to work with the `Twitter API`_, you will first need to create a
+`Twitter Application`_. Once you have created the application, you will be able
+to retrieve its OAuth settings.
+
+.. _Twitter API: https://dev.twitter.com/docs/api/1.1
+.. _Twitter Application: https://dev.twitter.com/apps/new
+
+Contributing
+++++++++++++
+
+A list of issues can be found on GitHub_. Issues are categorized as graphics
+(e.g., logos, banners), front-end (e.g., HTML, CSS, JavaScript), and back-end
+(e.g., Python, API Integration).
+
+Pick one and start hacking away!
+
+.. _GitHub: https://github.com/NYCPython/nycpython.com/issues
+

README.rst

@@ -0,0 +1,14 @@
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+# Vagrantfile API/syntax version. Don't touch unless you know what you're doing!
+VAGRANTFILE_API_VERSION = "2"
+
+Vagrant.configure(VAGRANTFILE_API_VERSION) do |config|
+  config.vm.box = "precise64"
+  config.vm.box_url = "http://files.vagrantup.com/precise64.box"
+
+  config.vm.provision :shell, :path => "bootstrap.sh"
+
+  config.vm.network :forwarded_port, host: 5050, guest: 5000
+end

Vagrantfile

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+
+apt-get update > /dev/null
+apt-get install -y python-software-properties
+add-apt-repository ppa:fkrull/deadsnakes
+apt-get update > /dev/null
+apt-get install -y emacs git-core nano python3.3-dev python-pip vim
+
+# Upgrade Pip before installing anything with it.
+sudo pip install -U pip
+sudo pip install -U virtualenvwrapper
+
+# Make virtualenvwrapper available to vagrant
+echo "source /usr/local/bin/virtualenvwrapper.sh" >> /home/vagrant/.bashrc
+
+# Set up a virtualenv. Make sure to use vagrant's home, otherwise it will be
+# created in /root.
+export WORKON_HOME=/home/vagrant/.virtualenvs
+mkdir $WORKON_HOME
+source /usr/local/bin/virtualenvwrapper.sh
+mkvirtualenv -p /usr/bin/python3.3 -a /vagrant nycpythoncom
+workon nycpythoncom
+
+# Install the requirements. Without the `--pre` flag Pip would see pytz's
+# releases as pre-release versions and fail.
+pip install --upgrade --pre --requirement /vagrant/requirements.txt

bootstrap.sh

@@ -1,10 +1,8 @@
 Flask==0.10.1
 git+git://github.com/jonafato/Flask-LazyViews.git
-Flask-SQLAlchemy==0.16
 Jinja2==2.7
 MarkupSafe==0.18
 Pygments==1.6
-SQLAlchemy==0.8.1
 Werkzeug==0.9.1
 itsdangerous==0.21
 requests==1.2.3