{
    "info": {
        "author": "qvco",
        "author_email": "nikola.desuga@gmail.com",
        "bugtrack_url": null,
        "classifiers": [
            "License :: OSI Approved :: MIT License",
            "Programming Language :: Python :: 3",
            "Programming Language :: Python :: 3.10",
            "Programming Language :: Python :: 3.11",
            "Programming Language :: Python :: 3.8",
            "Programming Language :: Python :: 3.9"
        ],
        "description": "<p align=\"center\">\r\n  <br>\r\n  <img src=\"https://github.com/qvco/1secMail-Python/assets/77382767/fde69c1a-b95f-4d78-af1a-2dca315204bc\" alt=\"1secMail\" width=\"700\">\r\n<!--   <br>\r\n  1secMail for Python\r\n  <br> -->\r\n</p>\r\n\r\n<h4 align=\"center\">An API wrapper for <a href=\"https://www.1secmail.com/\" target=\"_blank\">www.1secmail.com</a> written in Python.</h4>\r\n\r\n  <p align=\"center\">\r\n    <img src=\"https://img.shields.io/github/release/qvco/1secMail-Python\">\r\n    <img src=\"https://img.shields.io/badge/python-3.8-blue.svg\">\r\n    <img src=\"https://img.shields.io/badge/License-MIT-blue.svg\">\r\n  </p>\r\n\r\n### About\r\n\r\nThis is an easy to use yet full-featured Python API wrapper for www.1secmail.com \u2197 using the official 1secMail API. It allows you to easily create temporary email addresses for testing, verification, or other purposes where you need a disposable email address.  \r\n> Asynchronous operations are also supported!:thumbsup:\r\n\r\n### Install\r\n\r\nTo install the package, you'll need Python 3.8 or above installed on your computer. From your command line:\r\n\r\n```bash\r\npip install 1secMail\r\n```\r\n\r\n<br>\r\n\r\n> **Note**\r\n> If you're willing to install the development version, do the following:\r\n\r\n```bash\r\ngit clone https://github.com/qvco/1secMail-Python.git\r\n\r\ncd 1secMail-Python\r\n\r\npip install -r requirements.txt\r\n\r\npip install -e .\r\n```\r\n\r\n## Usage\r\n\r\n### Generating Email Addresses\r\n\r\nTo generate a list of random email addresses, use the `random_email()` method:\r\n\r\n```python\r\nimport secmail\r\n\r\nclient = secmail.Client()\r\n\r\nclient.random_email(amount=3)\r\n>>> ['c3fho3cry1@1secmail.net', '5qcd3d36zr@1secmail.org', 'b6fgeothtg@1secmail.net']\r\n```\r\n\r\nYou can also generate a custom email address by specifying the username and domain:\r\n\r\n> **Note**\r\n> Specifying a domain is optional!\r\n\r\n```python\r\nclient.custom_email(username=\"bobby-bob\", domain=\"kzccv.com\")\r\n>>> 'bobby-bob@kzccv.com'\r\n```\r\n\r\n### Receiving Messages\r\n\r\nTo wait until a new message is received, use the `await_new_message()` method:\r\n\r\n```python\r\nmessage = client.await_new_message(\"bobby-bob@kzccv.com\")\r\n```\r\n\r\nTo check all messages received on a particular email address, use the `get_inbox()` method and pass the email address:\r\n\r\n```python\r\ninbox = client.get_inbox(\"bobby-bob@kzccv.com\")\r\nfor message in inbox:\r\n    print(message.id)\r\n    print(message.from_address)\r\n    print(message.subject)\r\n    print(message.date)\r\n```\r\n\r\nYou can also fetch a single message using the `get_message()` method and passing the email address and message ID:\r\n\r\n```python\r\nmessage = client.get_message(address=\"bobby-bob@kzccv.com\", message_id=235200687)\r\nprint(message.id)\r\nprint(message.subject)\r\nprint(message.body)\r\nprint(message.text_body)\r\nprint(message.html_body)\r\nprint(message.attachments)\r\nprint(message.date)\r\n```\r\n\r\n### Downloading an attachment\r\n\r\nYou can download an attachment from a message in the inbox of a specified email address using the download_attachment method like this:\r\n\r\n```python\r\nclient.download_attachment(address, message_id, attachment_filename)\r\n>>> 'Path: (C:\\Users\\user\\path/config/rocket.png), Size: 49071B'\r\n```\r\n\r\n## Asynchronous Client\r\n\r\n### Generating Email Addresses\r\n\r\nTo generate a list of random email addresses, use the `random_email()` method:\r\n\r\n```python\r\nimport asyncio\r\nimport secmail\r\n\r\nasync def main():\r\n    client = secmail.AsyncClient()\r\n    email_addresses = await client.random_email(amount=3)\r\n    print(email_addresses)\r\n\r\nasyncio.run(main())\r\n>>> ['c3fho3cry1@1secmail.net', '5qcd3d36zr@1secmail.org', 'b6fgeothtg@1secmail.net']\r\n```\r\n\r\nYou can also generate a custom email address by specifying the username and domain:\r\n\r\n> **Note**\r\n> Specifying a domain is optional!\r\n\r\n```python\r\nawait client.custom_email(username=\"bobby-bob\", domain=\"kzccv.com\")\r\n>>> 'bobby-bob@kzccv.com'\r\n```\r\n\r\n### Receiving Messages\r\n\r\nTo wait until a new message is received, use the `await_new_message()` method:\r\n\r\n```python\r\nimport asyncio\r\nimport secmail\r\n\r\nasync def main():\r\n    client = secmail.AsyncClient()\r\n    message = await client.await_new_message(\"bobby-bob@kzccv.com\")\r\n    print(f\"{message.from_address}: {message.subject}\")\r\n\r\nasyncio.run(main())\r\n```\r\n\r\nTo check all messages received on a particular email address, use the `get_inbox()` method and pass the email address:\r\n\r\n```python\r\nimport asyncio\r\nimport secmail\r\n\r\nasync def main():\r\n    client = secmail.AsyncClient()\r\n    inbox = await client.get_inbox(\"bobby-bob@kzccv.com\")\r\n    print(f\"You have {len(inbox)} messages in your inbox.\")\r\n\r\n    for message in inbox:\r\n        print(message.id)\r\n        print(message.from_address)\r\n        print(message.subject)\r\n        print(message.date)\r\n\r\nasyncio.run(main())\r\n```\r\n\r\nYou can also fetch a single message using the `get_message()` method and passing the email address and message ID:\r\n\r\n```python\r\nimport asyncio\r\nimport secmail\r\n\r\nasync def main():\r\n    client = secmail.AsyncClient()\r\n    address = \"bobby-bob@kzccv.com\"\r\n    inbox = await client.get_inbox(address)\r\n    message_id = inbox[0].id\r\n    message = await client.get_message(address, message_id)\r\n\r\n    print(message.id)\r\n    print(message.subject)\r\n    print(message.body)\r\n    print(message.text_body)\r\n    print(message.html_body)\r\n    print(message.attachments)\r\n    print(message.date)\r\n\r\nasyncio.run(main())\r\n```\r\n\r\n### Downloading an attachment\r\n\r\nYou can download an attachment from a message in the inbox of a specified email address using the download_attachment method like this:\r\n\r\n```python\r\nimport asyncio\r\nimport secmail\r\n\r\nasync def main():\r\n    client = secmail.AsyncClient()\r\n    address = \"bobby-bob@kzccv.com\"\r\n    inbox = await client.get_inbox(address)\r\n    message_id = inbox[0].id\r\n    message = await client.get_message(address, message_id)\r\n    attachment_filename = message.attachments[0].filename\r\n    await client.download_attachment(address, message_id, attachment_filename)\r\n\r\nasyncio.run(main())\r\n\r\n>>> 'Path: (C:\\Users\\user\\path/config/rocket.png), Size: 49071B'\r\n```\r\n\r\n## Licnese\r\n\r\nThis software is licensed under the [MIT](https://github.com/qvco/1secMail-Python/blob/master/LICENSE) \u00a9 [Qvco](https://github.com/qvco).\r\n",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "https://github.com/qvco/1secMail-Python",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/qvco/1secMail-Python",
        "keywords": "1secmail,onesecmail,tempmail,disposable,temporary,email,api,wrapper,library,async,asynchronous",
        "license": "MIT",
        "maintainer": "qvco",
        "maintainer_email": "nikola.desuga@gmail.com",
        "name": "1secMail",
        "package_url": "https://pypi.org/project/1secMail/",
        "platform": null,
        "project_url": "https://pypi.org/project/1secMail/",
        "project_urls": {
            "Download": "https://github.com/qvco/1secMail-Python",
            "Homepage": "https://github.com/qvco/1secMail-Python"
        },
        "release_url": "https://pypi.org/project/1secMail/1.2.0/",
        "requires_dist": [
            "httpx (>=0.17.1)"
        ],
        "requires_python": "",
        "summary": "\ud83d\udce7 Simple and intuitive, yet full featured API wrapper for www.1secmail.com, supporting both synchronous and asynchronous operations.",
        "version": "1.2.0",
        "yanked": false,
        "yanked_reason": null
    },
    "last_serial": 21137503,
    "releases": {
        "0.5.0": [
            {
                "comment_text": "",
                "digests": {
                    "blake2b_256": "d9be35cd534a27e61b825e9e4be54890e167f77dccf8f93a3a0b2c86c2b72821",
                    "md5": "b7234c99627334e881834ffa4a277274",
                    "sha256": "626d05f3134148ea4e9fb653b948c724b01096a510b420adeebec114f4fe6b89"
                },
                "downloads": -1,
                "filename": "1secMail-0.5.0-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "b7234c99627334e881834ffa4a277274",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 6454,
                "upload_time": "2023-07-13T15:48:32",
                "upload_time_iso_8601": "2023-07-13T15:48:32.634238Z",
                "url": "https://files.pythonhosted.org/packages/d9/be/35cd534a27e61b825e9e4be54890e167f77dccf8f93a3a0b2c86c2b72821/1secMail-0.5.0-py3-none-any.whl",
                "yanked": false,
                "yanked_reason": null
            },
            {
                "comment_text": "",
                "digests": {
                    "blake2b_256": "fc4bda2e89a4b05747ea2d1c092385caac74fa18d70de11dbf8cc14959680522",
                    "md5": "007f793f3bd34181e16a8def0627f57a",
                    "sha256": "ea324a0da721274d4a29743a9045e456f0fb5e7c010d92d1a0f83d0e5c8d349a"
                },
                "downloads": -1,
                "filename": "1secMail-0.5.0.tar.gz",
                "has_sig": false,
                "md5_digest": "007f793f3bd34181e16a8def0627f57a",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 5844,
                "upload_time": "2023-07-13T15:48:34",
                "upload_time_iso_8601": "2023-07-13T15:48:34.239354Z",
                "url": "https://files.pythonhosted.org/packages/fc/4b/da2e89a4b05747ea2d1c092385caac74fa18d70de11dbf8cc14959680522/1secMail-0.5.0.tar.gz",
                "yanked": false,
                "yanked_reason": null
            }
        ],
        "1.0.0": [
            {
                "comment_text": "",
                "digests": {
                    "blake2b_256": "cb52c55223ae87801d1a2ccb677a152d8ce84546bf2674c251be49e2cbc51eff",
                    "md5": "5473e54b33ebfb1fded733a056c18f5c",
                    "sha256": "1c00209aee0d85a00943afc35d46533eff1e720c50fde5ce76c803444e2138f0"
                },
                "downloads": -1,
                "filename": "1secMail-1.0.0-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "5473e54b33ebfb1fded733a056c18f5c",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 7763,
                "upload_time": "2023-07-14T15:18:24",
                "upload_time_iso_8601": "2023-07-14T15:18:24.796371Z",
                "url": "https://files.pythonhosted.org/packages/cb/52/c55223ae87801d1a2ccb677a152d8ce84546bf2674c251be49e2cbc51eff/1secMail-1.0.0-py3-none-any.whl",
                "yanked": false,
                "yanked_reason": null
            },
            {
                "comment_text": "",
                "digests": {
                    "blake2b_256": "d9434c8542ec266b5a3579fa21f12eac7600d6ee787aae46a48eecc78c8d4495",
                    "md5": "874ed1f723d79246f1108eecd295456e",
                    "sha256": "f9d7b6d13ca9e68efd023d145c071299f4c338f70951f6b0201b38124e54dfb2"
                },
                "downloads": -1,
                "filename": "1secMail-1.0.0.tar.gz",
                "has_sig": false,
                "md5_digest": "874ed1f723d79246f1108eecd295456e",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 7188,
                "upload_time": "2023-07-14T15:18:26",
                "upload_time_iso_8601": "2023-07-14T15:18:26.230005Z",
                "url": "https://files.pythonhosted.org/packages/d9/43/4c8542ec266b5a3579fa21f12eac7600d6ee787aae46a48eecc78c8d4495/1secMail-1.0.0.tar.gz",
                "yanked": false,
                "yanked_reason": null
            }
        ],
        "1.1.0": [
            {
                "comment_text": "",
                "digests": {
                    "blake2b_256": "9bb218003e138e9c7b97980e4b8bd30ff3595903c7a7c3c0f2443d0b00ab8bff",
                    "md5": "63ac612b0d7e9cce003f6c2e4f83cffa",
                    "sha256": "0277277ad17e7e8ddd42fb0e4be31e03b1c4543776d90aa78ae80c4ea41f4a19"
                },
                "downloads": -1,
                "filename": "1secMail-1.1.0-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "63ac612b0d7e9cce003f6c2e4f83cffa",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 8782,
                "upload_time": "2023-07-16T04:07:44",
                "upload_time_iso_8601": "2023-07-16T04:07:44.715012Z",
                "url": "https://files.pythonhosted.org/packages/9b/b2/18003e138e9c7b97980e4b8bd30ff3595903c7a7c3c0f2443d0b00ab8bff/1secMail-1.1.0-py3-none-any.whl",
                "yanked": false,
                "yanked_reason": null
            },
            {
                "comment_text": "",
                "digests": {
                    "blake2b_256": "3bb61e0350b3ae8334894787c7d771736a40ed8271fc1e6baf040743ecdfabc2",
                    "md5": "6b16950921c06f78491e18cc0473f24e",
                    "sha256": "7acd1573e18079880df99d74a077e78bbd1b0c7c468ff68e3fafc57572a7384a"
                },
                "downloads": -1,
                "filename": "1secMail-1.1.0.tar.gz",
                "has_sig": false,
                "md5_digest": "6b16950921c06f78491e18cc0473f24e",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 8377,
                "upload_time": "2023-07-16T04:07:46",
                "upload_time_iso_8601": "2023-07-16T04:07:46.554526Z",
                "url": "https://files.pythonhosted.org/packages/3b/b6/1e0350b3ae8334894787c7d771736a40ed8271fc1e6baf040743ecdfabc2/1secMail-1.1.0.tar.gz",
                "yanked": false,
                "yanked_reason": null
            }
        ],
        "1.2.0": [
            {
                "comment_text": "",
                "digests": {
                    "blake2b_256": "93847a6bbe6c03787579920b4407f8ddb6551a948405a41362de31bce6ab237c",
                    "md5": "264136ca4729b652fd9814d960996c63",
                    "sha256": "9e2e01fd8ed95abab90de2ec5dbf8f6e0687398ba90583d01b0d39c322aa008a"
                },
                "downloads": -1,
                "filename": "1secMail-1.2.0-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "264136ca4729b652fd9814d960996c63",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 8741,
                "upload_time": "2023-12-20T06:22:23",
                "upload_time_iso_8601": "2023-12-20T06:22:23.409604Z",
                "url": "https://files.pythonhosted.org/packages/93/84/7a6bbe6c03787579920b4407f8ddb6551a948405a41362de31bce6ab237c/1secMail-1.2.0-py3-none-any.whl",
                "yanked": false,
                "yanked_reason": null
            },
            {
                "comment_text": "",
                "digests": {
                    "blake2b_256": "d3cb9908c2735deef9b2ddc94c64c2709a9724495da4884fe4e1954196310266",
                    "md5": "e99d7d1765c5225c9e44aac9301bf044",
                    "sha256": "169955e6239aa2b3e039388dae0a4f6d26ef4f0a86806562c0b21be79d78450c"
                },
                "downloads": -1,
                "filename": "1secMail-1.2.0.tar.gz",
                "has_sig": false,
                "md5_digest": "e99d7d1765c5225c9e44aac9301bf044",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 8361,
                "upload_time": "2023-12-20T06:22:25",
                "upload_time_iso_8601": "2023-12-20T06:22:25.329032Z",
                "url": "https://files.pythonhosted.org/packages/d3/cb/9908c2735deef9b2ddc94c64c2709a9724495da4884fe4e1954196310266/1secMail-1.2.0.tar.gz",
                "yanked": false,
                "yanked_reason": null
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "93847a6bbe6c03787579920b4407f8ddb6551a948405a41362de31bce6ab237c",
                "md5": "264136ca4729b652fd9814d960996c63",
                "sha256": "9e2e01fd8ed95abab90de2ec5dbf8f6e0687398ba90583d01b0d39c322aa008a"
            },
            "downloads": -1,
            "filename": "1secMail-1.2.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "264136ca4729b652fd9814d960996c63",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 8741,
            "upload_time": "2023-12-20T06:22:23",
            "upload_time_iso_8601": "2023-12-20T06:22:23.409604Z",
            "url": "https://files.pythonhosted.org/packages/93/84/7a6bbe6c03787579920b4407f8ddb6551a948405a41362de31bce6ab237c/1secMail-1.2.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d3cb9908c2735deef9b2ddc94c64c2709a9724495da4884fe4e1954196310266",
                "md5": "e99d7d1765c5225c9e44aac9301bf044",
                "sha256": "169955e6239aa2b3e039388dae0a4f6d26ef4f0a86806562c0b21be79d78450c"
            },
            "downloads": -1,
            "filename": "1secMail-1.2.0.tar.gz",
            "has_sig": false,
            "md5_digest": "e99d7d1765c5225c9e44aac9301bf044",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 8361,
            "upload_time": "2023-12-20T06:22:25",
            "upload_time_iso_8601": "2023-12-20T06:22:25.329032Z",
            "url": "https://files.pythonhosted.org/packages/d3/cb/9908c2735deef9b2ddc94c64c2709a9724495da4884fe4e1954196310266/1secMail-1.2.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "vulnerabilities": []
}