[X2Go-Commits] python-x2go.git - twofactorauth (branch) updated:

X2Go dev team git-admin at x2go.org
Sat Sep 14 15:57:33 CEST 2013

The branch, twofactorauth has been updated
       via  e62710c866e0a6fde03337608ff7a4de5e633767 (commit)
      from  64280dccd8219d8d52713f319ad3a11543944ee3 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------

Summary of changes:
 debian/changelog |    4 ++--
 x2go/__init__.py |   50 +++++++++++++++++++++++++++++++++++---------------
 2 files changed, 37 insertions(+), 17 deletions(-)

The diff of changes is:
diff --git a/debian/changelog b/debian/changelog
index 89fff6d..0e7650f 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,6 +1,6 @@
-python-x2go ( UNRELEASED; urgency=low
+python-x2go ( UNRELEASED; urgency=low
-  *New upstream version (
+  *New upstream version (
     - License change upstream: GPLv3+ -> AGPLv3+
     - Add support for session window title renaming.
     - Add support for bringing session windows on top.
diff --git a/x2go/__init__.py b/x2go/__init__.py
index 302ccd3..bc0a776 100644
--- a/x2go/__init__.py
+++ b/x2go/__init__.py
@@ -36,16 +36,16 @@ API Concept
     compatible with former versions of the same library. This is
     intended for Python X2Go, but with some restraints.
-    Python X2Go only offers 5 public API classes. With the release of
-    version, we will try to keep these 5 public API classes
+    Python X2Go only offers five public API classes. With the release of
+    version, we will try to keep these five public API classes
     of future releases as compatible as possible with versions of Python X2go
     greater/equal than v0.1.0.0.
-    The 4 public API classes are:
+    The five public API classes are:
         - L{X2goClient} --- a whole X2Go client API
         - L{X2goSession} --- management of an individual X2Go 
-        session started from an L{X2goClient} instance
+        session--either started standalone or from within an L{X2goClient} instance
         - L{X2goClientSettings} --- provide access to X2Go (global and 
         user) configuration node »settings«
         - L{X2goClientPrinting} --- provide access to X2Go (global and 
@@ -53,9 +53,14 @@ API Concept
         - L{X2goSessionProfiles} --- provide access to X2Go (global and 
         user) configuration node »sessions«
+    Plus two extra classes on MS Windows platforms:
+       - L{X2goClientXConfig} and L{X2goXServer} --- these classes will be initialized 
+       during L{X2goClient} instantiation on MS Windows platforms and start an installed XServer
     Any other of the Python X2Go classes may be subject to internal changes
     and the way of addressing these classes in code may vary between different
-    versions of Python X2Go. If you directly use other than the 5 public API 
+    versions of Python X2Go. If you directly use other than the five public API 
     classes in your own applications, so please be warned.
@@ -70,8 +75,14 @@ API Structure
+    Python X2Go is capable of handling multiple running/suspended sessions within the
+    same client instance, so for your application, there should not be any need of
+    instantiating more than one L{X2goClient} object in parallel. 
+    NOTE: Doing so is--herewith--fully disrecommended.
     The L{X2goClient} class flattens the complex structure of Python X2Go into
-    many L{X2goClient} methods that you can use in your own C{MyX2goClient} instances.
+    many L{X2goClient} methods that you can use in your own C{MyX2goClient} instance.
     However, it might be handy to retrieve a whole X2Go session instance 
     from the L{X2goClient} instance. This can be achieved by the 
@@ -97,13 +108,20 @@ API Structure
         # authenticate
         reg_session_instance.connect(password=pw, <further_options>)
-        # launch the session window
-        reg_session_instance.start()
-        # or resume the youngest session for 
+        # then launch the session window with either a new session
+        if start:
+            reg_session_instance.start()
+        # or resume a session
+        if resume:
+            reg_session_instance.resume(session_name=<X2Go-session-name>)
+        # leave it runnint for 60 seconds
-        reg_session_instance.suspend()
-        # or alternatively:
-        reg_session_instance.terminate()
+        # and then suspend
+        if suspend:
+            reg_session_instance.suspend()
+        # or alternatively terminate it
+        elif terminate:
+            reg_session_instance.terminate()
     How to access---especially how to modify---the X2Go client configuration
     files »settings«, »printing«, »sessions« and »xconfig« (Windows only)
@@ -111,6 +129,7 @@ API Structure
     Please refer to the class docs of L{X2goClientSettings}, L{X2goClientPrinting},
     L{X2goSessionProfiles} and L{X2goXServer}.
 Configuration and Session Management
@@ -136,7 +155,7 @@ Configuration and Session Management
       change your X2Go client's print setup during a running session
       - L{X2goClientSettings}: also the configuration node »settings« 
       is re-read whenever needed in the course of X2Go session management
-      - L{X2goXServer} (Windows only): this class will only be initialized 
+      - L{X2goClientXConfig} and L{X2goXServer} (Windows only): these classes will only be initialized 
       once (starting the XServer on Windows platforms) on construction
       of an L{X2goClient} instance
@@ -144,7 +163,7 @@ Dependencies
     Python X2Go takes advantage of the libevent/greenlet implementation 
     gevent (http://www.gevent.org). The least needed version of Python gevent
-    is 0.13.0 (or above).
+    is 0.13.0. On MS Windows Python gevent 1.0 is highly recommended.
     Python X2Go (because of gevent) requires at least Python 2.6. Further recent
     information on Python X2Go is available at: 
@@ -155,10 +174,11 @@ Contact
     If you have any questions concerning Python X2Go, please sign up for the
     x2go-dev list (https://lists.berlios.de/mailman/listinfo/x2go-dev) and post
     your questions, requests and feedbacks there.
 __NAME__    = 'python-x2go'
-__VERSION__ = ''
+__VERSION__ = ''
 from gevent import monkey

python-x2go.git (Python X2Go Client API)

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "python-x2go.git" (Python X2Go Client API).

More information about the x2go-commits mailing list