{ "info": { "author": "Miquido", "author_email": "contact@miquido.com", "bugtrack_url": null, "classifiers": [ "Intended Audience :: Developers", "License :: OSI Approved :: Apache Software License", "Operating System :: OS Independent", "Programming Language :: Python" ], "description": "Revolt SDK\n==========\n\nRevolt analytics sdk for Python 3.6+\n\nInstall\n-------\n\nRevolt is registered in pypi so just use pip.\n\n.. code-block:: bash\n\n pip install revolt-sdk\n\n\nUsage\n-----\n\nTo create Revolt client you have to provide:\n\n- tracking_id - Your unique client tracking ID\n\n- secret_key - Client authorization secret for your tracking ID\n\n- app_code - Your application name/identifier i.e. 'com.company.myapp'\n\n- app_version - Your application version i.e. '1.12.4'\n\n\nIf you don't have tracking_id or secret_key, please contact `Revolt Team `_ for assistance.\n\n\n.. code-block:: python\n\n import revoltsdk\n\n client = revoltsdk.Revolt(\n tracking_id='your_tracking_id',\n secret_key='your_secret_key',\n app_code='com.company.myapp',\n app_version='2.1.11',\n )\n\n\nYou may also pass any of additional options:\n\n- app_instance_id - Unique application instance ID. It will be randomly generated each time if None provided. It should be reused for same device/application instance.\n\n- timezone - Timezone used to send events. Default is current timezone provided by system.\n\n- revolt_host - Host name of Revolt server\n\n- batch_size - Maximum size of event batches sent to server. Events will be sent automatically when queue reaches batch*size. Default is 20.\n\n- auto_flush_delay - Delay in miliseconds before automatically sending events batch if batch_size was not reached. Calling ``send_event`` will reset the timer. Auto flush will be disabled if you pass None instead. If auto flush is disabled events will be flushed only if queue reaches batch_size or manually. Default is 5 seconds (5000).\n\n\nRevolt client has one public method called `send*event` used to send analytics events. Events will be queued and sent when flush occours. It might happen if queue size reaches batch_size, if you use auto flush and there was no new event for at least auto_flush_delay time or when explicitly call ``send_event`` with flush parameter set to True. \n\n.. code-block:: python\n\n client.send_event('some.empty') # sends event without additional data\n\n client.send_event(type='some.info', data={'info': 'works in python'}) # sends event with given data\n\n client.send_event(type='some.flushed', flush=True) # sends event immediately flushing all pending events\n\n\nEvent type name has to have no more than 32 characters. It should use dots for separating domain, object, event (example: ui.activity.started), last element of name should be a verb expressing what happened e.g. signedIn, started, deleted etc. Type of event determines format of event data.\n\nData associated with event might be any json serializable object (including arrays and nested objects) or None.\n\n\nDebug\n-----\n\nIf you wish to debug or examine what and when data is sent to Revolt you can enable debug logs. SDK uses default python logging system. It is required to run application in debug mode (without python optimization) to have access to logs. Logs are omitted in optimized run.\n\n\nLicense\n-------\n\nCopyright 2019 Miquido\n\nLicensed under the Apache License, Version 2.0 (the \"License\"); you may not use this file except in compliance with the License. You may obtain a copy of the License at\n\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://www.revolt.rocks/", "keywords": "analytics revolt", "license": "Apache 2.0", "maintainer": "", "maintainer_email": "", "name": "revolt-sdk", "package_url": "https://pypi.org/project/revolt-sdk/", "platform": "", "project_url": "https://pypi.org/project/revolt-sdk/", "project_urls": { "Homepage": "https://www.revolt.rocks/" }, "release_url": "https://pypi.org/project/revolt-sdk/1.0.1/", "requires_dist": null, "requires_python": ">=3.6", "summary": "Client SDK for Revolt analytics", "version": "1.0.1" }, "last_serial": 5118954, "releases": { "1.0.0": [ { "comment_text": "", "digests": { "md5": "8f2e6965eabdcf5dd02edee9334882c2", "sha256": "6de0bccd7f2ea0d3b71e4516570a3ba3629e52e2dd3a01e86fddfbc6e600a438" }, "downloads": -1, "filename": "revolt_sdk-1.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "8f2e6965eabdcf5dd02edee9334882c2", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6", "size": 10873, "upload_time": "2019-04-09T10:25:02", "url": "https://files.pythonhosted.org/packages/c4/96/2853f4487d08872f71330570a47261f30be618ea47505f17a2bd93ddf98f/revolt_sdk-1.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "b15140243c233538ae5cb4298af6e67b", "sha256": "74011e8f335f2e52e05b8815d23170385f8c245f0b19cec13da0282e8c3f1327" }, "downloads": -1, "filename": "revolt-sdk-1.0.0.tar.gz", "has_sig": false, "md5_digest": "b15140243c233538ae5cb4298af6e67b", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 5649, "upload_time": "2019-04-09T10:25:04", "url": "https://files.pythonhosted.org/packages/a7/45/e5452b1631830083d3873951c04d7b03730bb722b314e106048b325157c8/revolt-sdk-1.0.0.tar.gz" } ], "1.0.1": [ { "comment_text": "", "digests": { "md5": "2a4b679a60d5ed42a2916e29839e3503", "sha256": "68d8a95e774fa17abcb7b34b0d4ff20a6b5f372108388ee3c0e46d3dc0be4e4a" }, "downloads": -1, "filename": "revolt_sdk-1.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "2a4b679a60d5ed42a2916e29839e3503", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6", "size": 10911, "upload_time": "2019-04-09T14:09:39", "url": "https://files.pythonhosted.org/packages/44/78/da0d3ab23e5b1a5b2d338dcb3458fd09e62790b5ecb4e725fe2955b7c577/revolt_sdk-1.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "963531fae33e536df9583adfd6074f45", "sha256": "8eac441db08416cc8ea0718ac711459c08a5ce4a2b36c881f0f4618e3750edac" }, "downloads": -1, "filename": "revolt-sdk-1.0.1.tar.gz", "has_sig": false, "md5_digest": "963531fae33e536df9583adfd6074f45", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 5682, "upload_time": "2019-04-09T14:09:41", "url": "https://files.pythonhosted.org/packages/ae/fe/c830de16509f8b59e25c14bc161fe134325f025d3550b467ffd54a117145/revolt-sdk-1.0.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "2a4b679a60d5ed42a2916e29839e3503", "sha256": "68d8a95e774fa17abcb7b34b0d4ff20a6b5f372108388ee3c0e46d3dc0be4e4a" }, "downloads": -1, "filename": "revolt_sdk-1.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "2a4b679a60d5ed42a2916e29839e3503", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6", "size": 10911, "upload_time": "2019-04-09T14:09:39", "url": "https://files.pythonhosted.org/packages/44/78/da0d3ab23e5b1a5b2d338dcb3458fd09e62790b5ecb4e725fe2955b7c577/revolt_sdk-1.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "963531fae33e536df9583adfd6074f45", "sha256": "8eac441db08416cc8ea0718ac711459c08a5ce4a2b36c881f0f4618e3750edac" }, "downloads": -1, "filename": "revolt-sdk-1.0.1.tar.gz", "has_sig": false, "md5_digest": "963531fae33e536df9583adfd6074f45", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 5682, "upload_time": "2019-04-09T14:09:41", "url": "https://files.pythonhosted.org/packages/ae/fe/c830de16509f8b59e25c14bc161fe134325f025d3550b467ffd54a117145/revolt-sdk-1.0.1.tar.gz" } ] }