smsaero-api-async 3.1.0__py3-none-any.whl

smsaero/command_line.py

@@ -0,0 +1,53 @@
+"""
+This module provides a command line interface for sending SMS messages via SmsAero asynchronously.
+"""
+
+import argparse
+import asyncio
+import pprint
+import sys
+
+from smsaero import SmsAero, SmsAeroException
+
+
+async def main_async() -> None:
+    """
+    Parses command line arguments and sends an SMS message via SmsAero asynchronously.
+
+    The command line arguments are:
+    --email: The email registered with SmsAero.
+    --api_key: The API key from SmsAero.
+    --phone: The phone number to send the SMS message to.
+    --message: The text of the message to be sent.
+
+    If the SMS message is sent successfully, the response data from SmsAero is printed.
+    If an error occurs, the error message is printed and the program exits with status code 1.
+    """
+    parser = argparse.ArgumentParser(description="Send SMS via smsaero.ru gate")
+    parser.add_argument("--email", type=str, required=True, help="Your email registered with SmsAero")
+    parser.add_argument("--api_key", type=str, required=True, help="Your SmsAero API key")
+    parser.add_argument("--phone", type=int, required=True, help="Phone number to send SMS to")
+    parser.add_argument("--message", type=str, required=True, help="Message to send")
+
+    args = parser.parse_args()
+
+    api = SmsAero(args.email, args.api_key)
+    try:
+        result = await api.send_sms(args.phone, args.message)
+        pprint.pprint(result)
+    except SmsAeroException as e:
+        print(f"An error occurred: {e}")
+        sys.exit(1)
+    finally:
+        await api.close_session()
+
+
+def main() -> None:
+    """
+    Runs the main function asynchronously.
+    """
+    asyncio.run(main_async())
+
+
+if __name__ == "__main__":
+    main()

smsaero_api_async-3.1.0.dist-info/AUTHORS.md

@@ -0,0 +1,10 @@
+# Authors
+
+## Project Lead
+
+- GoTLiuM InSPiRiT ([@gotlium](https://github.com/gotlium))
+
+## Special Thanks
+
+- Company SmsAero for providing resources
+- All the users who reported bugs and provided feedback

smsaero_api_async-3.1.0.dist-info/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 SmsAero
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

smsaero_api_async-3.1.0.dist-info/METADATA

@@ -0,0 +1,143 @@
+Metadata-Version: 2.1
+Name: smsaero_api_async
+Version: 3.1.0
+Summary: SMS Aero Async API client
+Home-page: https://github.com/smsaero/smsaero_python/
+Author: SMS Aero
+Author-email: admin@smsaero.ru
+License: MIT
+Keywords: smsaero,api,smsaero_api_async,sms,hlr,viber
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Communications :: Telephony
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: AUTHORS.md
+Requires-Dist: setuptools
+Requires-Dist: aiohttp
+Provides-Extra: dev
+Requires-Dist: pytest >=8.2.2 ; extra == 'dev'
+Requires-Dist: flake8 >=7.1.0 ; extra == 'dev'
+Requires-Dist: ruff >=0.4.10 ; extra == 'dev'
+Requires-Dist: pylint >=3.2.4 ; extra == 'dev'
+Requires-Dist: tox >=4.15.1 ; extra == 'dev'
+Requires-Dist: mypy >=1.10.0 ; extra == 'dev'
+Requires-Dist: coverage >=7.5.4 ; extra == 'dev'
+Requires-Dist: bandit >=1.7.9 ; extra == 'dev'
+Requires-Dist: build >=1.2.1 ; extra == 'dev'
+Requires-Dist: twine >=5.1.1 ; extra == 'dev'
+
+# Python async library for sending SMS messages via SMS Aero API
+
+[![PyPI version](https://badge.fury.io/py/smsaero-api-async.svg)](https://badge.fury.io/py/smsaero-api-async)
+[![Python Versions](https://img.shields.io/pypi/pyversions/smsaero-api-async.svg)](https://pypi.org/project/smsaero-api-async/)
+[![Downloads](https://pepy.tech/badge/smsaero-api-async)](https://pepy.tech/project/smsaero-api-async)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](MIT-LICENSE)
+
+## Installation (from PyPI):
+
+```bash
+pip install -U smsaero-api-async
+```
+
+## Usage example:
+
+Get credentials from account settings page: https://smsaero.ru/cabinet/settings/apikey/
+
+```python
+import pprint
+import asyncio
+import smsaero
+
+
+SMSAERO_EMAIL = 'your email'
+SMSAERO_API_KEY = 'your api key'
+
+
+async def send_sms(phone: int, message: str) -> None:
+    """
+    Sends an SMS message
+
+    Parameters:
+    phone (int): The phone number to which the SMS message will be sent.
+    message (str): The content of the SMS message to be sent.
+    """
+    api = smsaero.SmsAero(SMSAERO_EMAIL, SMSAERO_API_KEY)
+    try:
+        result = await api.send_sms(phone, message)
+        pprint.pprint(result)
+    finally:
+        await api.close_session()
+
+
+async def send_telegram_code(phone: int, code: int) -> None:
+    """
+    Sends a Telegram code
+
+    Parameters:
+    phone (int): The phone number to which the Telegram code will be sent.
+    code (int): The Telegram code (4 to 8 digits).
+    """
+    api = smsaero.SmsAero(SMSAERO_EMAIL, SMSAERO_API_KEY)
+    try:
+        result = await api.send_telegram(phone, code)
+        pprint.pprint(result)
+    finally:
+        await api.close_session()
+
+
+if __name__ == '__main__':
+    asyncio.run(send_sms(70000000000, 'Hello, World!'))
+    asyncio.run(send_telegram_code(79990000000, 1234))
+```
+
+#### Exceptions:
+
+* `SmsAeroException` - base exception class for all exceptions raised by the library.
+* `SmsAeroConnectionException` - exception raised when there is a connection error.
+* `SmsAeroNoMoneyException` - exception raised when there is not enough money in the account.
+
+
+## Command line usage:
+
+```bash
+SMSAERO_EMAIL="your email"
+SMSAERO_API_KEY="your api key"
+
+smsaero_send --email "$SMSAERO_EMAIL" --api_key "$SMSAERO_API_KEY" --phone 70000000000 --message 'Hello, World!'
+```
+
+## Run on Docker:
+
+```bash
+docker pull 'smsaero/smsaero_python_async:latest'
+docker run -it --rm 'smsaero/smsaero_python_async:latest' smsaero_send --email "your email" --api_key "your api key" --phone 70000000000 --message 'Hello, World!'
+```
+
+## Compatibility:
+
+* Currently version of library is compatible with Python 3.7+.
+
+
+## License:
+
+```
+MIT License
+```

smsaero_api_async-3.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+smsaero/__init__.py,sha256=5lzTRXmIJg1R5fO2qWMBgjMbzGLYS_l6FmL7NuUoA44,54778
+smsaero/command_line.py,sha256=B-v6GmaVZo-KtVGV1NBanYXVxh5QgPnMo0wulHZNM1k,1695
+smsaero_api_async-3.1.0.dist-info/AUTHORS.md,sha256=rbi5f0bx_ioH_cfbLfvwKZQ1Jne8WbPWTHLszJ-wPa0,206
+smsaero_api_async-3.1.0.dist-info/LICENSE,sha256=GGmR858t4fTiHuzhyT1CKsmo0tQ82eEicSLDy6SWSLo,1064
+smsaero_api_async-3.1.0.dist-info/METADATA,sha256=Vc87pmAV7pzoN2aL3RF6dxFx7-KyNoF880mW5C3emcM,4587
+smsaero_api_async-3.1.0.dist-info/WHEEL,sha256=iAkIy5fosb7FzIOwONchHf19Qu7_1wCWyFNR5gu9nU0,91
+smsaero_api_async-3.1.0.dist-info/entry_points.txt,sha256=zIN16SM-DegJ5aQcx4mHDaX6gCX4CfRwafviKu9Jzl0,59
+smsaero_api_async-3.1.0.dist-info/top_level.txt,sha256=dcuKhkyQVDasrL6kM8MXsCrOCy6eVmSJzAUArJ0octU,8
+smsaero_api_async-3.1.0.dist-info/RECORD,,

smsaero_api_async-3.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (75.3.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

smsaero_api_async-3.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+smsaero_send = smsaero.command_line:main

smsaero_api_async-3.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+smsaero