factorio-rcon-py


Namefactorio-rcon-py JSON
Version 2.1.3 PyPI version JSON
download
home_pageNone
SummaryA simple Factorio RCON client
upload_time2024-06-19 15:29:12
maintainerNone
docs_urlNone
authormark9064
requires_python>=3.8
licenseNone
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # factorio-rcon-py

A simple Factorio RCON client

## Install

Without async support
`pip install factorio-rcon-py`

With async support
`pip install factorio-rcon-py[async]`

Async support is available as soon as the required dependency (anyio) is installed, so `pip install factorio-rcon-py anyio` is mostly equivalent, but not recommended due to dependency versioning.

Python 3.8+ is required.

## Usage

Example:
```python
import factorio_rcon

client = factorio_rcon.RCONClient("127.0.0.1", 12345, "mypassword")
response = client.send_command("/help")
```

All documentation is in the docstrings of each class/method.

Asynchronous usage of this module is possible thanks to [anyio](https://github.com/agronholm/anyio). This means that you can use the async client with asyncio and trio. Use the AsyncRCONClient class. More details are in its docstring.

Available methods in both classes are (see docstrings for more info):
* connect - Connects to the RCON server.
* close - Closes the connection to the RCON server.
* send_packet - Sends a packet to the RCON server.
* receive_packet - Receives a packet from the RCON server.
* send_command - Sends a single command to the RCON server.
* send_commands - Sends multiple commands to the RCON server.

Note that both the sync/async clients can be used as sync/async context managers respectively.

The methods for sending/receiving packets are available in case you want to
write your own packet handlers, but in most cases you will never need to touch
these and can use send_command(s).

## Mentions

Thanks to:
- [Truman Kilen](https://github.com/trumank) for the initial code / idea.
- [De Sa Léo](https://github.com/desaleo) for contributing context manager support and typing improvements.

## License

LGPLv2.1

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "factorio-rcon-py",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": null,
    "author": "mark9064",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/23/24/ddb08445a3a00c4b106b81ee2b3b59061cd29ea8f4968ec33954adf1c46a/factorio_rcon_py-2.1.3.tar.gz",
    "platform": null,
    "description": "# factorio-rcon-py\n\nA simple Factorio RCON client\n\n## Install\n\nWithout async support\n`pip install factorio-rcon-py`\n\nWith async support\n`pip install factorio-rcon-py[async]`\n\nAsync support is available as soon as the required dependency (anyio) is installed, so `pip install factorio-rcon-py anyio` is mostly equivalent, but not recommended due to dependency versioning.\n\nPython 3.8+ is required.\n\n## Usage\n\nExample:\n```python\nimport factorio_rcon\n\nclient = factorio_rcon.RCONClient(\"127.0.0.1\", 12345, \"mypassword\")\nresponse = client.send_command(\"/help\")\n```\n\nAll documentation is in the docstrings of each class/method.\n\nAsynchronous usage of this module is possible thanks to [anyio](https://github.com/agronholm/anyio). This means that you can use the async client with asyncio and trio. Use the AsyncRCONClient class. More details are in its docstring.\n\nAvailable methods in both classes are (see docstrings for more info):\n* connect - Connects to the RCON server.\n* close - Closes the connection to the RCON server.\n* send_packet - Sends a packet to the RCON server.\n* receive_packet - Receives a packet from the RCON server.\n* send_command - Sends a single command to the RCON server.\n* send_commands - Sends multiple commands to the RCON server.\n\nNote that both the sync/async clients can be used as sync/async context managers respectively.\n\nThe methods for sending/receiving packets are available in case you want to\nwrite your own packet handlers, but in most cases you will never need to touch\nthese and can use send_command(s).\n\n## Mentions\n\nThanks to:\n- [Truman Kilen](https://github.com/trumank) for the initial code / idea.\n- [De Sa L\u00e9o](https://github.com/desaleo) for contributing context manager support and typing improvements.\n\n## License\n\nLGPLv2.1\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "A simple Factorio RCON client",
    "version": "2.1.3",
    "project_urls": {
        "homepage": "https://github.com/mark9064/factorio-rcon-py"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f5d6d100cca0fddea8241d44205e17c52b3b9b71ca4accf6db3fbe8262e27cc3",
                "md5": "98e7a2ab07e536929a2a6849267ff54d",
                "sha256": "ad2e73f5442cd1df235f435bf1079dd73eb62d1856d7526e4a0b6d4400b6cbb0"
            },
            "downloads": -1,
            "filename": "factorio_rcon_py-2.1.3-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "98e7a2ab07e536929a2a6849267ff54d",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 17323,
            "upload_time": "2024-06-19T15:29:10",
            "upload_time_iso_8601": "2024-06-19T15:29:10.277784Z",
            "url": "https://files.pythonhosted.org/packages/f5/d6/d100cca0fddea8241d44205e17c52b3b9b71ca4accf6db3fbe8262e27cc3/factorio_rcon_py-2.1.3-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "2324ddb08445a3a00c4b106b81ee2b3b59061cd29ea8f4968ec33954adf1c46a",
                "md5": "beadfc14b5c051c83a5d288cc029282c",
                "sha256": "84bfc42d2adfcd01660bd403652c6453f6be2b474817e214e75206f02b1512c3"
            },
            "downloads": -1,
            "filename": "factorio_rcon_py-2.1.3.tar.gz",
            "has_sig": false,
            "md5_digest": "beadfc14b5c051c83a5d288cc029282c",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 17425,
            "upload_time": "2024-06-19T15:29:12",
            "upload_time_iso_8601": "2024-06-19T15:29:12.590355Z",
            "url": "https://files.pythonhosted.org/packages/23/24/ddb08445a3a00c4b106b81ee2b3b59061cd29ea8f4968ec33954adf1c46a/factorio_rcon_py-2.1.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-06-19 15:29:12",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "mark9064",
    "github_project": "factorio-rcon-py",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "factorio-rcon-py"
}
        
Elapsed time: 0.66194s