CarlosGabaldon / hudsucker

Fork of araddon/hudsucker
Description:	Service proxy edit
Homepage:	http://code.google.com/p/hudsucker/ edit
Public Clone URL:	git://github.com/CarlosGabaldon/hudsucker.git Give this clone URL to anyone. `git clone git://github.com/CarlosGabaldon/hudsucker.git`
Your Clone URL:	git@github.com:CarlosGabaldon/hudsucker.git Use this clone URL yourself. `git clone git@github.com:CarlosGabaldon/hudsucker.git`

Fixed assert to compare against value in 
Settings.registry_config['source'] instead of hardcoded local host service 
http://localhost:4951.

Carlos Gabaldon (author)

Mon Jan 26 11:17:07 -0800 2009

commit e93d28bf739b8fbffe7fadec666524a4793f025c
tree d893d50591f5d40d4f00a40c5cf3c77b6f9e7bfe
parent ee890495713f29ef930a5acb0c2de5114e4dfa3e

hudsucker /

name	age	history message
README.rst	Thu Jan 01 12:38:16 -0800 2009	updating README doc to reflect new formatting o... [Aaron Raddon]
clients/	Sun Jan 04 21:59:49 -0800 2009	creating runner files to start twistd and load ... [Aaron Raddon]
docs/	Wed Dec 31 15:52:56 -0800 2008	moving docs/README to /README.rst to support gi... [Aaron Raddon]
server/	Mon Jan 26 11:17:07 -0800 2009	Fixed assert to compare against value in Settin... [Carlos Gabaldon]

README.rst

Hudsucker: A Content Proxy

A TCP server that proxies requests from a web application for remote HTML and services. The content proxy runs local to the web application and listens on port 4615.

Request Formatting

An incoming request must be a JSON string in the following format, and it _must_ terminate with "rn". Also note it passes a version attribute, allowing backwards compatibility to previous formats.:

'''{"app": "workshops", "service": "nearme", "params": {"request_path": "/nearme/123/08/2008/50/", "version":"v1.1"}}\r\n'''

'''{"app": "delicious.com",
                    "service": "rss_feed_for_test_only",
                    "params": {
                        "request_path": "/v2/rss/tag/python?count=5",
                        "format":"xml",
                        "base_url":  "http://feeds.delicious.com",
                        "url_patterns": ["/v2/rss"]
                    },
                    "version":"v1.1"
                }\r\n'''

Hudsucker also supports native services on Hudsucker.:

{"app": "hudsucker","service": "memcached", "params": {"key": "some_key", "value": "some_value", "expiry_minutes": "60"}, "version":"v1.1"}

{"app": "hudsucker","service": "diagnostics", "params": {"cmd": "ping", "servers": "myremotehost", "timeout_seconds": "5"}, "version":"v1.1"}

{"app": "hudsucker","service": "diagnostics", "params": {"cmd": "delete_log", "filename": "twistd.log.1"}, "version":"v1.1"}

{"app": "hudsucker","service": "diagnostics", "params": {"cmd": "stats"}, "version":"v1.1"}

Running Hudsucker:

To run Hudsucker as a background process

twistd -y ~/dev/hudsucker/hudsucker/remotecontent.py -l ~/dev/hudsucker/log.log -d ~/dev/hudsucker/hudsucker

To run Hudsucker as a foreground process and dump log info to console output

twistd -y ~/dev/hudsucker/hudsucker/remotecontent.py -n -d ~/dev/hudsucker/hudsucker

Dependencies:

Python 2.5 http://python.org/download/
setuptools 0.6c8 http://pypi.python.org/pypi/setuptools
Twisted 8.1.0 http://twistedmatrix.com/trac/wiki/Downloads
simplejson 1.9.2 http://pypi.python.org/packages/source/s/simplejson/
python-memcached 1.43 ftp://ftp.tummy.com/pub/python-memcached/python-memcached-1.4.3.tar.gz
httplib2 0.4.0 http://httplib2.googlecode.com/files/
PyYAML: easy_install pyyaml

For Windows Users: - pywin32-212 http://python.net/crew/mhammond/win32/Downloads.html