📦 Opensource Python wrapper for Hiven's REST and WebSocket API

Kevin Thomas

Last update: Sep 3, 2021

Related tags

Third-party APIs Wrappers hiven.py

Overview

hiven.py

📦 Opensource Python wrapper for Hiven's REST and WebSocket API

Installation

pip install -U hiven.py

Usage

hiven.py is currently under development (that's going pretty fast), we have the basic receive + send message functionality for (jank) commands though!

Token

Hiven currently only supports selfbots so you'll need to get your Hiven token from the web application or the desktop client.

Open the web app or desktop client
Hit Ctrl+Shift+I to open Developer Tools
Navigate to the Console tab
Type in localStorage["hiven-auth"]
Copy & paste the token in your code

Do not share this token with anybody

Quickstart

import hiven
from hiven import Client

bot = Client(bot=False)  # set bot = True if you're controlling a bot account


@bot.event
async def on_ready():
    """Triggered when the bot is ready """
    
    print("hello world!")


@bot.event
async def on_message(message: hiven.Message):
    """Triggered when a message (that the bot can see) is sent"""

    if message.content.startswith("!hello"):
        await message.room.send("hey there!")  # respond to the message if it starts with !hello


bot.run(token="YOUR_TOKEN_HERE")

Credits

hiven - for providing such a great service for free
discord.py - for providing a easy-to-use structure that we continued in hiven.py
openhiven.py & vhiven - for great http & websocket api documentation
Iapetus-11 - for consistently providing great tips for efficiency and code quality, and helping out all the time

Async ready API wrapper for Revolt API written in Python.

Mutiny Async ready API wrapper for Revolt API written in Python. Installation Python 3.9 or higher is required To install the library, you can just ru

16 Mar 29, 2022

A Python API wrapper for the Twitter API!

PyTweet PyTweet is an api wrapper made for twitter using twitter's api version 2! Installation Windows py3 -m pip install PyTweet Linux python -m pip

1 Nov 19, 2022

Python API wrapper library for Convex Value API

convex-value-python Python API wrapper library for Convex Value API. Further Links: Convex Value homepage @ConvexValue on Twitter JB on Twitter Authen

2 May 11, 2022

This an API wrapper library for the OpenSea API written in Python 3.

OpenSea NFT API Python 3 wrapper This an API wrapper library for the OpenSea API written in Python 3. The library provides a simplified interface to f

159 Dec 26, 2022

YARSAW is an Async Python API Wrapper for the Random Stuff API.

Yet Another Random Stuff API Wrapper - YARSAW YARSAW is an Async Python API Wrapper for the Random Stuff API. This module makes it simpler for you to

6 Mar 27, 2022

EpikCord.py - This is an API Wrapper for Discord's API for Python

EpikCord.py - This is an API Wrapper for Discord's API for Python! We've decided not to fork discord.py and start completely from scratch for a new, better structuring system!

28 Oct 10, 2022

A simple Python API wrapper for Cloudflare Stream's API.

python-cloudflare-stream A basic Python API wrapper for working with Cloudflare Stream. Arbington.com started off using Cloudflare Stream. We used the

3 Sep 8, 2022

A wrapper for The Movie Database API v3 and v4 that only uses the read access token (not api key).

fulltmdb A wrapper for The Movie Database API v3 and v4 that only uses the read access token (not api key). Installation Use the package manager pip t

2 Sep 26, 2021

An API wrapper around the pythonanywhere's API.

pyaww An API wrapper around the pythonanywhere's API. The name stands for pythonanywherewrapper. 100% api coverage most of the codebase is documented

7 Dec 11, 2022

Comments

Add autoblack and flake8 workflows
autoblack will automatically format the code in the black codestyle, with a 127 character line length limit.

flake8 will also automatically run, and check the code for some errors to help catch issues before publishing.
opened by Iapetus-11 0
Don't ignore raised exceptions in events

This PR adds basic error handling for exceptions raised from events dispatched from Client.dispatch_event(...). It nicely prints the exceptions out, along with information on where it came from.

opened by Iapetus-11 0
Object default arguments are BAD
Occurrences of this throughout your code include:

https://github.com/trustedmercury/hiven.py/blob/90935b60899b18f6ff46df552575d8990ed0800f/hiven/gateway/http.py#L12

https://github.com/trustedmercury/hiven.py/blob/90935b60899b18f6ff46df552575d8990ed0800f/hiven/client.py#L47

This is an issue because that object will persist between calls to that function/method. Example:
opened by Iapetus-11 2