astra-engine 0.0.1b1__tar.gz

astra_engine-0.0.1b1/ERROR_CODES.md

@@ -0,0 +1,153 @@
+# Astra Error Codes Reference
+
+Every error in Astra carries a structured code, a human-readable message, and a recovery hint. Catch specific exceptions to handle failures gracefully.
+
+## Quick Example
+
+```python
+from astra.errors import MessageSendError, RateLimitedError
+
+try:
+    await client.chat.send_message(jid, text)
+except RateLimitedError as e:
+    print(f"{e.code}: {e.hint}")  # E8001: You are sending too many requests...
+    if e.retryable:
+        await asyncio.sleep(60)
+except MessageSendError as e:
+    print(e)  # [E3001] Failed to send message to ...
+```
+
+---
+
+## E1xxx — Authentication
+
+| Code | Exception | Description | Retryable |
+|------|-----------|-------------|-----------|
+| E1001 | `LoginFailedError` | Authentication failed | ✅ |
+| E1002 | `QRTimeoutError` | QR code scan timed out | ✅ |
+| E1003 | `PairingError` | Phone pairing failed | ✅ |
+| E1004 | `SessionExpiredError` | Session has expired | ✅ |
+| E1005 | `AuthRateLimitError` | Too many login attempts | ❌ |
+| E1006 | `PhoneDisconnectedError` | Primary phone lost connection | ✅ |
+
+## E2xxx — Connection & Browser
+
+| Code | Exception | Description | Retryable |
+|------|-----------|-------------|-----------|
+| E2001 | `BrowserStartError` | Failed to launch browser | ❌ |
+| E2002 | `BrowserCrashError` | Browser process crashed | ✅ |
+| E2003 | `BrowserLimitError` | Another instance using this session | ❌ |
+| E2004 | `PageUnresponsiveError` | Browser page frozen | ✅ |
+| E2005 | `ConnectionLostError` | Lost connection to browser | ✅ |
+| E2006 | `WebSocketDisconnectError` | WS connection to WA dropped | ✅ |
+| E2007 | `NavigationError` | Failed to navigate to WA Web | ✅ |
+| E2008 | `StartupError` | Client startup failed | ✅ |
+
+## E3xxx — Messaging & Chat
+
+| Code | Exception | Description | Retryable |
+|------|-----------|-------------|-----------|
+| E3001 | `MessageSendError` | Message failed to send | ✅ |
+| E3002 | `MessageTimeoutError` | Message send timed out | ✅ |
+| E3003 | `InvalidRecipientError` | Invalid recipient JID | ❌ |
+| E3004 | `MediaUploadError` | Media upload failed | ✅ |
+| E3005 | `MediaDownloadError` | Media download failed | ✅ |
+| E3006 | `MessageEditError` | Failed to edit message | ❌ |
+| E3007 | `MessageDeleteError` | Failed to delete message | ❌ |
+| E3008 | `ReactionError` | Failed to react | ❌ |
+| E3010 | `PollError` | Failed to create poll | ❌ |
+| E3011 | `PollVoteError` | Failed to vote on poll | ❌ |
+| E3012 | — | Failed to forward message | ❌ |
+| E3020 | `ChatNotFoundError` | Chat not found | ❌ |
+| E3021 | `ChatOperationError` | Archive/unarchive failed | ❌ |
+| E3022 | `ChatOperationError` | Mute/unmute failed | ❌ |
+| E3023 | `ChatOperationError` | Pin/unpin failed | ❌ |
+| E3024 | — | Mark as seen failed | ❌ |
+| E3025 | `SyncError` | Chat history sync failed | ✅ |
+
+## E4xxx — Groups
+
+| Code | Exception | Description | Retryable |
+|------|-----------|-------------|-----------|
+| E4001 | `GroupCreateError` | Failed to create group | ❌ |
+| E4002 | `GroupMemberError` | Failed to add member(s) | ❌ |
+| E4003 | `GroupMemberError` | Failed to remove member(s) | ❌ |
+| E4004 | — | Failed to promote to admin | ❌ |
+| E4005 | — | Failed to demote admin | ❌ |
+| E4006 | `GroupJoinError` | Failed to join via invite | ❌ |
+| E4007 | `GroupInfoError` | Failed to get group info | ❌ |
+| E4008 | — | Failed to leave group | ✅ |
+| E4010 | `GroupSettingsError` | Failed to update settings | ❌ |
+| E4020 | `GroupPermissionError` | Permission denied | ❌ |
+
+## E5xxx — Account & Profile
+
+| Code | Exception | Description | Retryable |
+|------|-----------|-------------|-----------|
+| E5001 | `ProfileReadError` | Failed to read profile | ✅ |
+| E5002 | `ProfileUpdateError` | Failed to update profile | ❌ |
+| E5010 | `StatusPostError` | Failed to post status | ✅ |
+| E5011 | — | Failed to post media status | ✅ |
+| E5020 | `PrivacyError` | Failed to update privacy | ✅ |
+| E5030 | `BlockError` | Failed to block/unblock | ❌ |
+| E5040 | — | Failed to get/set profile pic | ❌ |
+| E5050 | — | Logout failed | ❌ |
+
+## E6xxx — Bridge & Engine
+
+| Code | Exception | Description | Retryable |
+|------|-----------|-------------|-----------|
+| E6001 | `BridgeMethodNotFoundError` | JS method not found | ❌ |
+| E6002 | `BridgeCallError` | Bridge call failed | ✅ |
+| E6003 | — | JS evaluation failed | ✅ |
+| E6004 | — | Bridge not connected | ✅ |
+| E6005 | `EngineStallError` | Engine stall detected | ✅ |
+| E6006 | `ModuleMissingError` | Required WA module missing | ❌ |
+| E6007 | — | Script injection failed | ✅ |
+| E6008 | — | WA Store unavailable | ✅ |
+
+## E7xxx — Validation
+
+| Code | Exception | Description | Retryable |
+|------|-----------|-------------|-----------|
+| E7001 | `InvalidJIDError` | Invalid JID format | ❌ |
+| E7002 | — | Empty text content | ❌ |
+| E7003 | `InvalidInputError` | Missing required params | ❌ |
+| E7004 | `InvalidPhoneError` | Invalid phone number | ❌ |
+| E7005 | — | Invalid media input | ❌ |
+| E7006 | — | Payload too large | ❌ |
+
+## E8xxx — WhatsApp-Side
+
+| Code | Exception | Description | Retryable |
+|------|-----------|-------------|-----------|
+| E8001 | `RateLimitedError` | Rate limited by WA | ✅ |
+| E8002 | `EcosystemBlockError` | Blocked for ecosystem protection | ❌ |
+| E8003 | `AccountBannedError` | Account banned | ❌ |
+| E8004 | `WAServerError` | WA servers down | ✅ |
+| E8005 | `VersionMismatchError` | WA Web version mismatch | ✅ |
+| E8006 | `MultiDeviceLimitError` | Max linked devices reached | ❌ |
+| E8007 | — | Encryption error | ✅ |
+| E8008 | — | Contact not on WhatsApp | ❌ |
+
+---
+
+## Error Inheritance
+
+```
+Exception
+└── AstraError (base — has .code, .hint, .retryable, .severity, .to_dict())
+    ├── LoginFailedError (E1001)
+    ├── QRTimeoutError (E1002)
+    ├── PairingError (E1003)
+    ├── ...
+    ├── MessageSendError (E3001)
+    ├── PollError (E3010)
+    ├── GroupCreateError (E4001)
+    ├── BridgeCallError (E6002)
+    ├── InvalidInputError (E7xxx)
+    │   ├── InvalidJIDError (E7001)
+    │   └── InvalidPhoneError (E7004)
+    ├── RateLimitedError (E8001)
+    └── AccountBannedError (E8003)
+```

astra_engine-0.0.1b1/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2019 Pedro S Lopez
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

astra_engine-0.0.1b1/MANIFEST.in

@@ -0,0 +1,30 @@
+# Include in source distribution
+include LICENSE
+include README.md
+include ERROR_CODES.md
+include requirements.txt
+include pyproject.toml
+
+# Include documentation source and static assets
+recursive-include docs/source *.rst *.py *.png *.jpg *.jpeg *.svg
+recursive-include docs/source/_static *
+
+# Include examples
+recursive-include examples *.py
+
+# Include type stub marker
+include astra/py.typed
+
+# Exclude development / draft directories
+prune corastra
+prune nnew
+prune x
+prune wwaa
+prune docs/_build
+prune .astra_sessions
+prune plugins
+
+# Exclude caches
+global-exclude __pycache__
+global-exclude *.py[cod]
+global-exclude .DS_Store

astra_engine-0.0.1b1/PKG-INFO

@@ -0,0 +1,179 @@
+Metadata-Version: 2.4
+Name: astra-engine
+Version: 0.0.1b1
+Summary: A professional, high-performance WhatsApp Web automation library for Python.
+Author: Aman Kumar Pandey
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/paman7647/Astra
+Project-URL: Documentation, https://astra-engine.readthedocs.io
+Project-URL: Source, https://github.com/paman7647/Astra
+Project-URL: Issues, https://github.com/paman7647/Astra/issues
+Project-URL: Changelog, https://github.com/paman7647/Astra/blob/dev/CHANGELOG.md
+Keywords: whatsapp,whatsapp-web,automation,bot,playwright,async,messaging,chat
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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: Topic :: Communications :: Chat
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Framework :: AsyncIO
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: playwright>=1.40.0
+Requires-Dist: qrcode>=7.4
+Requires-Dist: Pillow>=10.0
+Requires-Dist: requests>=2.31
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+Requires-Dist: sphinx>=7.0; extra == "dev"
+Requires-Dist: sphinx-rtd-theme>=2.0; extra == "dev"
+Requires-Dist: ruff>=0.1; extra == "dev"
+Requires-Dist: mypy>=1.5; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=4.0; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+
+  <img src="AstraClient.png" alt="Astra Engine Logo" width="600" />
+
+  # Astra Engine
+
+  **The Professional WhatsApp Web Automation Library for Python**
+
+  [![Python Version](https://img.shields.io/badge/python-3.9%2B-blue?style=for-the-badge&logo=python)](https://www.python.org/)
+  [![License](https://img.shields.io/badge/license-Apache%202.0-green?style=for-the-badge)](LICENSE)
+  [![Code Style](https://img.shields.io/badge/code%20style-python-3776ab.svg?style=for-the-badge)](https://www.python.org/)
+  [![Documentation](https://img.shields.io/badge/docs-read%20the%20docs-8ca1af?style=for-the-badge)](https://astra-engine.readthedocs.io/)
+
+</div>
+
+---
+
+Astra Engine is a Python library that lets you automate WhatsApp Web. It uses Playwright to run a real browser instance, which means it works exactly like a real user. No hidden APIs, no ban risks from modified protocols—just meaningful automation.
+
+We built this because existing libraries were either too slow, too brittle, or abandoned. Astra is designed to be the tool we wanted to use ourselves: **written from scratch**, typed, documented, and reliable.
+
+## ⚡ What makes it different?
+
+*   **It's a Real Browser**: We don't try to reverse-engineer the encrypted WebSocket protocol. We drive the official WhatsApp Web client, so if it works in Chrome, it works in Astra.
+*   **Privacy Focused**: The engine automatically strips telemetry and tracking metrics. Your bot looks just like a normal user to WhatsApp's servers.
+*   **Developer Friendly**: Full type hints, proper documentation, and sensible error messages. You won't have to guess what methods do.
+*   **Stays Connected**: The connection manager handles QR code refreshes, internet dropouts, and browser crashes without you needing to write retry loops.
+
+---
+
+## 🚀 Features
+
+| Feature | Status | Notes |
+| :--- | :---: | :--- |
+| **Multi-Device** | ✅ | Works with the latest MD (Multi-Device) beta and stable. |
+| **Messaging** | ✅ | Send text, reply to messages, mention users, edit sent messages. |
+| **Media** | ✅ | Send and receive Images, Videos, Audio, Documents, and Stickers. |
+| **Interaction** | ✅ | Create Polls, react to messages with emojis, delete messages. |
+| **Groups** | ✅ | Extensive admin controls: promote/demote, change settings, manage participants. |
+| **Privacy** | ✅ | Detailed control over who sees your profile, status, and last seen. |
+| **Events** | ✅ | Real-time event loop to listen for new messages, status updates, and more. |
+
+---
+
+## 📦 Installation
+
+You need Python 3.9 or newer.
+
+```bash
+# 1. Install Astra Engine
+pip install astra-engine
+
+# 2. Install the browser binaries (Chromium)
+python -m playwright install chromium
+```
+
+---
+
+## 🛠️ Quick Start
+
+Here is the shortest way to get a bot running. This will print a QR code in your terminal—scan it with WhatsApp on your phone to log in.
+
+```python
+import asyncio
+from astra import Client, Filters
+
+async def main():
+    # session_id saves your login so you don't have to scan every time
+    async with Client(session_id="my_bot") as client:
+
+        # Respond to "!ping"
+        @client.on_message(Filters.command("ping"))
+        async def ping(msg):
+            await msg.respond("Pong! 🚀")
+
+        # React to any message containing "hello"
+        @client.on_message(Filters.text_contains("hello"))
+        async def greet(msg):
+            await msg.react("👋")
+
+        print("Bot is running... Press Ctrl+C to stop.")
+        await client.run_forever()
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+👉 **[Check out the examples folder](examples/)** for more scripts like Group Management, Media Sending, and Background Tasks.
+
+---
+
+## 🤝 Want to Contribute?
+
+We'd love your help! Astra is an open project. Whether you want to fix a bug, add a new feature, or just improve the docs, here is how you can get started.
+
+1.  **Fork the repo** on GitHub.
+2.  **Clone it** to your machine.
+3.  **Set up your environment**:
+
+    ```bash
+    # Create a virtual environment
+    python -m venv .venv
+    source .venv/bin/activate  # or .venv\Scripts\activate on Windows
+
+    # Install in editable mode with dev dependencies
+    pip install -e ".[dev]"
+    python -m playwright install chromium
+    ```
+
+4.  **Make your changes**.
+5.  **Run the checks** to make sure everything is clean:
+
+    ```bash
+    # format code
+    ruff check . --fix
+
+    # check types
+    mypy astra
+    ```
+
+6.  **Submit a Pull Request**! We'll review it and get it merged.
+
+---
+
+## ⚖️ Disclaimer
+
+This project is **not** affiliated, associated, authorized, endorsed by, or in any way officially connected with WhatsApp or any of its subsidiaries or its affiliates. The official WhatsApp website can be found at https://www.whatsapp.com.
+
+**This software is for educational purposes only.** Automating user accounts may violate WhatsApp's Terms of Service. Use it responsibly and at your own risk.
+
+---
+
+<div align="center">
+  <sub>Built with ❤️ by Aman Kumar Pandey</sub>
+</div>