{ "info": { "author": "Tuomas Suutari", "author_email": "tuomas.suutari@anders.fi", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.7", "Programming Language :: Python :: 3 :: Only", "Topic :: Communications :: Chat", "Typing :: Typed" ], "description": "PePuBot\n=======\n\nPePuBot is a Slack bot that can arrange Friday bottle lotteries on a\nSlack channel with a specific set of rules.\n\nThe Name\n--------\n\nPePu comes from Finnish words \"Perjantai Pullo\", which means \"Friday\nBottle\". Bot is shortened from Robot, as you may know. ;-)\n\nThe Rules\n---------\n\n* PePu is arranged in rounds, usually a round is arranged on every\n Friday, but it's also possible to arrange a round on any other day\n or to skip rounds.\n\n* When a PePu round is running in a channel anyone in the channel can\n attend and get a new ticket to the lottery box by posting a funny\n picture or video to the channel.\n\n* Each attendee may get at most one new ticket to the lottery box per a\n PePu round. If the same person posts several pictures or videos to\n the PePu channel, only the first one is awarded with a ticket.\n\n* When the round is ended, the winner will be selected by randomly\n picking one of the tickets from the lottery box. Then all tickets of\n the winner will be removed from the lottery box and the rest of the\n tickets will be stored for the next PePu round. I.e. your chances to\n win increase on every round until you win.\n\n* Anyone can arrange a PePu round, but the person who starts the round\n should also arrange the prize bottle.\n\n* The person who starts the round also decides when the round ends and\n is responsible to do so before the day ends.\n\nRequirements\n------------\n\nTo run PePuBot you need Python 3.7 and a Slack account.\n\nInstalling\n----------\n\n1. Add a new app to Slack in https://api.slack.com/apps and add a bot\n for that app.\n\n2. Enable the following permissions for the app:\n\n * bot\n\n - To act as a bot user in Slack\n\n * chat:write:bot\n\n - For writing to the channel\n\n * reactions:write\n\n - For marking ticket additions with reactions to the picture or\n video message.\n\n * users:read\n\n - For filling user names to the tickets\n\n3. Install PePuBot and its dependencies to a Python virtual environment\n or to a Docker container or using whatever isolation you prefer. You\n may do this with a command like::\n\n pip install .\n\n4. Copy the \"Bot User OAuth Access Token\" value to environment variable\n named ``SLACK_API_TOKEN`` or to a line in a configuration file named\n ``pepubot.conf``. There is a ``pepubot.conf.template`` which you can\n use as a base.\n\n - Note: Each configuration option can be set in the configuration\n file or with an environment variable with the same name. If a\n variable is defined in both places, the value will be read from the\n environment.\n\n5. Start the PePuBot with the script installed by Pip::\n\n pepubot\n\n By default the configuration file will be read from the current\n working directory by name ``pepubot.conf``, but alternative location\n can be given via command line argument::\n\n pepubot --config-file /path/to/pepubot.conf\n\n\n", "description_content_type": "text/x-rst", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/andersinno/pepubot/", "keywords": "pepu,bot,Friday,bottle,lottery,Slack", "license": "MIT", "maintainer": "Anders Innovations", "maintainer_email": "support@anders.fi", "name": "pepubot", "package_url": "https://pypi.org/project/pepubot/", "platform": "any", "project_url": "https://pypi.org/project/pepubot/", "project_urls": { "Homepage": "https://github.com/andersinno/pepubot/" }, "release_url": "https://pypi.org/project/pepubot/0.1.0/", "requires_dist": [ "aiofiles", "python-dateutil", "pytz", "slackclient[optional]" ], "requires_python": "", "summary": "Friday Bottle Lottery Bot for Slack", "version": "0.1.0" }, "last_serial": 5957363, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "8142ffe60117c2715f35b610490532f6", "sha256": "5d44cfb5df76a229694cc5f618ed3ff3488bff7aad9abf385fabbcfc9d9ba4cb" }, "downloads": -1, "filename": "pepubot-0.1.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "8142ffe60117c2715f35b610490532f6", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 14536, "upload_time": "2019-10-10T22:35:35", "url": "https://files.pythonhosted.org/packages/cc/7f/bd20bdf898abe477ecfd76247cb4706bdf23a752a9d25cd7ed51c6f85387/pepubot-0.1.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ea8bd862ceb9de73817bdde62e6308f7", "sha256": "f09fa41c0b17bffdf7e287fd1e0cd9317df2961dd2e6f55145952e60a2c4a61f" }, "downloads": -1, "filename": "pepubot-0.1.0.tar.gz", "has_sig": false, "md5_digest": "ea8bd862ceb9de73817bdde62e6308f7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13063, "upload_time": "2019-10-10T22:35:38", "url": "https://files.pythonhosted.org/packages/5a/f6/48549ce047e1c31697c400ea213079836e3067cd2024babdc75aef22ea84/pepubot-0.1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "8142ffe60117c2715f35b610490532f6", "sha256": "5d44cfb5df76a229694cc5f618ed3ff3488bff7aad9abf385fabbcfc9d9ba4cb" }, "downloads": -1, "filename": "pepubot-0.1.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "8142ffe60117c2715f35b610490532f6", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 14536, "upload_time": "2019-10-10T22:35:35", "url": "https://files.pythonhosted.org/packages/cc/7f/bd20bdf898abe477ecfd76247cb4706bdf23a752a9d25cd7ed51c6f85387/pepubot-0.1.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ea8bd862ceb9de73817bdde62e6308f7", "sha256": "f09fa41c0b17bffdf7e287fd1e0cd9317df2961dd2e6f55145952e60a2c4a61f" }, "downloads": -1, "filename": "pepubot-0.1.0.tar.gz", "has_sig": false, "md5_digest": "ea8bd862ceb9de73817bdde62e6308f7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13063, "upload_time": "2019-10-10T22:35:38", "url": "https://files.pythonhosted.org/packages/5a/f6/48549ce047e1c31697c400ea213079836e3067cd2024babdc75aef22ea84/pepubot-0.1.0.tar.gz" } ] }