The supported API version is 1.3.0

This python api enables easy interaction with the Etherpad API. Etherpad is a collaborative editor provided by the Etherpad Foundation. https://etherpad.org

pip install pyetherpadlite

If you are using a self hosted Etherpad server, you will need to specify an API Key after installation before using the API. (See https://github.com/ether/etherpad-lite for installation details).

Your secret api key should be placed in the base installation (etherpad-client folder) in a text file named APIKEY.txt. Many linux text editors automatically create an extra newline character at the end of the file, so I recommend simply executing the following command to set your api key without a newline character:

echo -n "myapikey" > APIKEY.txt

Once you have created the APIKEY.txt file, you will need to edit the py_etherpad.py wrapper to set your API key. Edit the 'apiKey' variable and set it to the same key as defined in your APIKEY.txt file.

from py_etherpad import EtherpadLiteClient
myPad = EtherpadLiteClient('EtherpadFTW','https://beta.etherpad.org/api')
# Change the text of the etherpad
myPad.setText('testPad','New text from the python wrapper!')

See the src/py_etherpad/__init__.py file for further details on the methods and parameters available for the API. Nearly all calls from the official API work as in the official documentation described.

Already finished:

• Groups
• Pad

Nearly finished:

• Author
• Pad Content

Missing:

• Session
• Chat
• Pads
• Global

Apache License

This python API-Wrapper is a Fork from devjones and is inspired by TomNomNom's php client