ts3
ts3
pypi i ts3
ts3

ts3

A Python 3 API for the TeamSpeak 3 server query and file transfer interface.

by Benedikt Schmitt

1.0.11 (see all)License:License
pypi i ts3
Readme

=======

The MIT License (MIT)

Copyright (c) 2013-2018

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Download-URL: https://github.com/benediktschmitt/Py-TS3/archive/master.zip Description: PyTS3 =====

    >> Check out `version 2 <https://github.com/benediktschmitt/py-ts3/tree/v2>`_,
    which also supports the TS3 Client Query API and SSH!**. v1 will only receive
    bug fixes, but no more updates. So better start using v2. <<
    
    This package provides a **Python 3 API** for:
    
    * TS3 query connections
    * TS3 query events
    * TS3 file transfers
    
    You can find a complete API documentation
    `here <http://py-ts3.readthedocs.org>`_.
    
    Installation
    ------------
    
    This package is registered on PyPi, so you're done with:
    
    .. code-block:: bash
    
        $ pip3 install ts3
    
    TS3 Server configuration
    ------------------------
    
    If you want to send lots of queries to the TS3 server, make sure, that you're
    connection is not closed by the **anti-flood protection** of the TS3 server.
    So it may be wise to add the host that runs the TS3 queries to the
    ``query_ip_whitelist.txt`` of your TS3 server:
    
    .. code-block:: bash
    
        $ echo "192.168.178.42" >> path/to/ts3/server/directory/query_ip_whitelist.txt
    
    Introduction
    ------------
    
    The easiest way to get to grips with this library is taking a look at the
    `examples <https://github.com/benediktschmitt/py-ts3/tree/master/ts3/examples>`_.
    
    If you need information about the possible query commands, take a look at the
    **TS3 Server Query Manual**.
    
    Examples
    ''''''''
    
    You can find more examples in the ``ts3.examples`` package.
    
    *   Show all clients on the virtual server with the server id 1:
    
        .. code-block:: python
    
            #!/usr/bin/python3
    
            import ts3
    
            with ts3.query.TS3Connection("localhost") as ts3conn:
                # Note, that the client will wait for the response and raise a
                # **TS3QueryError** if the error id of the response is not 0.
                try:
                    ts3conn.login(
                        client_login_name="serveradmin",
                        client_login_password="FoOBa9"
                    )
                except ts3.query.TS3QueryError as err:
                    print("Login failed:", err.resp.error["msg"])
                    exit(1)
    
                ts3conn.use(sid=1)
    
                # Each query method will return a **TS3QueryResponse** instance,
                # with the response.
                resp = ts3conn.clientlist()
                print("Clients on the server:", resp.parsed)
                print("Error:", resp.error["id"], resp.error["msg"])
    
                # Note, the TS3Response class and therefore the TS3QueryResponse
                # class too, can work as a rudimentary container. So, these two
                # commands are equal:
                for client in resp.parsed:
                    print(client)
                for client in resp:
                    print(client)
    
    *   Say hello to all clients:
    
        .. code-block:: python
    
            #!/usr/bin/python3
    
            import ts3
    
            with ts3.query.TS3Connection("localhost") as ts3conn:
                ts3conn.login(
                    client_login_name="serveradmin",
                    client_login_password="FoOBa9"
                )
                ts3conn.use(sid=1)
    
                for client in ts3conn.clientlist():
                    msg = "Hi {}".format(client["client_nickname"])
                    ts3conn.clientpoke(clid=client["clid"], msg=msg)
    
    *   Event handling:
    
        .. code-block:: python
    
            #!/usr/bin/python3
    
            import time
            import ts3
    
            with ts3.query.TS3Connection("localhost") as ts3conn:
                ts3conn.login(
                    client_login_name="serveradmin",
                    client_login_password="FoOBa9"
                )
                ts3conn.use(sid=1)
    
                # Register for events
                ts3conn.servernotifyregister(event="server")
    
                while True:
                    event = ts3conn.wait_for_event()
    
                    # Greet new clients.
                    if event[0]["reasonid"] == "0":
                        print("client connected")
                        ts3conn.clientpoke(clid=event[0]["clid"], msg="Hello :)")
    
    *   A simple TS3 viewer:
    
        .. code-block:: python
    
            #!/usr/bin/python3
    
            import ts3
    
            # The examples package already contains this implementation.
            # Note, that the ts3.examples.viewer module has an helpful class to
            # build a complete channel tree of a virtual server: ChannelTreeNode
            from ts3.examples.viewer import view
    
            with ts3.query.TS3Connection("localhost") as ts3conn:
                ts3conn.login(
                    client_login_name="serveradmin",
                    client_login_password="FoOBa9"
                )
                view(ts3conn, sid=1)
    
    *   Download and upload files:
    
        .. code-block:: python
    
            #!/usr/bin/python3
    
            import ts3
    
            with ts3.query.TS3Connection("localhost") as ts3conn:
                ts3conn.login(
                    client_login_name="serveradmin",
                    client_login_password="FoOBa9"
                )
    
                # Create a new TS3FileTransfer instance associated with the
                # TS3Connection.
                ts3ft = ts3.filetransfer.TS3FileTransfer(ts3conn)
    
                # Upload the image *baz.png* to the channel with the id 2 on the
                # TS3 server.
                # Note the opening mode ("rb").
                with open("baz.png", "rb") as file:
                    ts3ft.init_upload(input_file=file, name="/baz.png", cid=2)
    
                # Download the file into *baz1.png*.
                with open("baz1.png", "wb") as file:
                    ts3ft.init_download(output_file=file, name="/baz.png", cid=2)
    
    Bugs
    ----
    
    If you found a bug please report it or sent a pull request.
    
    Please report grammar or spelling errors too.
    
    Versioning
    ----------
    
    For the version numbers, take a look at http://semver.org/.
    
    License
    -------
    
    This package is licensed under the MIT License.
    
    The docstrings copied from the TS3 Server Query Manual are the property of the
    `TeamSpeak Systems GmbH <http://www.teamspeak.com/>`_.
    

Platform: UNKNOWN Classifier: License :: OSI Approved :: MIT License Classifier: Development Status :: 4 - Beta Classifier: Operating System :: OS Independent Classifier: Programming Language :: Python :: 3 Classifier: Topic :: Communications Classifier: Topic :: Internet Classifier: Topic :: Software Development :: Libraries

GitHub Stars

153

LAST COMMIT

4yrs ago

MAINTAINERS

1

CONTRIBUTORS

7

OPEN ISSUES

13

OPEN PRs

1
VersionTagPublished
2.0.0b3
3yrs ago
1.0.11
4yrs ago
2.0.0b2
4yrs ago
1.0.10
4yrs ago
No alternatives found
No tutorials found
Add a tutorial