Permalink
Browse files

Squashed commit of the following:

Getting things running on modern OS X, and some githubification.

commit 48e8065
Author: Ben Matasar <ben@matasar.org>
Date:   Fri Aug 12 22:23:19 2011 -0700

    More cleanup of readme.

commit 4684d83
Author: Ben Matasar <ben@matasar.org>
Date:   Fri Aug 12 22:21:24 2011 -0700

    Missed header.

commit f65950e
Author: Ben Matasar <ben@matasar.org>
Date:   Fri Aug 12 22:20:55 2011 -0700

    Correct lies.

commit b7ed6a5
Author: Ben Matasar <ben@matasar.org>
Date:   Fri Aug 12 22:20:04 2011 -0700

    Revert "More markdownification."

    This reverts commit e9943bd.

commit e9943bd
Author: Ben Matasar <ben@matasar.org>
Date:   Fri Aug 12 22:18:41 2011 -0700

    More markdownification.

commit f5a8944
Author: Ben Matasar <ben@matasar.org>
Date:   Fri Aug 12 22:17:41 2011 -0700

    Markdownify.

commit 5ba1bc7
Author: Ben Matasar <ben@matasar.org>
Date:   Fri Aug 12 22:15:20 2011 -0700

    README.md

commit 5aec09b
Author: Ben Matasar <ben@matasar.org>
Date:   Fri Aug 12 22:09:35 2011 -0700

    Got this working on Lion without having to manually involke python2.4.

commit c773c55
Author: Ben Matasar <ben@matasar.org>
Date:   Wed Aug 10 19:20:28 2011 -0700

    Add tags to gitignore.
  • Loading branch information...
1 parent 794786f commit ce4b5892f63eaf49b7ef07d3f8024ec12c5fedd8 @matasar matasar committed Aug 13, 2011
Showing with 41 additions and 57 deletions.
  1. +2 −0 .gitignore
  2. +31 −49 README.txt → README.md
  3. +1 −1 bin/backupdb
  4. +1 −1 bin/convertDbFromLegacy.py
  5. +1 −1 bin/env
  6. +2 −2 bin/start
  7. +1 −1 bin/stop
  8. +1 −1 src/data.py
  9. +1 −1 src/server.py
View
2 .gitignore
@@ -0,0 +1,2 @@
+tags
+*.pyc
View
80 README.txt → README.md
@@ -1,11 +1,6 @@
+# Nuffle Blood Bowl Web Manager
-Nuffle Blood Bowl Web Manager
-
-$Date: 2006/06/03 23:26:56 $
-$Revision: 1.4 $
-
-
-Summary
+## Summary
The Nuffle Blood Bowl Web Manager is a web based system for tracking
teams or running a league for the Blood Bowl game created by Games
@@ -17,14 +12,12 @@ Bowl web manager you launch the web server, and then any number of
people can connect to the Blood Bowl manager using a standard web
browser. It's just like accessing any other website on the Internet.
+## What You Need
-What You Need
-
-Python 2.4: The web manager is implemented in Python. You want
-version 2.4. Earlier versions most definitely will not work without
-some amount of hackery, as function decorators (see PEP 318) were
-used in the implementation. Python versions beyond 2.4 might work,
-but they don't exist yet, so I can't be sure.
+Python >=2.4: The web manager is implemented in Python. You want
+at least version 2.4. Earlier versions most definitely will not work
+without some amount of hackery, as function decorators (see PEP 318)
+were used in the implementation.
MySQL and MySQLdb --OR-- Postgres and psycopg
@@ -39,42 +32,40 @@ database. Most installations of Python or your database will install
this for you, so you likely don't need to install this yourself.
-Installation (Linux, Mac OSX, *nix)
+## Installation (Linux, Mac OSX, *nix)
+1: Download the Nuffle Blood Bowl Web Manager from here:
-Step 1: Download the Nuffle Blood Bowl Web Manager from here:
+ http://sourceforge.net/project/showfiles.php?group_id=53815
-http://sourceforge.net/project/showfiles.php?group_id=53815
+2: Extract the downloaded file:
-Step 2: Extract the downloaded file:
+ tar xzf nuffle*.tar.gz
-tar xzf nuffle*.tar.gz
-
-Step 3: Create a database for Nuffle. If you're using MySQL, you
+3: Create a database for Nuffle. If you're using MySQL, you
want to do something like this:
-shell> mysql -u root -p mysql
-mysql> create user nuffle identified by 'nuffle';
+ shell> mysql -u root -p mysql
+ mysql> create user nuffle identified by 'nuffle';
-shell> mysql -u nuffle -p
-mysql> create database nuffle;
+ shell> mysql -u nuffle -p
+ mysql> create database nuffle;
--OR--
-createuser nuffle
-
-createdb -U nuffle nuffle
+ createuser nuffle
+ createdb -U nuffle nuffle
-Step 4: Create your configuration files. Sample configuration files
+4: Create your configuration files. Sample configuration files
are provided for you and are located in the root directory for
Nuffle. Nuffle expects your configuration files to be located in
the root directory for nuffle, so start by copying the samples:
-cp nuffle.cfg.sample nuffle.cfg
-cp cherrypy.cfg.sample cherrypy.cfg
+ cp nuffle.cfg.sample nuffle.cfg
+ cp cherrypy.cfg.sample cherrypy.cfg
Then, open both of these files and poke around. At the very least you'll
need to replace all references to the "/home/nuffle" directory and replace
@@ -84,41 +75,37 @@ database/account that you just created. If you're using Postgres and not
MySQL you'll definitely need to modify the db uri configuration variable.
-Step 5: Create the Nuffle schema in your Nuffle database. Assuming
+5: Create the Nuffle schema in your Nuffle database. Assuming
you've managed to configure yourself correctly, just do this:
-python2.4 ./src/data.py
+ python ./src/data.py
The Python "data" module when executed directly will recreate all
of the necessary tables in your database, and install a base set
of starting data (races, skills, etc).
Now create your database indexes:
-mysql -u nuffle -p nuffle < ./bin/createIndexes.sql
+ mysql -u nuffle -p nuffle < ./bin/createIndexes.sql
--OR--
-psql -U nuffle nuffle < ./bin/createIndexes.sql
-
+ psql -U nuffle nuffle < ./bin/createIndexes.sql
-Step 6: Launch the web manager:
-python2.4 ./src/server.py
+6: Launch the web manager:
+ python ./src/server.py
-Step 7: Open your favorite web browser and navigate to:
-http://localhost:8042/
+7: Open your favorite web browser and navigate to http://localhost:8042/
-
-Step 8: Whew, all done. You should be staring at the frontpage of
+8: Whew, all done. You should be staring at the frontpage of
your very own Nuffle installation. You'll want to login as user
"nuffle" password "nuffle". Then click on "[Admin]" to begin creating
coaches and teams.
-
-Installation (Windows)
+## Installation (Windows)
I don't personally own any Windows computers, so I haven't been able to
try installing the web manager on a Windows machine. There's nothing
@@ -127,18 +114,13 @@ attempt (and better yet, succeed) at installing on a Windows machine,
please drop me a note about any hiccups along the way. I'll update this
document with your experience.
-
Contact Information
Website: http://nuffle.sourceforge.net/
Email: nuffle-developers@lists.sourceforge.net
-
That's it! Good luck. May all your injuries be Badly Hurt. Don't
hesitate to send me/us an email if you run in to trouble.
Eric Bieschke
oberon7@users.sourceforge.net
-
-
-$Header: /cvsroot/nuffle/python/README.txt,v 1.4 2006/06/03 23:26:56 oberon7 Exp $
View
2 bin/backupdb
@@ -2,7 +2,7 @@
# Dump the Nuffle database into a backup directory.
cd `dirname ${0}` || exit 1
-eval `python2.4 ./env || echo exit 1`
+eval `python ./env || echo exit 1`
: ${NUFFLE_DB_HOST:?"You must set the environment variable NUFFLE_DB_HOST to use this command."}
: ${NUFFLE_DB_USER:?"You must set the environment variable NUFFLE_DB_USER to use this command."}
View
2 bin/convertDbFromLegacy.py
@@ -1,4 +1,4 @@
-#!/usr/bin/env python2.4
+#!/usr/bin/env python
__doc__ = '''Read data from a legacy schema, and insert data into the new schema.'''
import MySQLdb, sys
View
2 bin/env
@@ -1,4 +1,4 @@
-#!/bin/env python2.4
+#!/bin/env python
__doc__ = '''Print nuffle configuration options to stdout.'''
if __name__ == '__main__':
import ConfigParser, os
View
4 bin/start
@@ -2,7 +2,7 @@
# Start the Nuffle Blood Bowl Web Manager.
cd `dirname ${0}` || exit 1
-eval `python2.4 ./env || echo exit 1`
+eval `python ./env || echo exit 1`
: ${NUFFLE_DIR_ROOT:?"You must set the environment variable NUFFLE_DIR_ROOT to use this command."}
: ${NUFFLE_PIDFILE:?"You must set the environment variable NUFFLE_PIDFILE to use this command."}
@@ -16,7 +16,7 @@ if [ -f "${NUFFLE_PIDFILE}" ]; then
fi
fi
-PYTHON="`which python2.4`"
+PYTHON="`which python`"
if [ -z "${PYTHON}" ]; then
echo "Python not found"
exit 1
View
2 bin/stop
@@ -2,7 +2,7 @@
# Stop the Nuffle Blood Bowl Web Manager.
cd `dirname ${0}` || exit 1
-eval `python2.4 ./env || echo exit 1`
+eval `python ./env || echo exit 1`
: ${NUFFLE_PIDFILE:?"You must set the environment variable NUFFLE_PIDFILE to use this command."}
View
2 src/data.py
@@ -1,4 +1,4 @@
-#!/usr/bin/env python2.4
+#!/usr/bin/env python
__doc__ = '''Blood Bowl Web manager data model.'''
import ConfigParser
View
2 src/server.py
@@ -1,4 +1,4 @@
-#!/usr/bin/env python2.4
+#!/usr/bin/env python
__doc__ = '''Nuffle Blood Bowl Web Manager web server.'''
import ConfigParser

0 comments on commit ce4b589

Please sign in to comment.