testvoltricx 1.0.5__tar.gz

testvoltricx-1.0.5/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026-Present @JustNixx, @Dipendra-creator and RevvLabs
+
+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.

testvoltricx-1.0.5/PKG-INFO

@@ -0,0 +1,206 @@
+Metadata-Version: 2.4
+Name: testvoltricx
+Version: 1.0.5
+Summary: A modern, simple, and powerful Lavalink wrapper for discord.py.
+Author: @JustNixx, @Dipendra-creator
+License: MIT
+Project-URL: Homepage, https://github.com/ded-lmfao/voltricx
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: discord.py>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: yarl>=1.9.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: dev
+Requires-Dist: ruff>=0.3.0; extra == "dev"
+Requires-Dist: pyright>=1.1.300; extra == "dev"
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/banner.svg" width="100%" alt="Voltricx Banner">
+  
+  <h3>The Next-Generation Lavalink Wrapper for Python</h3>
+
+  <p align="center">
+    <a href="https://pypi.org/project/voltricx/" style="text-decoration:none;"><img src="https://img.shields.io/badge/PyPI-v1.0.5-blue?style=for-the-badge&logo=pypi" alt="PyPI version"></a>
+    <a href="https://pypi.org/project/voltricx/" style="text-decoration:none;"><img src="https://img.shields.io/badge/python-3.12%2B-3776AB?style=for-the-badge&logo=python" alt="Python versions"></a>
+    <a href="LICENSE" style="text-decoration:none;"><img src="https://img.shields.io/badge/license-MIT-blue?style=for-the-badge" alt="License"></a>
+    <img src="https://img.shields.io/badge/Status-Stable-brightgreen?style=for-the-badge" alt="Status">
+  </p>
+
+  <p align="center">
+    <a href="https://lavalink.dev"><img src="https://img.shields.io/badge/Lavalink-v4.0%2B-FB7713?style=flat-square&logo=lavalink" alt="Lavalink version"></a>
+    <img src="https://img.shields.io/badge/Plugins-Native_Support-FB7713?style=flat-square" alt="Plugins Support">
+  </p>
+
+  <p align="center">
+    <a href="https://ded-lmfao.github.io/revvcore/"><img src="https://img.shields.io/github/actions/workflow/status/ded-lmfao/revvcore/deploy-docs.yml?branch=main&label=Docs&logo=readthedocs&style=flat-square" alt="Docs"></a>
+    <a href="https://github.com/ded-lmfao/revvcore/actions/workflows/version_checks.yml"><img src="https://img.shields.io/github/actions/workflow/status/ded-lmfao/revvcore/version_checks.yml?branch=main&label=Version%20Checks&logo=githubactions&style=flat-square" alt="Version Checks"></a>
+    <a href="https://github.com/ded-lmfao/revvcore/actions/workflows/version_checks.yml"><img src="https://img.shields.io/github/actions/workflow/status/ded-lmfao/revvcore/version_checks.yml?branch=main&label=Ruff&logo=ruff&style=flat-square" alt="Ruff Checks"></a>
+    <a href="https://github.com/ded-lmfao/revvcore/actions/workflows/version_checks.yml"><img src="https://img.shields.io/github/actions/workflow/status/ded-lmfao/revvcore/version_checks.yml?branch=main&label=Pyright&logo=python&style=flat-square" alt="Pyright"></a>
+    <a href="https://github.com/ded-lmfao/revvcore/actions/workflows/version_checks.yml"><img src="https://img.shields.io/github/actions/workflow/status/ded-lmfao/revvcore/version_checks.yml?branch=main&label=Pytest&logo=pytest&style=flat-square" alt="Pytest"></a>
+  </p>
+
+
+  <p align="center">
+    <a href="https://github.com/ded-lmfao/revvcore/actions/workflows/build_and_publish.yml"><img src="https://img.shields.io/github/actions/workflow/status/ded-lmfao/revvcore/build_and_publish.yml?label=Publish%20to%20PyPI&style=flat-square" alt="Publish to PyPI"></a>
+  </p>
+
+
+  <p align="center">
+    <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/shield-stats/assets/quality_gate.svg" alt="Quality Gate">
+    <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/shield-stats/assets/coverage.svg" alt="Coverage">
+    <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/shield-stats/assets/bugs.svg" alt="Bugs">
+    <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/shield-stats/assets/vulnerabilities.svg" alt="Vulnerabilities">
+    <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/shield-stats/assets/code_smells.svg" alt="Code Smells">
+  </p>
+</div>
+
+---
+
+**Voltricx** is a high-performance, feature-rich Lavalink wrapper built for modern Discord bot development in Python. Engineered for speed, reliability, and ease of use, Voltricx offers a professional-grade API that makes audio integration seamless and powerful.
+
+---
+
+## <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="32" align="center" alt="Icon"> Table of Contents
+- [Why Voltricx?](#why-voltricx)
+- [Features](#features)
+- [Installation](#installation)
+- [Quickstart](#quickstart)
+- [Examples](#examples)
+- [Contributing](#contributing)
+- [License](#license)
+
+---
+
+### <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="32" align="center" alt="Icon"> Why Voltricx?
+
+<table border="0">
+  <tr>
+    <td width="52" valign="middle"><img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="44" alt="Icon"></td>
+    <td valign="middle"><strong>Next-Gen Performance</strong>: Dual-tier caching (LRU/LFU) powered by <code>HyperCache</code> for lightning-fast data retrieval.</td>
+  </tr>
+  <tr>
+    <td width="52" valign="middle"><img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="44" alt="Icon"></td>
+    <td valign="middle"><strong>Strictly Typed</strong>: Comprehensive type hinting and Pydantic v2 validation ensure your code is robust and maintainable.</td>
+  </tr>
+  <tr>
+    <td width="52" valign="middle"><img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="44" alt="Icon"></td>
+    <td valign="middle"><strong>High-Fidelity Failover</strong>: Automated node shifting and silent reconnects ensure a seamless listening experience.</td>
+  </tr>
+  <tr>
+    <td width="52" valign="middle"><img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="44" alt="Icon"></td>
+    <td valign="middle"><strong>Modern Standards</strong>: Fully compatible with Lavalink v4.0+, including native support for the DAVE E2EE protocol and filters.</td>
+  </tr>
+  <tr>
+    <td width="52" valign="middle"><img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="44" alt="Icon"></td>
+    <td valign="middle"><strong>Smart Load Balancing</strong>: Advanced penalty-based node selection for optimal performance across multiple Lavalink nodes.</td>
+  </tr>
+</table>
+
+---
+
+### <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="32" align="center" alt="Icon"> Features
+
+- 🚀 **Asynchronous Architecture**: Built from the ground up to be fully async and non-blocking.
+- 📡 **Websocket Management**: Efficient handling of Lavalink websocket connections with automatic retries.
+- 🎹 **Rich Audio Control**: Full support for filters including Equalizer, Timescale, Vibrato, and more.
+- 🌐 **DAVE Protocol**: Support for the latest Discord Audio Video Encryption standards.
+- ⚖️ **Regional Selection**: Intelligent node selection based on guild region and node latency.
+
+---
+
+### <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="32" align="center" alt="Icon"> Installation
+
+Voltricx requires **Python 3.12+**.
+
+```bash
+# Stable version from PyPI
+pip install voltricx
+```
+
+For the latest development version:
+```bash
+pip install git+https://github.com/ded-lmfao/voltricx.git
+```
+
+---
+
+### <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="32" align="center" alt="Icon"> Quickstart
+
+Here is a minimal example of how to get up and running with Voltricx.
+
+```python
+import discord
+from discord.ext import commands
+import voltricx
+
+class MyBot(commands.Bot):
+    def __init__(self):
+        super().__init__(command_prefix="!", intents=discord.Intents.all())
+
+    async def setup_hook(self):
+        # Configuration for your Lavalink Node
+        config = voltricx.NodeConfig(
+            uri="http://localhost:2333",
+            password="youshallnotpass",
+            identifier="MAIN-NODE"
+        )
+
+        # Initialize the Pool and add the node
+        node = voltricx.Node(config=config)
+        await voltricx.Pool.add_node(node)
+
+bot = MyBot()
+
+@bot.event
+async def on_voltricx_node_ready(node: voltricx.Node):
+    print(f"✅ Lavalink Node {node.identifier} is ready and connected!")
+
+@bot.command()
+async def play(ctx, *, query: str):
+    # Retrieve or create a player for the guild
+    player: voltricx.Player = ctx.voice_client or await ctx.author.voice.channel.connect(cls=voltricx.Player)
+
+    # Search for tracks
+    tracks = await voltricx.Pool.get_tracks(query)
+    if not tracks:
+        return await ctx.send("❌ No tracks found.")
+
+    track = tracks[0]
+    await player.play(track)
+    await ctx.send(f"🎶 **Now playing**: {track.title}")
+
+bot.run("YOUR_BOT_TOKEN")
+```
+
+---
+
+### <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="32" align="center" alt="Icon"> Examples
+
+Check the [example](example/) directory for advanced usage, including:
+- [Basic Bot Implementation](example/main.py)
+- Custom Queue Handlers
+- Advanced Filters (Nightcore, etc.)
+
+---
+
+### <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="32" align="center" alt="Icon"> Contributing
+
+We welcome contributions! If you'd like to help improve Voltricx:
+1. **Fork** the repository.
+2. **Clone** your fork and create a new feature branch (`git checkout -b feature/amazing-feature`).
+3. **Commit** your improvements (`git commit -m 'feat: add some amazing feature'`).
+4. **Push** the changes to your fork (`git push origin feature/amazing-feature`).
+5. **Open a Pull Request**.
+
+---
+
+### <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="32" align="center" alt="Icon"> License
+
+Voltricx is released under the MIT License. See [LICENSE](LICENSE) for more information.

testvoltricx-1.0.5/README.md

@@ -0,0 +1,183 @@
+<div align="center">
+  <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/banner.svg" width="100%" alt="Voltricx Banner">
+  
+  <h3>The Next-Generation Lavalink Wrapper for Python</h3>
+
+  <p align="center">
+    <a href="https://pypi.org/project/voltricx/" style="text-decoration:none;"><img src="https://img.shields.io/badge/PyPI-v1.0.5-blue?style=for-the-badge&logo=pypi" alt="PyPI version"></a>
+    <a href="https://pypi.org/project/voltricx/" style="text-decoration:none;"><img src="https://img.shields.io/badge/python-3.12%2B-3776AB?style=for-the-badge&logo=python" alt="Python versions"></a>
+    <a href="LICENSE" style="text-decoration:none;"><img src="https://img.shields.io/badge/license-MIT-blue?style=for-the-badge" alt="License"></a>
+    <img src="https://img.shields.io/badge/Status-Stable-brightgreen?style=for-the-badge" alt="Status">
+  </p>
+
+  <p align="center">
+    <a href="https://lavalink.dev"><img src="https://img.shields.io/badge/Lavalink-v4.0%2B-FB7713?style=flat-square&logo=lavalink" alt="Lavalink version"></a>
+    <img src="https://img.shields.io/badge/Plugins-Native_Support-FB7713?style=flat-square" alt="Plugins Support">
+  </p>
+
+  <p align="center">
+    <a href="https://ded-lmfao.github.io/revvcore/"><img src="https://img.shields.io/github/actions/workflow/status/ded-lmfao/revvcore/deploy-docs.yml?branch=main&label=Docs&logo=readthedocs&style=flat-square" alt="Docs"></a>
+    <a href="https://github.com/ded-lmfao/revvcore/actions/workflows/version_checks.yml"><img src="https://img.shields.io/github/actions/workflow/status/ded-lmfao/revvcore/version_checks.yml?branch=main&label=Version%20Checks&logo=githubactions&style=flat-square" alt="Version Checks"></a>
+    <a href="https://github.com/ded-lmfao/revvcore/actions/workflows/version_checks.yml"><img src="https://img.shields.io/github/actions/workflow/status/ded-lmfao/revvcore/version_checks.yml?branch=main&label=Ruff&logo=ruff&style=flat-square" alt="Ruff Checks"></a>
+    <a href="https://github.com/ded-lmfao/revvcore/actions/workflows/version_checks.yml"><img src="https://img.shields.io/github/actions/workflow/status/ded-lmfao/revvcore/version_checks.yml?branch=main&label=Pyright&logo=python&style=flat-square" alt="Pyright"></a>
+    <a href="https://github.com/ded-lmfao/revvcore/actions/workflows/version_checks.yml"><img src="https://img.shields.io/github/actions/workflow/status/ded-lmfao/revvcore/version_checks.yml?branch=main&label=Pytest&logo=pytest&style=flat-square" alt="Pytest"></a>
+  </p>
+
+
+  <p align="center">
+    <a href="https://github.com/ded-lmfao/revvcore/actions/workflows/build_and_publish.yml"><img src="https://img.shields.io/github/actions/workflow/status/ded-lmfao/revvcore/build_and_publish.yml?label=Publish%20to%20PyPI&style=flat-square" alt="Publish to PyPI"></a>
+  </p>
+
+
+  <p align="center">
+    <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/shield-stats/assets/quality_gate.svg" alt="Quality Gate">
+    <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/shield-stats/assets/coverage.svg" alt="Coverage">
+    <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/shield-stats/assets/bugs.svg" alt="Bugs">
+    <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/shield-stats/assets/vulnerabilities.svg" alt="Vulnerabilities">
+    <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/shield-stats/assets/code_smells.svg" alt="Code Smells">
+  </p>
+</div>
+
+---
+
+**Voltricx** is a high-performance, feature-rich Lavalink wrapper built for modern Discord bot development in Python. Engineered for speed, reliability, and ease of use, Voltricx offers a professional-grade API that makes audio integration seamless and powerful.
+
+---
+
+## <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="32" align="center" alt="Icon"> Table of Contents
+- [Why Voltricx?](#why-voltricx)
+- [Features](#features)
+- [Installation](#installation)
+- [Quickstart](#quickstart)
+- [Examples](#examples)
+- [Contributing](#contributing)
+- [License](#license)
+
+---
+
+### <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="32" align="center" alt="Icon"> Why Voltricx?
+
+<table border="0">
+  <tr>
+    <td width="52" valign="middle"><img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="44" alt="Icon"></td>
+    <td valign="middle"><strong>Next-Gen Performance</strong>: Dual-tier caching (LRU/LFU) powered by <code>HyperCache</code> for lightning-fast data retrieval.</td>
+  </tr>
+  <tr>
+    <td width="52" valign="middle"><img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="44" alt="Icon"></td>
+    <td valign="middle"><strong>Strictly Typed</strong>: Comprehensive type hinting and Pydantic v2 validation ensure your code is robust and maintainable.</td>
+  </tr>
+  <tr>
+    <td width="52" valign="middle"><img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="44" alt="Icon"></td>
+    <td valign="middle"><strong>High-Fidelity Failover</strong>: Automated node shifting and silent reconnects ensure a seamless listening experience.</td>
+  </tr>
+  <tr>
+    <td width="52" valign="middle"><img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="44" alt="Icon"></td>
+    <td valign="middle"><strong>Modern Standards</strong>: Fully compatible with Lavalink v4.0+, including native support for the DAVE E2EE protocol and filters.</td>
+  </tr>
+  <tr>
+    <td width="52" valign="middle"><img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="44" alt="Icon"></td>
+    <td valign="middle"><strong>Smart Load Balancing</strong>: Advanced penalty-based node selection for optimal performance across multiple Lavalink nodes.</td>
+  </tr>
+</table>
+
+---
+
+### <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="32" align="center" alt="Icon"> Features
+
+- 🚀 **Asynchronous Architecture**: Built from the ground up to be fully async and non-blocking.
+- 📡 **Websocket Management**: Efficient handling of Lavalink websocket connections with automatic retries.
+- 🎹 **Rich Audio Control**: Full support for filters including Equalizer, Timescale, Vibrato, and more.
+- 🌐 **DAVE Protocol**: Support for the latest Discord Audio Video Encryption standards.
+- ⚖️ **Regional Selection**: Intelligent node selection based on guild region and node latency.
+
+---
+
+### <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="32" align="center" alt="Icon"> Installation
+
+Voltricx requires **Python 3.12+**.
+
+```bash
+# Stable version from PyPI
+pip install voltricx
+```
+
+For the latest development version:
+```bash
+pip install git+https://github.com/ded-lmfao/voltricx.git
+```
+
+---
+
+### <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="32" align="center" alt="Icon"> Quickstart
+
+Here is a minimal example of how to get up and running with Voltricx.
+
+```python
+import discord
+from discord.ext import commands
+import voltricx
+
+class MyBot(commands.Bot):
+    def __init__(self):
+        super().__init__(command_prefix="!", intents=discord.Intents.all())
+
+    async def setup_hook(self):
+        # Configuration for your Lavalink Node
+        config = voltricx.NodeConfig(
+            uri="http://localhost:2333",
+            password="youshallnotpass",
+            identifier="MAIN-NODE"
+        )
+
+        # Initialize the Pool and add the node
+        node = voltricx.Node(config=config)
+        await voltricx.Pool.add_node(node)
+
+bot = MyBot()
+
+@bot.event
+async def on_voltricx_node_ready(node: voltricx.Node):
+    print(f"✅ Lavalink Node {node.identifier} is ready and connected!")
+
+@bot.command()
+async def play(ctx, *, query: str):
+    # Retrieve or create a player for the guild
+    player: voltricx.Player = ctx.voice_client or await ctx.author.voice.channel.connect(cls=voltricx.Player)
+
+    # Search for tracks
+    tracks = await voltricx.Pool.get_tracks(query)
+    if not tracks:
+        return await ctx.send("❌ No tracks found.")
+
+    track = tracks[0]
+    await player.play(track)
+    await ctx.send(f"🎶 **Now playing**: {track.title}")
+
+bot.run("YOUR_BOT_TOKEN")
+```
+
+---
+
+### <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="32" align="center" alt="Icon"> Examples
+
+Check the [example](example/) directory for advanced usage, including:
+- [Basic Bot Implementation](example/main.py)
+- Custom Queue Handlers
+- Advanced Filters (Nightcore, etc.)
+
+---
+
+### <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="32" align="center" alt="Icon"> Contributing
+
+We welcome contributions! If you'd like to help improve Voltricx:
+1. **Fork** the repository.
+2. **Clone** your fork and create a new feature branch (`git checkout -b feature/amazing-feature`).
+3. **Commit** your improvements (`git commit -m 'feat: add some amazing feature'`).
+4. **Push** the changes to your fork (`git push origin feature/amazing-feature`).
+5. **Open a Pull Request**.
+
+---
+
+### <img src="https://raw.githubusercontent.com/ded-lmfao/revvcore/refs/heads/main/assets/logo.svg" width="32" align="center" alt="Icon"> License
+
+Voltricx is released under the MIT License. See [LICENSE](LICENSE) for more information.

testvoltricx-1.0.5/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "testvoltricx"
+version = "1.0.5"
+description = "A modern, simple, and powerful Lavalink wrapper for discord.py."
+authors = [
+    { name = "@JustNixx" },
+    { name = "@Dipendra-creator" }
+]
+license = { text = "MIT" }
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "discord.py>=2.0.0",
+    "pydantic>=2.0.0",
+    "aiohttp>=3.8.0",
+    "yarl>=1.9.0",
+    "python-dotenv>=1.0.0"
+]
+
+[project.optional-dependencies]
+dev = [
+    "ruff>=0.3.0",
+    "pyright>=1.1.300",
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+    "pytest-cov>=4.1.0"
+]
+
+[project.urls]
+Homepage = "https://github.com/ded-lmfao/voltricx"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["voltricx*"]
+
+[tool.ruff]
+target-version = "py312"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "UP"]
+ignore = [
+    "E501",   # line too long — handled by formatter
+    "UP007",  # use X | Y for Union — already done; suppress for Annotated[] edge cases
+]
+# Allow F401 on re-export modules (__init__.py, typings/__init__.py)
+per-file-ignores = { "voltricx/__init__.py" = ["F401"], "voltricx/typings/__init__.py" = ["F401", "F403"] }
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"

testvoltricx-1.0.5/setup.cfg

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

testvoltricx-1.0.5/tests/test_backoff.py

@@ -0,0 +1,81 @@
+"""Tests for voltricx.backoff — targeting 100% branch coverage."""
+
+from voltricx.backoff import Backoff
+
+
+def test_backoff_initial_state():
+    b = Backoff()
+    assert b.base == 1
+    assert b.maximum == 30.0
+    assert b.max_tries == 5
+    assert b.retries == 1
+    assert b._last_wait == 0
+
+
+def test_backoff_custom_params():
+    b = Backoff(base=2, maximum=60.0, max_tries=10)
+    assert b.base == 2
+    assert b.maximum == 60.0
+    assert b.max_tries == 10
+
+
+def test_backoff_calculate_returns_float():
+    b = Backoff()
+    wait = b.calculate()
+    assert isinstance(wait, float)
+    assert wait >= 0
+
+
+def test_backoff_calculate_does_not_exceed_maximum():
+    b = Backoff(base=1, maximum=5.0, max_tries=None)
+    for _ in range(20):
+        wait = b.calculate()
+        assert wait <= 5.0
+
+
+def test_backoff_reset():
+    b = Backoff()
+    b.calculate()
+    b.calculate()
+    b.reset()
+    assert b.retries == 1
+    assert b._last_wait == 0
+
+
+def test_backoff_resets_after_max_tries():
+    b = Backoff(base=1, maximum=100.0, max_tries=3)
+    for _ in range(3):
+        b.calculate()
+    # After max_tries exhausted, retries resets
+    assert b.retries == 1
+
+
+def test_backoff_indefinite_run():
+    """max_tries=None should never reset due to retries."""
+    b = Backoff(base=1, maximum=30.0, max_tries=None)
+    # Run many times — should not crash or exceed maximum
+    for _ in range(50):
+        wait = b.calculate()
+        assert wait <= 30.0
+
+
+def test_backoff_wait_doubles_when_below_last():
+    """Forces the wait < _last_wait branch."""
+    b = Backoff(base=1, maximum=1000.0, max_tries=None)
+    # Manually set a very high last_wait so random wait will be < last_wait
+    b._last_wait = 999.0
+    b.retries = 1
+    wait = b.calculate()
+    # Should double the last_wait (999.0 * 2 = 1998.0) but capped at maximum
+    assert wait <= 1000.0
+
+
+def test_backoff_resets_on_exceeding_maximum():
+    """When wait > maximum, retries and _last_wait reset."""
+    b = Backoff(base=1, maximum=0.001, max_tries=None)
+    b._last_wait = 999.0  # force doubling path
+    b.retries = 1
+    b.calculate()
+    # After exceeding maximum, state should reset
+    assert b._last_wait == 0
+    assert b.retries == 1