smsaero-api-async 3.0.0__tar.gz

smsaero_api_async-3.0.0/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.0.0/CONTRIBUTING.md

@@ -0,0 +1,96 @@
+# Contributing
+
+Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given.
+
+You can contribute in many ways:
+
+## Types of Contributions
+
+### Report Bugs
+
+Report bugs at [https://github.com/smsaero/smsaero_python_async/issues](https://github.com/smsaero/smsaero_python_async/issues).
+
+If you are reporting a bug, please include:
+
+- Your operating system name and version.
+- Any details about your local setup that might be helpful in troubleshooting.
+- Detailed steps to reproduce the bug.
+
+### Fix Bugs
+
+Look through the GitHub issues for bugs. Anything tagged with "bug" is open to whoever wants to implement it.
+
+### Implement Features
+
+Look through the GitHub issues for features. Anything tagged with "feature" is open to whoever wants to implement it.
+
+### Write Documentation
+
+smsaero_python_async could always use more documentation, whether as part of the official smsaero_python_async docs, in docstrings, or even on the web in blog posts, articles, and such.
+
+### Submit Feedback
+
+The best way to send feedback is to file an issue at [https://github.com/smsaero/smsaero_python_async/issues](https://github.com/smsaero/smsaero_python_async/issues).
+
+If you are proposing a feature:
+
+- Explain in detail how it would work.
+- Keep the scope as narrow as possible, to make it easier to implement.
+- Remember that this is a volunteer-driven project, and that contributions are welcome :)
+
+## Get Started!
+
+Ready to contribute? Here's how to set up `smsaero_python_async` for local development.
+
+1. Fork the `smsaero_python_async` repo on GitHub.
+2. Clone your fork locally and switch to development branch:
+
+    ```bash
+    git clone git@github.com:smsaero/smsaero_python_async.git
+    cd smsaero_python_async/
+    git fetch --all
+    git checkout development
+    ```
+
+3. Install your local copy into a virtualenv. Assuming you have virtualenvwrapper installed, this is how you set up your fork for local development:
+
+    ```bash
+    mkvirtualenv smsaero_python_async
+    workon smsaero_python_async
+    python setup.py develop
+    ```
+
+4. Create a branch for local development:
+
+    ```bash
+    git checkout -b name-of-your-bugfix-or-feature
+    ```
+
+Now you can make your changes locally.
+
+5. When you're done making changes, check that your changes pass flake8 and the tests, including testing other Python versions with tox:
+
+    ```bash
+    make pep8
+    make test
+    tox
+    ```
+
+5. Commit your changes and push your branch to GitHub:
+
+    ```bash
+    git add .
+    git commit -m "Your detailed description of your changes."
+    git push origin name-of-your-bugfix-or-feature
+    ```
+
+6. Submit a pull request through the GitHub website.
+
+
+## Pull Request Guidelines
+
+Before you submit a pull request, check that it meets these guidelines:
+
+1. The pull request should include tests.
+2. If the pull request adds functionality, the docs should be updated. Put your new functionality into a function with a docstring, and add the feature to the list in README.md.
+3. The pull request should work with Python 3.6+, PyPy. Check [https://travis-ci.org/smsaero/smsaero_python_async/pull_requests](https://travis-ci.org/smsaero/smsaero_python_async/pull_requests) and make sure that the tests pass for all supported Python versions.

smsaero_api_async-3.0.0/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.0.0/MANIFEST.in

@@ -0,0 +1,7 @@
+include README.md
+include LICENSE
+include AUTHORS.md
+include CONTRIBUTING.md
+include requirements/*
+recursive-exclude * .DS_Store .env tests __pycache__ *.py[co] .idea* .git* .tox* .cache* .pytest_cache* .coverage dist build .dccache .mypy_cache .vscode* .vscode
+recursive-include smsaero *.py *.po *.mo

smsaero_api_async-3.0.0/PKG-INFO

@@ -0,0 +1,127 @@
+Metadata-Version: 2.1
+Name: smsaero_api_async
+Version: 3.0.0
+Summary: SmsAero Async API client
+Home-page: https://github.com/smsaero/smsaero_python/
+Author: SmsAero
+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.6
+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.6
+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"
+
+# SmsAero async API client
+
+[![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()
+
+
+if __name__ == '__main__':
+    asyncio.run(send_sms(70000000000, 'Hello, World!'))
+```
+
+#### 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.6+.
+
+
+## License:
+
+```
+MIT License
+```

smsaero_api_async-3.0.0/README.md

@@ -0,0 +1,80 @@
+# SmsAero async API client
+
+[![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()
+
+
+if __name__ == '__main__':
+    asyncio.run(send_sms(70000000000, 'Hello, World!'))
+```
+
+#### 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.6+.
+
+
+## License:
+
+```
+MIT License
+```

smsaero_api_async-3.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

smsaero_api_async-3.0.0/setup.py

@@ -0,0 +1,81 @@
+"""Setup script for the SmsAero API client package."""
+
+from setuptools import setup, find_packages
+
+
+with open("README.md", "r", encoding="utf-8") as file:
+    long_description = file.read()
+
+
+setup(
+    name="smsaero_api_async",
+    version="3.0.0",
+    description="SmsAero Async API client",
+    keywords=[
+        "smsaero",
+        "api",
+        "smsaero_api_async",
+        "sms",
+        "hlr",
+        "viber",
+    ],
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    author="SmsAero",
+    author_email="admin@smsaero.ru",
+    help_center="https://smsaero.ru/support/",
+    url="https://github.com/smsaero/smsaero_python/",
+    license="MIT",
+    packages=find_packages(exclude=["tests", "tests.*"]),
+    python_requires=">=3.6",
+    include_package_data=True,
+    install_requires=[
+        "setuptools",
+        "aiohttp",
+    ],
+    extras_require={
+        "dev": [
+            "pytest >= 8.2.2",
+            "flake8 >= 7.1.0",
+            "ruff >= 0.4.10",
+            "pylint >= 3.2.4",
+            "tox >= 4.15.1",
+            "mypy >= 1.10.0",
+            "coverage >= 7.5.4",
+            "bandit >= 1.7.9",
+            "build >= 1.2.1",
+            "twine >= 5.1.1",
+        ],
+    },
+    zip_safe=False,
+    classifiers=[
+        "Development Status :: 5 - Production/Stable",
+        "Environment :: Web Environment",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.7",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Programming Language :: Python :: 3.13",
+        "Programming Language :: Python :: 3.14",
+        "Programming Language :: Python :: Implementation :: CPython",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+        "Topic :: Communications :: Telephony",
+        "Topic :: Internet :: WWW/HTTP",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+    ],
+    entry_points={
+        "console_scripts": [
+            "smsaero_send=smsaero.command_line:main",
+        ],
+    },
+    options={
+        "bdist_wheel": {"universal": True},
+    },
+)