[py-svn] r39974 - in py/trunk/py/net: . pipe

[fijal at codespeak.net]

Author: fijal
Date: Tue Mar  6 10:40:59 2007
New Revision: 39974

Modified:
   py/trunk/py/net/greenexecnet.py
   py/trunk/py/net/greensock2.py
   py/trunk/py/net/pipe/__init__.py
Log:
Add some comments


Modified: py/trunk/py/net/greenexecnet.py
==============================================================================
--- py/trunk/py/net/greenexecnet.py	(original)
+++ py/trunk/py/net/greenexecnet.py	Tue Mar  6 10:40:59 2007
@@ -1,3 +1,17 @@
+
+""" This is an implementation of an execnet protocol on top
+of a transport layer provided by the greensock2 interface.
+
+It has the same semantics, but does not use threads at all
+(which makes it suitable for specific enviroments, like pypy-c).
+
+There are some features lacking, most notable:
+- callback support for channels
+- socket gateway
+- bootstrapping (there is assumption of pylib being available
+  on remote side, which is not always true)
+"""
+
 import sys, os, py, inspect
 from py.__.net import greensock2
 from py.__.net.msgstruct import message, decodemessage

Modified: py/trunk/py/net/greensock2.py
==============================================================================
--- py/trunk/py/net/greensock2.py	(original)
+++ py/trunk/py/net/greensock2.py	Tue Mar  6 10:40:59 2007
@@ -1,3 +1,10 @@
+
+""" This is a base implementation of thread-like network programming
+on top of greenlets. From API available here it's quite unlikely
+that you would like to use anything except wait(). Higher level interface
+is available in pipe directory
+"""
+
 import os, sys
 try:
     from stackless import greenlet

Modified: py/trunk/py/net/pipe/__init__.py
==============================================================================
--- py/trunk/py/net/pipe/__init__.py	(original)
+++ py/trunk/py/net/pipe/__init__.py	Tue Mar  6 10:40:59 2007
@@ -0,0 +1,8 @@
+
+""" This is a higher level network interface based on top
+of greensock2. Objects here are ready to use, specific examples
+are listed in tests (test_pipelayer and test_greensock2).
+
+The limitation is that you're not supposed to use threads + blocking
+I/O at all.
+"""