add header to readme

put README in repo

README test

doc

git-svn-id: http://chiral.j4cbo.com/svn/trunk@110 a827fe29-2235-0410-a7a9-cacdfe24a5d3

initial checkin of doc tools

git-svn-id: http://chiral.j4cbo.com/svn/trunk@109 a827fe29-2235-0410-a7a9-cacdfe24a5d3

test commit

git-svn-id: http://chiral.j4cbo.com/svn/trunk@108 a827fe29-2235-0410-a7a9-cacdfe24a5d3

test commit

git-svn-id: http://chiral.j4cbo.com/svn/trunk@107 a827fe29-2235-0410-a7a9-cacdfe24a5d3

test commit

git-svn-id: http://chiral.j4cbo.com/svn/trunk@106 a827fe29-2235-0410-a7a9-cacdfe24a5d3

fix incorrect wait_for_readable call in TCPConnection

git-svn-id: http://chiral.j4cbo.com/svn/trunk@105 a827fe29-2235-0410-a7a9-cacdfe24a5d3

More doc updates.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@104 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Documentation for chiral.web.framework
Fix docstring for chiral.os.sendfile

git-svn-id: http://chiral.j4cbo.com/svn/trunk@103 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Docs for chiral.web.servers

git-svn-id: http://chiral.j4cbo.com/svn/trunk@102 a827fe29-2235-0410-a7a9-cacdfe24a5d3

More documentation fixes.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@101 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- chiral.web.httpd documentation updates
- start refactoring HTTPServer to make the horrible connection_handler routine a little nicer

git-svn-id: http://chiral.j4cbo.com/svn/trunk@100 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Documentation updates.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@99 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Thread pool:
- More docs
- Improve the anti-reload mechanism

git-svn-id: http://chiral.j4cbo.com/svn/trunk@98 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Docstring fixes.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@97 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Combine the redundant as_coro and as_coro_waitcondition. They were identical, except for
docstring modification and the fact that as_coro set autostart=True where as_coro_waitcondition
didn't.

Change that such that as_coro does not autostart; remove as_coro_waitcondition, and replace all uses
of it with as_coro.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@96 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Documentation improvements to chiral.core.coroutine

git-svn-id: http://chiral.j4cbo.com/svn/trunk@95 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- netcore: WaitForEvent: if unbind() is called on WaitCondition for a socket that has somehow already been removed
from the epoll/kqueue set, an ENOENT will be returned. Ignore this, rather than causing breakage.
- coroutine: doc fixes
- coroutine: add context manager methods to automatically start() and kill() a coroutine.
- new net tests

git-svn-id: http://chiral.j4cbo.com/svn/trunk@94 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- More Reactor fixes
- Make TCPServers automatically close their listening socket upon kill
- Add a helper routine, "swallow_kill", that can be added as a completion callback
  to swallow CoroutineKilledExceptions.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@93 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Big reactor fixes.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@92 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Rearrange constants to be defined as such, rather than dict trickery; this makes pylint happier.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@91 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Finish refactor for epoll and kqueue reactors.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@90 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Add coroutine.kill() and CoroutineKilledException. Also incomplete (doesn't behave properly when you kill a running coro.)

git-svn-id: http://chiral.j4cbo.com/svn/trunk@89 a827fe29-2235-0410-a7a9-cacdfe24a5d3

First pass checkin of netcore WaitCondition refactor. INCOMPLETE AND POORLY TESTED - this doesn't include
epoll/kqueue reactor support yet and is probably broken in strange ways. It works enough to serve HTTP, though...

git-svn-id: http://chiral.j4cbo.com/svn/trunk@88 a827fe29-2235-0410-a7a9-cacdfe24a5d3

chiral.net.tcp: change TCPConnection.connection_handler() to raise NotImplementedError within a generator
function. As a result, one may create and manipulate a bare TCPConnection as long as it is never actually
start()ed.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@87 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Fix the test suite for chiral.core.coroutine

git-svn-id: http://chiral.j4cbo.com/svn/trunk@86 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Check-in extra files from melkor:
- sendfile module
- cometlib.js
- more test apps

git-svn-id: http://chiral.j4cbo.com/svn/trunk@85 a827fe29-2235-0410-a7a9-cacdfe24a5d3

i are python coder

(re-fix epoll/kqueue-without-libc handling)

git-svn-id: http://chiral.j4cbo.com/svn/trunk@84 a827fe29-2235-0410-a7a9-cacdfe24a5d3

win32 fixes

git-svn-id: http://chiral.j4cbo.com/svn/trunk@83 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- Add templates directory
- test.py fixes: rename /tp to /asyncpagetest, add -prof flag to enable/disable profiler

git-svn-id: http://chiral.j4cbo.com/svn/trunk@82 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Coroutine fix

git-svn-id: http://chiral.j4cbo.com/svn/trunk@81 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- Change Reactor.schedule() to do what the docstring says it will when delay and callbacktime are both None (i.e. run during next event loop)
- Clarify coroutine module docstring

git-svn-id: http://chiral.j4cbo.com/svn/trunk@80 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- Documentation: remove old references to Tasklet; it's Coroutine now.
- Lint fixes to threadpool, coroutine
- Remove chiral.core.coroutine.dump(); the new introspection framework makes it redundant.
- Remove "force" option from Coroutine.start(), as it was confusing and never used.
  start() now always throws an assertion if the coroutine is already running.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@79 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- Introspection refactor
- Threadpool is now reloadable and introspectable

git-svn-id: http://chiral.j4cbo.com/svn/trunk@78 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- chiral.messaging.irc: use connect() on the new socket properly
- chiral.net.tcp: fix connect() to properly return the WaitForCallback and set the new socket nonblocking properly

git-svn-id: http://chiral.j4cbo.com/svn/trunk@77 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Use uint32/uint64 types (more semantically correct)

git-svn-id: http://chiral.j4cbo.com/svn/trunk@76 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- Convert EpollLooper to use new epoll binding
- Remove py-epoll C module

git-svn-id: http://chiral.j4cbo.com/svn/trunk@75 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Add ctypes-based epoll binding

git-svn-id: http://chiral.j4cbo.com/svn/trunk@74 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Add kqueue wrapper and KqueueReactor

git-svn-id: http://chiral.j4cbo.com/svn/trunk@73 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- Shell rewrite
- chiral.core.coroutine: get rid of __slots__; add dump() method again
- chiral.net.tcp: improve ConnectionClosedException handling

git-svn-id: http://chiral.j4cbo.com/svn/trunk@72 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Initial checkin of IRC COMET demo. Not fully working yet.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@71 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Change coroutines to /not/ start by default.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@70 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Remove some debugging from Introspector

git-svn-id: http://chiral.j4cbo.com/svn/trunk@69 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Fix EpollReactor

git-svn-id: http://chiral.j4cbo.com/svn/trunk@68 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Remove some GC cycles in coroutine handling. Failed HTTP connections should now be picked up by the reference counter, rather than having to wait for mark-and-sweep garbage collection.

:iia:

git-svn-id: http://chiral.j4cbo.com/svn/trunk@67 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Use new schedule in comet.py, to go with changes in [65]

git-svn-id: http://chiral.j4cbo.com/svn/trunk@66 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Remove application tracking from Reactor classes
Fix shabang in test.py
Framework fixes

git-svn-id: http://chiral.j4cbo.com/svn/trunk@65 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- Add CoroutineRestart exception
- Make autostart mandatory, pending change to default False

git-svn-id: http://chiral.j4cbo.com/svn/trunk@64 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Shell: use new TCPConnection exception system

git-svn-id: http://chiral.j4cbo.com/svn/trunk@63 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Make Coroutine a WaitCondition. This helps simplify things for API integration.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@62 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- Rearrange TCPConnection to create its own socket for connections to remote boxes
- Add asynchronous connect()
- Make memcached properly reconnect to down servers

git-svn-id: http://chiral.j4cbo.com/svn/trunk@61 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Threadpool: works now. Still need to manage auto-growing and shrinking of the pool; limited to 1 worker thread at the moment.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@60 a827fe29-2235-0410-a7a9-cacdfe24a5d3

First pass at thread pool. Untested.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@59 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Memcached improvements. Comes close to working now; does NOT yet handle server disconnections prperly.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@58 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- Get rid of "Done." message when Reactor terminates
- Coroutine: as_coro_waitcondition coroutines should be started with autostart=False.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@57 a827fe29-2235-0410-a7a9-cacdfe24a5d3

First pass at memcached. Still very, very broken.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@56 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Add coroutine mutex class

git-svn-id: http://chiral.j4cbo.com/svn/trunk@55 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Proper handling of WSGI write()

git-svn-id: http://chiral.j4cbo.com/svn/trunk@54 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Remove the yield-value-directly option, to be more compliant with coroutine standard.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@53 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Doc improvements to coroutine.py

git-svn-id: http://chiral.j4cbo.com/svn/trunk@52 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Add GPL header.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@51 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- dbus: get rid of the SyntaxError
- xreaload: prefix unused unpack variables with _, to prevent pylint from complaining
- coroutine: docstring fixes

git-svn-id: http://chiral.j4cbo.com/svn/trunk@50 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Fixes to tests, coroutine, pylint validation

git-svn-id: http://chiral.j4cbo.com/svn/trunk@49 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Very incomplete version of DBus interface.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@48 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- Fix app handling in SelectReactor
- Handle Exceptions in a coroutine_page properly

git-svn-id: http://chiral.j4cbo.com/svn/trunk@47 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Move from Tasklet to new Coroutine library. Similar in concept, all-new implementation, cleaner.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@46 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Shell improvements

git-svn-id: http://chiral.j4cbo.com/svn/trunk@45 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Change to \r\n default for tcp.read_line()

git-svn-id: http://chiral.j4cbo.com/svn/trunk@44 a827fe29-2235-0410-a7a9-cacdfe24a5d3

First pass at messaging framework

git-svn-id: http://chiral.j4cbo.com/svn/trunk@43 a827fe29-2235-0410-a7a9-cacdfe24a5d3

HTTP: handle no-data tasklet pages correctly

git-svn-id: http://chiral.j4cbo.com/svn/trunk@42 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- Rename TCPConnection.handler() to connection_handler()
- Get rid of handle_*_close, as they were unused and broken
- Generalize TCPConnection to work with locally-initiated connections as well as TCPServer
  - Rename client_sock to remote_sock
- Better METHOD_JS: as an html doc with <script> tags, not bare js
- lint fixes

git-svn-id: http://chiral.j4cbo.com/svn/trunk@41 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Move chiral.inet to chiral.net

git-svn-id: http://chiral.j4cbo.com/svn/trunk@40 a827fe29-2235-0410-a7a9-cacdfe24a5d3

pylint fixes

git-svn-id: http://chiral.j4cbo.com/svn/trunk@39 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- Use the decorator module for signature-preserving decorators
- New 'tasklet.returns_waitcondition' decorator which replaces non-WaitConditions with WaitForNot
hing in debug mode
- Add __all__ to inet.tcp, core.tasklet, core.stats
- Unit test fixes
- Fix content-type of CometClock

git-svn-id: http://chiral.j4cbo.com/svn/trunk@38 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- Lint improvements
- Doc improvements
- Add "parameters" kwarg to Tasklet.__init__; alows some arbitrary data (generally a tuple) to be stored in the Tasklet object
- Change completion callbacks to a list, so it's ordered
- Result may be modified by a completion callback
- Beginnings of a web framework

git-svn-id: http://chiral.j4cbo.com/svn/trunk@37 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Move introspector and wsgihttpd out of http; get rid of the old http.httpd.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@36 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Tasklets may now return any object. If it is not a WaitCondition, it will be treated as a WaitForNothing used to be.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@35 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Optimizations:
- Use __slots__ again
- Don't call __init__ on the base WaitCondition class, as it doesn't help
- In sendfile(), only create the blocked_operation_handler closure if it will be used

git-svn-id: http://chiral.j4cbo.com/svn/trunk@34 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Add sendfile() optimization for static file serving

git-svn-id: http://chiral.j4cbo.com/svn/trunk@33 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- Netcore now tracks the application associated with each callback
- Add new writeall() function to TCPConnection; use it properly in wsgihttpd
- Introspector lists all applications
- Fix occasional "dictionary changed size during iteration" in introspector
- Tasklet: WaitForCallback can have a description, which shows up in repr
- Include StaticFileServer in test.py

git-svn-id: http://chiral.j4cbo.com/svn/trunk@32 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- New static file server
- Doc improvemnets to tasklet
- WSGI HTTPd compliance fixes, etc.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@31 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Beginnings of the comet framework; change demo to serve up an HTML page with MXMR.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@30 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Move the whole "for data in result" loop in wsgihttpd inside the try/except block.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@29 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- Add a new option to Tasklet class, "autostart" If a tasklet is created with autostart=False, it will not start running immediately, but be in the TASKLET_UNSTARTED state.
- Add a new start() method to Tasklet, to cause the tasklet to start executing. Has an option force, default True. The tasklet must be in the UNSTARTED state; otherwise, start() will do nothing (force=False) or raise an AssertionError (force=True / default).
- wsgihttpd calls tasklet.start() after the request headers have been sent, on tasklets passed to set_tasklet.
- wsgihttpd: don't call close() until after the child tasklet has completed.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@28 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Use Paste's URL mapper for dispatching. Accordingly, introspector now sits at logical root.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@27 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- Rename "Looper" to "Reactor"
- Reactor is now a singleton, chiral.inet.reactor

git-svn-id: http://chiral.j4cbo.com/svn/trunk@26 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- Introspector: s/inspector/introspector
- Netcore: round milliseconds to int before passing to epoll
- COMET: change to use CSS position:absoltute overlays rather than JS

git-svn-id: http://chiral.j4cbo.com/svn/trunk@25 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- TCP shell-like thing
- Some unit tests for tasklets

git-svn-id: http://chiral.j4cbo.com/svn/trunk@24 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- TCP: move read_line_tasklet out into its own method, rather than being an inner function
- Make TCPServer.connections a WeakValueDictionary, just like tasklet._TASKLETS
- Introspector application: allow chaining to other apps
- wsgihttpd: waiting_tasklet fixes
- tasklet: let's try making it reloadable. Getting rid of __slots__ temporarily.
- Add some COMET code
- overhauls to test.py

git-svn-id: http://chiral.j4cbo.com/svn/trunk@23 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- httpd: properly quote errors
- Add HTTP Introspector

git-svn-id: http://chiral.j4cbo.com/svn/trunk@22 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- Tasklet: get rid of __slots__; add master tasklet list; use self.__class__.__name__ in repr()
- TCP: Connection and Server are both subclasses of Tasklet now; makes tasklet lists more informative

git-svn-id: http://chiral.j4cbo.com/svn/trunk@21 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- Get rid of psyco; it causes breakage
- Add xreload module
- WSGI HTTPd improvements to error handling

git-svn-id: http://chiral.j4cbo.com/svn/trunk@20 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- Make netcore and tasklet modules use Psyco if available
- Remove tasklet dump (weakrefs aren't compatible with psyco)
- Change HTTPServer to not subclass Tasklet

git-svn-id: http://chiral.j4cbo.com/svn/trunk@19 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Add WSGI-compliant HTTP server.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@18 a827fe29-2235-0410-a7a9-cacdfe24a5d3

write_out() doesn't need to be its own tasklet.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@17 a827fe29-2235-0410-a7a9-cacdfe24a5d3

- TCP: fixes to real_line, read_exactly; cleanup; set nonblocking on client sockets as well as master
- Tasklet: passing an object that evaluated as False into a tasklet would previously call next(),
  rather than send(value), causing "" to be replaced with None. Fix to only use next() if the incoming
  value is None.

git-svn-id: http://chiral.j4cbo.com/svn/trunk@16 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Move isinstance test for Message in with the rest of the checks, to reduce call count

git-svn-id: http://chiral.j4cbo.com/svn/trunk@15 a827fe29-2235-0410-a7a9-cacdfe24a5d3

Tasklet: optimize to reduce unnecessary calls to isinstance()

git-svn-id: http://chiral.j4cbo.com/svn/trunk@14 a827fe29-2235-0410-a7a9-cacdfe24a5d3