r17156@catbus: nickm | 2007-12-14 16:18:29 -0500

 Add a launch module, and a README.


svn:r12816

README

 
-Empty readme file.  Write this.
+To set up:
+ - Install Python 2.4 or later.
+ - Install Twisted-Web, Twisted-Mail, PyOpenSSL, and all their dependencies.
+ - python setup.py --prefix=$HOME
+ - Edit bridgedb.conf; put it somewhere good.
+ - Make sure that the input files referred to in bridgedb.conf exist.
+ - Set up PYTHONPATH to include "~/lib/python2.4/site-packages/".
 
- - You'll need Python 2.4 or later.
+To run:
+ - Run "python -m TorBridgeDB bridgedb.conf"
 
+ - When you have new lists of bridges, replace the old files and send the
+   process a sighup.
+
+To use with HTTPS:
+ - Just connect to the appropriate port.
+
+To use with email:
+ - Any mail sent to the email port with a subject or a single line _exactly_
+   equal to "get bridges" will get answered, assuming the domain is okay.
+
+Support
  - Send your questions to nickm.
 

TODO

@@ -19,4 +19,6 @@ Later:
 - decent template for web interface
 - decent template for mail interface
 - implement 'help' command
-- Reload configuration on sighup; not just bridges.
\ No newline at end of file
+- Reload configuration on sighup; not just bridges.
+- Reply with locale support.
+- Check host option in http

lib/TorBridgeDB.py

+#!/usr/bin/python
+
+import bridgedb.Main
+bridgedb.Main.run()

lib/bridgedb/Main.py

@@ -173,7 +173,7 @@ def startup(cfg):
         if dblogfile is not None:
             dblogfile.close()
 
-if __name__ == '__main__':
+def run():
     if len(sys.argv) != 2:
         print "Syntax: %s [config file]" % sys.argv[0]
         sys.exit(1)
@@ -184,3 +184,6 @@ if __name__ == '__main__':
         execfile(sys.argv[1], configuration)
 
     startup(CONFIG)
+
+if __name__ == '__main__':
+    run()

setup.py

@@ -40,6 +40,7 @@ setup(name='BridgeDB',
       url='https://www.torproject.org',
       package_dir= {'' : 'lib'},
       packages=['bridgedb'],
+      py_modules=['TorBridgeDB'],
       cmdclass={'test' : runTests}
       )