{ "info": { "author": "Mark Vartanyan", "author_email": "kolypto@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Developers", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python :: 2", "Programming Language :: Python :: 3" ], "description": "[![Build Status](https://api.travis-ci.org/kolypto/py-smsframework-amazon-sns.png?branch=master)](https://travis-ci.org/kolypto/py-smsframework-amazon-sns)\n[![Pythons](https://img.shields.io/badge/python-2.7%20%7C%203.4%E2%80%933.7%20%7C%20pypy-blue.svg)](.travis.yml)\n\nSMSframework Amazon SNS Provider\n================================\n\n[Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-mobile-phone-number-as-subscriber.html) Provider for [smsframework](https://pypi.python.org/pypi/smsframework/).\n\nIn the Amazon Console, you can specify \n\nGetting started:\n\n1. Create an AWS account, if you don't have one: .\n You will have 100 messages you can send for free. You'll need to give them your debit card, but it's free.\n2. Sign in to the AWS Management Console: , \n choose (or search for) \"SNS\" in the menu at the top.\n3. Click \"get started\"\n4. Choose your region (top right, small drop-down).\n\n Note: some regions do not support SMS messages; choose one that does. \n You'll know it when you see \"Text messaging (SMS)\" in the left menu. \n\n Copy the region identifier from the URL: `home?region=eu-west-1#/home` -> `eu-west-1`.\n You will use it with this library\n5. In the left menu, choose \"Text messaging (SMS)\", go to \"Text messaging preferences\", and set it up. \n\n Here, you can specify whether you want low-cost messaging (\"promotional\"), or reliable delivery (\"transactional\").\n These preferences take effect for every SMS message that you send from your account, \n but you can override some of them when you send an individual message.\n\n Also, specify your default SenderID.\n\n6. Click at your login at the top, choose \"My Security credentials\".\n Choose \"Access keys\", click on the \"Create new access key\" button.\n These are the credentials you're going to use with this library: \n `Access Key ID` and `Secret Access Key`.\n\n\n\n\nInstallation\n============\n\nInstall from pypi:\n\n $ pip install smsframework_amazon_sns\n\nTo receive SMS messages, you need to ensure that\n[Flask microframework](http://flask.pocoo.org) is also installed:\n\n\n $ pip install smsframework_amazon_sns[receiver]\n\n\n\n\n\n\nInitialization\n==============\n\n```python\nfrom smsframework import Gateway\nfrom smsframework_amazon_sns import AmazonSNSProvider\n\ngateway = Gateway()\ngateway.add_provider('amazon', AmazonSNSProvider,\n access_key='AAABBB111222CCCDDDEE',\n secret_access_key='fOAPpu78gZ6/HSJKCHqFj0xOJIFDt9mKQjkR+XTt',\n region_name='eu-west-1',\n)\n```\n\nConfig\n------\n\nSource: /smsframework_amazon_sns/provider.py\n\n* `access_key: str`: AWS access key id\n* `secret_access_key: str`: AWS secret access key\n* `region_name: str`: AWS region name\n\n\nExample\n=======\n\n```python\nfrom smsframework import OutgoingMessage\n\n# Send a regular, low-cost message (when the default message type is \"promotional\")\ngateway.send(OutgoingMessage('+19998887766', 'Test'))\n\n# escalate=True sends a 'transactional' message: Amazon will use reliable delivery\ngateway.send(OutgoingMessage('+19998887766', 'Test').options(senderId='kolypto', escalate=True))\n```\n\n\n\nSupported Options\n=================\n\n* `.options(senderId='kolypto')`: Sets an alpha-numeric SenderID\n* `.options(escalate=True)`: Amazon will optimize the delivery to achieve the highest reliability.\n\n\n\n\nProvider-Specific Parameters\n============================\n\nProvider-specific sending params:\n\n* `MaxPrice: float`: The maximum amount in USD that you are willing to spend to send the SMS message.\n\n\nExample:\n\n```python\nfrom smsframework import OutgoingMessage\n\ngateway.send(OutgoingMessage('+123', 'hi').params(MaxPrice=0.15))\n```\n\n\nLimitations\n===========\n\nIncoming messages are currently not supported.\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/kolypto/py-smsframework-amazon-sns", "keywords": "sms,message,notification,receive,send,amazon,sns", "license": "BSD", "maintainer": "", "maintainer_email": "", "name": "smsframework-amazon-sns", "package_url": "https://pypi.org/project/smsframework-amazon-sns/", "platform": "any", "project_url": "https://pypi.org/project/smsframework-amazon-sns/", "project_urls": { "Homepage": "https://github.com/kolypto/py-smsframework-amazon-sns" }, "release_url": "https://pypi.org/project/smsframework-amazon-sns/0.0.2/", "requires_dist": [ "smsframework (>=0.0.9)", "boto3 (>=1.4)", "flask (>=0.10) ; extra == 'receiver'" ], "requires_python": "", "summary": "SMS framework: Amazon SNS provider", "version": "0.0.2" }, "last_serial": 4711628, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "cadc16e22608af3b34901bc1a3b0cf77", "sha256": "fb50bd6b347f61b62ffd2eac444f6a638c61958728d31126b0b99c2501f1af4d" }, "downloads": -1, "filename": "smsframework_amazon_sns-0.0.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "cadc16e22608af3b34901bc1a3b0cf77", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 5692, "upload_time": "2019-01-17T11:53:14", "url": "https://files.pythonhosted.org/packages/62/a4/553e3ac80052324f4fa9565148de0d4e30f9e2d75270195cbdab122d065b/smsframework_amazon_sns-0.0.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "2589ab3d7ba81ef093b20f03ea690f7e", "sha256": "db90947f99b91c2fd3e570b5cc0d100e2178e3d6f1b99cae0d04ce74e669f169" }, "downloads": -1, "filename": "smsframework-amazon-sns-0.0.1.tar.gz", "has_sig": false, "md5_digest": "2589ab3d7ba81ef093b20f03ea690f7e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5682, "upload_time": "2019-01-17T11:53:16", "url": "https://files.pythonhosted.org/packages/b3/e9/410f35e6c733e4685f654c0c28f004e9622a183206d9601e31b1916955d4/smsframework-amazon-sns-0.0.1.tar.gz" } ], "0.0.2": [ { "comment_text": "", "digests": { "md5": "e6edcad36fefa1265d03cef90b6a2a5b", "sha256": "7ccbe666782621cc19478934dd71a75881957768eca478de4d6158e41603a05a" }, "downloads": -1, "filename": "smsframework_amazon_sns-0.0.2-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "e6edcad36fefa1265d03cef90b6a2a5b", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 5701, "upload_time": "2019-01-18T10:05:36", "url": "https://files.pythonhosted.org/packages/f6/84/8e2ab17930e7e9daa3aefbad576c2b7051b17257b88c43b5b5d9c3e4f39e/smsframework_amazon_sns-0.0.2-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ffec026c44c6ae9eb299e5ff612fe08b", "sha256": "823f08621324a2ab9fbb0485593e1f0f16fbfb3b1cfec474d4e4f8e6f5785acc" }, "downloads": -1, "filename": "smsframework-amazon-sns-0.0.2.tar.gz", "has_sig": false, "md5_digest": "ffec026c44c6ae9eb299e5ff612fe08b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5681, "upload_time": "2019-01-18T10:05:38", "url": "https://files.pythonhosted.org/packages/92/2e/d257e4ecaaff801c9ff7db775674b711c7a5277c080a078255cb2d0b16db/smsframework-amazon-sns-0.0.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "e6edcad36fefa1265d03cef90b6a2a5b", "sha256": "7ccbe666782621cc19478934dd71a75881957768eca478de4d6158e41603a05a" }, "downloads": -1, "filename": "smsframework_amazon_sns-0.0.2-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "e6edcad36fefa1265d03cef90b6a2a5b", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 5701, "upload_time": "2019-01-18T10:05:36", "url": "https://files.pythonhosted.org/packages/f6/84/8e2ab17930e7e9daa3aefbad576c2b7051b17257b88c43b5b5d9c3e4f39e/smsframework_amazon_sns-0.0.2-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ffec026c44c6ae9eb299e5ff612fe08b", "sha256": "823f08621324a2ab9fbb0485593e1f0f16fbfb3b1cfec474d4e4f8e6f5785acc" }, "downloads": -1, "filename": "smsframework-amazon-sns-0.0.2.tar.gz", "has_sig": false, "md5_digest": "ffec026c44c6ae9eb299e5ff612fe08b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5681, "upload_time": "2019-01-18T10:05:38", "url": "https://files.pythonhosted.org/packages/92/2e/d257e4ecaaff801c9ff7db775674b711c7a5277c080a078255cb2d0b16db/smsframework-amazon-sns-0.0.2.tar.gz" } ] }