Ticket #2332: tg2_pyamf.patch

main/TGandPyAMF.rst

@@ -8 +8 @@
 .. contents:: Table of Contents
     :depth: 2
 
-PyAMF provides a simple way to talk to Flex applications using the binary AMF protocol.   The main advantages of AMF are that it:
+PyAMF provides a simple way to talk to Flash Player applications using the binary AMF protocol.   The main advantages of AMF are that it:
 
  #. Provides native Flash ActionScript representations of your data, so instantiating it on the client side is almost instantaneous.  
  #. Is understood by the RemoteObject in Flex, so it is very easy to implement remote procedure calls from the Flex client.
 
-PyAMF provides serialization of a variety of native python types, from strings, lists, and dictionaries to datetime objects, elementtree elements, and custom classes.  And a lot of this is automatic, and very cool.  Return a dictionary from your pyamf service, and you'll get an ActionScript hash/object on the other side.
+PyAMF provides serialization of a variety of native Python types, from strings, lists, and dictionaries to datetime objects, elementtree elements, and custom classes.  And a lot of this is automatic, and very cool.  Return a dictionary from your PyAMF service, and you'll get an ActionScript hash/object on the other side.
 
-PyAMF provides a simple WSGI Application that can be used to setup RPC style service easily in Python.   And because TG2 supports WSGI from top-to-bottom, it's very simple to setup a TG2 app that contains web-services for your flex applications.  All you need to do is:
+PyAMF provides a simple WSGI Application that can be used to setup RPC style service easily in Python.   And because TG2 supports WSGI from top-to-bottom, it's very simple to setup a TG2 app that contains web-services for your Flex applications.  All you need to do is:
 
  #. Install a bunch of stuff and setup a TG2 app
  #. Create a PyAMF gateway for your services
@@ -27 +27 @@
 Installing Stuff:
 ----------------------
 
-If you haven't installed TG2, you'll need to do that first (http:docs.turbogears.org/2.0/RoughDocs/DownloadInstall).  You'll need TG2 version that's newer than February 20, 2007 for this to work.  All released versions of TG2 should work, but early SVN versions may need to be updated.  Once you've got an up-to-date version of TG2,  you'll need to install PyAMF, which you can do by::
+If you haven't installed TG2, you'll need to do that first (http:docs.turbogears.org/2.0/main/DownloadInstall).  You'll need TG2 version that's newer than February 20, 2007 for this to work.  All released versions of TG2 should work, but early SVN versions may need to be updated.  Once you've got an up-to-date version of TG2,  you'll need to install PyAMF, which you can do by::
 
   easy_install pyamf
 
@@ -48 +48 @@
 
  from pyamf.remoting.gateway.wsgi import WSGIGateway
  
- Class Services(object):
+ class Services(object):
  
-    def echo(data):
+    def echo(self, data):
         return "Turbogears gateway says:" + str(data)
   
-    def sum(a, b):
+    def sum(self, a, b):
         return a + b
 
-    def scramble(text):
+    def scramble(self, text):
         from random import shuffle
         s = [x for x in text]
         shuffle(s)
@@ -68 +68 @@
  GatewayController = WSGIGateway(services)
 
 This sets up a GatewayController WSGI app that has three services that 
-can be called from flex: echo, sum, and scramble, which each do exactly what 
+can be called from Flex: echo, sum, and scramble, which each do exactly what 
 they say they do. 
 
 Setup a controller that uses the GatewayController WSGI app:
@@ -88 +88 @@
 Of course, you'll need to import use_wsgi_app from tg, and your 
 GatewayController from wherever you put it. But once you've done those 
 things you'll have a AMF Gateway mounted at /gateway which you can use from 
-flex. 
+Flex. 
 
    
 Create a Flex Client
@@ -114 +114 @@
         <mx:Button click="remoteObj.scramble(c.text)" label="Scramble"/>
         <mx:TextInput id="c" text="She sells seashells by the seashore" width="100%"/>
     </mx:HBox>
-    <mx:Text id="result" width="100%" height="100%"/>
+    <mx:Text id="result" width="100%" height="100%" />
 
     <mx:Script>
     <![CDATA[
@@ -131 +131 @@
     }
 
     private function remoteFault(fault:FaultEvent): void {
-        result.text = ObjectUtil.toString(fault);
+        result.text = fault.fault.faultDetail;
     }
     ]]>
     </mx:Script>
     </mx:Application> 
 
-You can paste that into a new Flex Builder project (or use the free SDK to create a project with the text editor of your choice).  You can then put the HTML and SWF files generated by the builder into your TG2 project's static directory (wherever you want them to be available) at which point you should be able to browse there, get your Flex app, and use it to connect to the web services you just created. 
+You can paste that into a new Flex Builder project (or use the free SDK to create a project with the text editor of your choice).  You can then put the HTML and SWF files generated by Flex Builder into your TG2 project's static directory (wherever you want them to be available) at which point you should be able to browse there, get your Flex app, and use it to connect to the web services you just created.