{ "info": { "author": "Martin Kos\u00edr", "author_email": "martin@martinkosir.net", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Topic :: Communications :: Email" ], "description": "NeverBounce\n===========\n\nPython API wrapper library for the `NeverBounce`_ email\nverification service.\n\nInstallation\n------------\n\n.. code::\n\n $ pip install neverbounce\n\nThe only dependency is the `requests`_ library.\n\nUsage\n-----\n\n`Sign up`_ to get an `API username and key`_ and 1000 free monthly\nverifications. The **free account** supports only **single verifications**.\n\nSingle verification\n~~~~~~~~~~~~~~~~~~~\n\n.. code::\n\n >>> from neverbounce import NeverBounce\n\n >>> neverbounce = NeverBounce('my_api_username', 'my_api_key')\n >>> verified = neverbounce.verify('martin@martinkosir.net')\n\n >>> print(str(verified))\n martin@martinkosir.net: valid\n\n >>> print(verified.email, verified.result_text, verified.result_code, verified.is_valid)\n martin@martinkosir.net valid 0 True\n\nBulk verification\n~~~~~~~~~~~~~~~~~\n\nTo use this features you need to `configure a payment method`_ in\nNeverBounce account settings.\n\n.. code::\n\n >>> from neverbounce import NeverBounce\n >>> neverbounce = NeverBounce('my_api_username', 'my_api_key')\n\nCreate the job and get it's id:\n\n.. code::\n\n >>> emails = ['some.email@example.com', 'john.smith@gmail.com']\n >>> job_id = neverbounce.create_job(emails).job_id\n\nPeriodically check the status of verification job:\n\n.. code::\n\n >>> job_status = neverbounce.check_job(job_id)\n\nUse the `results` generator to iterate over verified emails if the job has been completed:\n\n.. code::\n\n >>> if job_status.is_completed:\n ... for verified in neverbounce.results(job_id):\n ... print(verified.email, verified.result_text, verified.result_code, verified.is_valid)\n some.email@example.com invalid 1 False\n john.smith@gmail.com invalid 1 False\n\nAccount information\n~~~~~~~~~~~~~~~~~~~\n\nGet the information about your API account:\n\n.. code::\n\n >>> from neverbounce import NeverBounce\n >>> neverbounce = NeverBounce('my_api_username', 'my_api_key')\n >>> account = neverbounce.account()\n\n >>> print(str(account))\n Credits: 999, Jobs Completed: 22, Jobs Processing: 0\n\n >>> print(account.credits, account.jobs_completed, account.jobs_processing)\n 999 22 0\n\nDocumentation\n-------------\n\n- `Official docs for the NeverBounce RESTful API`_\n\n\n.. _NeverBounce: https://neverbounce.com/\n.. _requests: http://docs.python-requests.org/\n.. _Sign up: https://app.neverbounce.com/register\n.. _API username and key: https://app.neverbounce.com/settings/api\n.. _configure a payment method: https://app.neverbounce.com/settings/billing\n.. _Official docs for the NeverBounce RESTful API: https://docs.neverbounce.com/\n\nBuild status\n------------\n\n.. image:: https://travis-ci.org/martinkosir/neverbounce-python.svg?branch=master\n :target: https://travis-ci.org/martinkosir/neverbounce-python", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/martinkosir/neverbounce-python", "keywords": "api,email,verification", "license": "MIT", "maintainer": null, "maintainer_email": null, "name": "neverbounce", "package_url": "https://pypi.org/project/neverbounce/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/neverbounce/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/martinkosir/neverbounce-python" }, "release_url": "https://pypi.org/project/neverbounce/0.2.0/", "requires_dist": null, "requires_python": null, "summary": "API library for the NeverBounce email verification service.", "version": "0.2.0" }, "last_serial": 2456529, "releases": { "0.1.3": [ { "comment_text": "", "digests": { "md5": "2ed591e638ce4982fcdb5b5712c04da8", "sha256": "5d3b4f1ff0aef52d040abf8554d7f225f4602a6d3935cb63be58c4acb5ab315f" }, "downloads": -1, "filename": "neverbounce-0.1.3.tar.gz", "has_sig": false, "md5_digest": "2ed591e638ce4982fcdb5b5712c04da8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7259, "upload_time": "2016-10-30T10:56:08", "url": "https://files.pythonhosted.org/packages/d7/b6/b544e61e848501c86bda5ff2757e9707a6c7335ca3d8562391b834452fc0/neverbounce-0.1.3.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "3050f7560ca55fe00bd2c0ee70101320", "sha256": "845d2b432d05a3b138e2bdf15a3f175417f01a00fe7bad768866881a30134a1e" }, "downloads": -1, "filename": "neverbounce-0.2.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "3050f7560ca55fe00bd2c0ee70101320", "packagetype": "bdist_wheel", "python_version": "3.5", "requires_python": null, "size": 7945, "upload_time": "2016-11-12T13:23:17", "url": "https://files.pythonhosted.org/packages/aa/a9/0811a5afdb4dfbc49e1f2a31cd727f7a0a11a9dcf16cb26047299c7ee15f/neverbounce-0.2.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "83d44c04d277211c5b2822ed28c579e4", "sha256": "9fc3634f1f559e285aa2825e24d509dee643064d1cfec2bc118a128468350260" }, "downloads": -1, "filename": "neverbounce-0.2.0.tar.gz", "has_sig": false, "md5_digest": "83d44c04d277211c5b2822ed28c579e4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7374, "upload_time": "2016-11-12T13:23:14", "url": "https://files.pythonhosted.org/packages/66/8e/c577a43a2cd7c07b249d96b2a3fad522e25345c77f26285a4be81ba0b990/neverbounce-0.2.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "3050f7560ca55fe00bd2c0ee70101320", "sha256": "845d2b432d05a3b138e2bdf15a3f175417f01a00fe7bad768866881a30134a1e" }, "downloads": -1, "filename": "neverbounce-0.2.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "3050f7560ca55fe00bd2c0ee70101320", "packagetype": "bdist_wheel", "python_version": "3.5", "requires_python": null, "size": 7945, "upload_time": "2016-11-12T13:23:17", "url": "https://files.pythonhosted.org/packages/aa/a9/0811a5afdb4dfbc49e1f2a31cd727f7a0a11a9dcf16cb26047299c7ee15f/neverbounce-0.2.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "83d44c04d277211c5b2822ed28c579e4", "sha256": "9fc3634f1f559e285aa2825e24d509dee643064d1cfec2bc118a128468350260" }, "downloads": -1, "filename": "neverbounce-0.2.0.tar.gz", "has_sig": false, "md5_digest": "83d44c04d277211c5b2822ed28c579e4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7374, "upload_time": "2016-11-12T13:23:14", "url": "https://files.pythonhosted.org/packages/66/8e/c577a43a2cd7c07b249d96b2a3fad522e25345c77f26285a4be81ba0b990/neverbounce-0.2.0.tar.gz" } ] }