Py3AMF 0.8.12
AMF support for Python
License: MIT License
Keywords: python3 amf amf0 amf3 flex flash remoting rpc http flashplayer air bytearray

objectproxy arraycollection recordset actionscript decoder encoder gateway
remoteobject twisted pylons django sharedobject lso sol
Classifier: Framework :: Django
Classifier: Framework :: Pylons
Classifier: Framework :: Twisted
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: C
Classifier: Programming Language :: Python
Classifier: Programming Language :: Cython
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Development Status :: 5 - Production/Stable
Provides-Extra: twisted
Provides-Extra: django
Provides-Extra: sqlalchemy
Provides-Extra: elixir
Provides-Extra: lxml
Provides-Extra: six
License-File: LICENSE.txt

Py3AMF
======

Py3AMF is fork of `PyAMF <https://github.com/hydralabs/pyamf>`__ to
support Python3

Why Py3AMF
~~~~~~~~~~

By states of issues and PR in
`PyAMF <https://github.com/hydralabs/pyamf>`__, it dosen’t seems to be
under developing. And another PR that supports Py3 has been discontinued
for over two years. This is the only Python AMF Project which trying to
support Py3 under developing on GitHub.

State
~~~~~

Pass ``setup.py test`` But, adapters were not tested

Warning
~~~~~~~

This project isn’t completed. If you want to make it fast, please send
PR.

Install
~~~~~~~

This was tested on Ubuntu 16.04.2 and macOS 10.12.4

To install, you can use pip3 on your environment.

::

   pip3 install Py3AMF

Or, you can use setup.py to develop.

::

   git clone git@github.com:StdCarrot/Py3AMF.git
   cd Py3AMF
   # python3 setup.py test
   python3 setup.py install

Simple example
~~~~~~~~~~~~~~

Everything is same with PyAMF, but you have to concern str and bytes
types.

::

   import pyamf
   from pyamf import remoting
   from pyamf.flex import messaging
   import uuid
   import requests

   msg = messaging.RemotingMessage(operation='retrieveUser',
                                   destination='so.stdc.flexact.common.User',
                                   messageId=str(uuid.uuid4()).upper(),
                                   body=['user_id'])
   req = remoting.Request(target='UserService', body=[msg])
   ev = remoting.Envelope(pyamf.AMF3)
   ev['/0'] = req

   # Encode request
   bin_msg = remoting.encode(ev)

   # Send request; You can use other channels like RTMP
   resp = requests.post('http://example.com/amf',
                        data=bin_msg.getvalue(),
                        headers={'Content-Type': 'application/x-amf'})

   # Decode response
   resp_msg = remoting.decode(resp.content)
   print(resp_msg.bodies)

TODO
----

-  Check adapters

--------------

`PyAMF <http://www.pyamf.org>`__ provides Action Message Format
(`AMF <http://en.wikipedia.org/wiki/Action_Message_Format>`__) support
for `Python <http://python.org>`__ that is compatible with the `Adobe
Flash Player <http://en.wikipedia.org/wiki/Flash_Player>`__. It includes
integration with Python web frameworks like
`Django <http://djangoproject.com>`__, `Pylons <http://pylonshq.com>`__,
`Twisted <http://twistedmatrix.com>`__,
`SQLAlchemy <http://sqlalchemy.org>`__,
`web2py <http://www.web2py.com>`__ and
`more <http://pyamf.org/tutorials/index.html>`__.

The `Adobe Integrated
Runtime <http://en.wikipedia.org/wiki/Adobe_AIR>`__ and `Adobe Flash
Player <http://en.wikipedia.org/wiki/Flash_Player>`__ use AMF to
communicate between an application and a remote server. AMF encodes
remote procedure calls (RPC) into a compact binary representation that
can be transferred over HTTP/HTTPS or the
`RTMP/RTMPS <http://en.wikipedia.org/wiki/Real_Time_Messaging_Protocol>`__
protocol. Objects and data values are serialized into this binary
format, which increases performance, allowing applications to load data
up to 10 times faster than with text-based formats such as XML or SOAP.

AMF3, the default serialization for
`ActionScript <http://dev.pyamf.org/wiki/ActionScript>`__ 3.0, provides
various advantages over AMF0, which is used for ActionScript 1.0 and
2.0. AMF3 sends data over the network more efficiently than AMF0. AMF3
supports sending ``int`` and ``uint`` objects as integers and supports
data types that are available only in ActionScript 3.0, such as
`ByteArray <http://dev.pyamf.org/wiki/ByteArray>`__,
`ArrayCollection <http://dev.pyamf.org/wiki/ArrayCollection>`__,
`ObjectProxy <http://dev.pyamf.org/wiki/ObjectProxy>`__ and
`IExternalizable <http://dev.pyamf.org/wiki/IExternalizable>`__.