Merge branch 'master' into Version_String

INSTALL.txt

@@ -3,36 +3,47 @@ Installation Instructions for OpenSlides 1.3
 
 Content
 -------
-I.  Installation on GNU/Linux and MacOSX
-II. Installation on Windows (32/64bit)
+
+I.  Installation on GNU/Linux and MacOSX using the Python Package Index (PyPI)
+II. Installation on GNU/Linux and MacOSX using the sources
+III. Installation on Windows (32/64bit)
 
 If you need help ask on OpenSlides users mailing list.
 See http://openslides.org for more information.
 
 
-I. Installation on GNU/Linux and MacOSX
-----------------------------------------
+I. Installation on GNU/Linux and MacOSX using the Python Package Index (PyPI)
+-----------------------------------------------------------------------------
+
+  1. Check requirements:
 
         Make sure that you have installed Python (>= 2.5) on your system.
 
-You can setup a virtualenv environment to install OpenSlides as non-root user.
-Run before you start install OpenSlides:
+  2. Set up virtual environment with virtualenv (optional):
+
+        You can setup a virtual environment to install OpenSlides as
+        non-root user.
+
+        E. g. for ubuntu run:
+        $ sudo apt-get install python-virtualenv
+
+        To setup and activate the virtual environment, create your
+        OpenSlides directory, change to it and run:
 
         $ virtualenv .venv
         $ source .venv/bin/activate
 
-
-  1. Install OpenSlides:
+  3. Install OpenSlides:
 
         $ pip install openslides
 
-        OpenSlides will installed the following required python packages:
+        OpenSlides will install the following required python packages:
           + Django
           + django-mptt
           + ReportLab Toolkit
           + Python Imaging Library (PIL)
 
-  2. Start OpenSlides server and open URL in your default browser:
+  4. Start OpenSlides server and open URL in your default browser:
 
         $ openslides
 
@@ -46,8 +57,80 @@ Run before you start install OpenSlides:
         Use 'openslides --help' to show all start options.
 
 
-II. Installation on Windows (32/64bit)
---------------------------------------
+II. Installation on GNU/Linux and MacOSX using the sources
+----------------------------------------------------------
+
+  1. Install requirements:
+
+        OpenSlides requires following programs, which should be
+        installed first:
+          + Python Programming Language 2 (>= 2.5)
+          + virtualenv (>= 1.4.1)
+          + ReportLab Toolkit
+          + Python Imaging Library (PIL)
+
+        E. g. for ubuntu run:
+        $ sudo apt-get install python python-virtualenv python-reportlab python-imaging
+
+  2. Get OpenSlides:
+
+     a) Download latest OpenSlides release from http://openslides.org.
+
+     OR
+
+     b) Clone development version from OpenSlides' github repository
+        https://github.com/OpenSlides/OpenSlides. This requires Git,
+        see http://git-scm.com/.
+
+        E. g. for ubuntu run:
+        $ sudo apt-get install git
+        $ git clone git://github.com/OpenSlides/OpenSlides.git OpenSlides
+
+  3. Setup your virtual environment with virtualenv:
+
+        Go to the (extracted/cloned) root directory of OpenSlides
+        and create virtualenv environment:
+
+        $ virtualenv .venv
+
+        For virtualenv >= 1.7 use instead:
+        $ virtualenv --system-site-packages .venv
+
+  4. Activate the virtual environment:
+
+        $ source .venv/bin/activate
+
+  5. Install the required python-packages:
+
+        $ pip install django django-mptt
+
+        If you use python < 2.6 you also have to install simplejson:
+        $ pip install simplejson
+
+        If requirements reportlab or PIL still missing (see 1.):
+        $ pip install reportlab pil
+
+  6. Start OpenSlides server and open URL in your default browser:
+
+        $ python start.py
+
+        If you run this script the first time a new database and the
+        admin account are created. Please change the password after
+        first login!
+
+        Username: admin
+        Password: admin
+
+        Use 'python start.py --help' to show all start options.
+
+  7. Restart OpenSlides:
+
+        To restart OpenSlides after closing the terminal activate the
+        virtual environment (see 4.) before starting the server (see 6.).
+
+
+III. Installation on Windows (32/64bit)
+---------------------------------------
 
 NOTE: There is a portable version of OpenSlides for Windows which does not 
 required any install steps! If there is a reason that you can not use the 
@@ -65,7 +148,6 @@ portable version you should run the following install steps.
           + Django
           + django-mptt
 
-
      a) Download and run 32bit MSI installer from http://www.python.org/:
 
         http://python.org/ftp/python/2.7.3/python-2.7.3.msi
@@ -98,8 +180,9 @@ portable version you should run the following install steps.
      OR
 
      b) Clone development version from OpenSlides' github repository
-        https://github.com/OpenSlides/OpenSlides.
-        This requires Git, see http://git-scm.com/.
+        https://github.com/OpenSlides/OpenSlides. This requires Git,
+        see http://git-scm.com/.
+
         Open command line (cmd) and run:
 
         git clone git://github.com/OpenSlides/OpenSlides.git
@@ -116,4 +199,3 @@ portable version you should run the following install steps.
         Password: admin
 
         Use 'python start.py --help' to show all start options.
-

openslides/main.py

@@ -27,6 +27,8 @@ import webbrowser
 import django.conf
 from django.core.management import execute_from_command_line
 
+from openslides import get_version
+
 CONFIG_TEMPLATE = """#!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
@@ -78,21 +80,27 @@ def process_options(argv=None):
 
     parser = optparse.OptionParser(
         description="Run openslides using django's builtin webserver")
-    parser.add_option("-a", "--address", help="IP Address to listen on")
-    parser.add_option("-p", "--port", type="int", help="Port to listen on")
+    parser.add_option("-a", "--address", help="IP Address to listen on.")
+    parser.add_option("-p", "--port", type="int", help="Port to listen on.")
     parser.add_option(
         "--syncdb", action="store_true",
-        help="Update/create database before starting the server")
+        help="Update/create database before starting the server.")
     parser.add_option(
         "--reset-admin", action="store_true",
-        help="Make sure the user 'admin' exists and uses 'admin' as password")
+        help="Make sure the user 'admin' exists and uses 'admin' as password.")
     parser.add_option(
         "-s", "--settings", help="Path to the openslides configuration.")
     parser.add_option(
         "--no-reload", action="store_true",
-        help="Do not reload the development server")
+        help="Do not reload the development server.")
+    parser.add_option(
+        "--version", action="store_true",
+        help="Show version and exit.")
 
     opts, args = parser.parse_args(argv)
+    if opts.version:
+        print get_version()
+        exit(0)
     if args:
         sys.stderr.write("This command does not take arguments!\n\n")
         parser.print_help()

setup.py

@@ -7,6 +7,9 @@
     :license: GNU GPL, see LICENSE for more details.
 """
 
+# for python 2.5 support
+from __future__ import with_statement
+
 from setuptools import setup
 from setuptools import find_packages
 from openslides import get_version