All Projects → jpetrucciani → Hubspot3

jpetrucciani / Hubspot3

Licence: mit
python3.5+ hubspot client based on hapipy, but modified to use the newer endpoints and non-legacy python

Programming Languages

python
139335 projects - #7 most used programming language
python3
1442 projects

Projects that are alternatives of or similar to Hubspot3

Lingua Franca
Mycroft's multilingual text parsing and formatting library
Stars: ✭ 51 (-57.85%)
Mutual labels:  hacktoberfest, library
Libgui
Buttons & Co
Stars: ✭ 78 (-35.54%)
Mutual labels:  hacktoberfest, library
Sanity Typed Queries
A typed, zero-dependency schema generator and query builder for Sanity.
Stars: ✭ 54 (-55.37%)
Mutual labels:  hacktoberfest, library
Whatpulse
WhatPulse reverse engineered
Stars: ✭ 30 (-75.21%)
Mutual labels:  hacktoberfest, library
Rando Php
RandoPhp is a open source library that implements random generators (Integer, Char, Byte, Sequences, Boolean) and take random sample from arrays
Stars: ✭ 107 (-11.57%)
Mutual labels:  hacktoberfest, library
Mod Pbxproj
A python module to manipulate XCode projects
Stars: ✭ 959 (+692.56%)
Mutual labels:  hacktoberfest, library
Loadingshimmer
An easy way to add a shimmering effect to any view with just one line of code. It is useful as an unobtrusive loading indicator.
Stars: ✭ 1,180 (+875.21%)
Mutual labels:  hacktoberfest, library
Ngx Ui
🚀 Style and Component Library for Angular
Stars: ✭ 534 (+341.32%)
Mutual labels:  hacktoberfest, library
Chemfiles
Library for reading and writing chemistry files
Stars: ✭ 95 (-21.49%)
Mutual labels:  hacktoberfest, library
Protobuf Nim
Protobuf implementation in pure Nim that leverages the power of the macro system to not depend on any external tools
Stars: ✭ 90 (-25.62%)
Mutual labels:  hacktoberfest, library
Xtoolkit.whitelabel
Modular MVVM framework for fast creating powerful cross-platform applications with Xamarin.
Stars: ✭ 22 (-81.82%)
Mutual labels:  hacktoberfest, library
Kittehircclientlib
An IRC client library in Java
Stars: ✭ 116 (-4.13%)
Mutual labels:  hacktoberfest, library
Lambdacd
a library to define a continuous delivery pipeline in code
Stars: ✭ 655 (+441.32%)
Mutual labels:  hacktoberfest, library
Siler
⚡ Flat-files and plain-old PHP functions rockin'on as a set of general purpose high-level abstractions.
Stars: ✭ 1,056 (+772.73%)
Mutual labels:  hacktoberfest, library
Leku
🌍 Map location picker component for Android. Based on Google Maps. An alternative to Google Place Picker.
Stars: ✭ 612 (+405.79%)
Mutual labels:  hacktoberfest, library
Whisper
Whisper is a file-based time-series database format for Graphite.
Stars: ✭ 1,121 (+826.45%)
Mutual labels:  hacktoberfest, library
Ferret
Declarative web scraping
Stars: ✭ 4,837 (+3897.52%)
Mutual labels:  hacktoberfest, library
Telethon
Pure Python 3 MTProto API Telegram client library, for bots too!
Stars: ✭ 5,805 (+4697.52%)
Mutual labels:  hacktoberfest, library
Nimpylib
Some python standard library functions ported to Nim
Stars: ✭ 88 (-27.27%)
Mutual labels:  hacktoberfest, library
Chocobar
The usual Snackbar with more 🍫 and colours 🎉
Stars: ✭ 110 (-9.09%)
Mutual labels:  hacktoberfest, library

image PyPI version Code style: black Documentation Status Python 3.5+ supported

A python wrapper around HubSpot's APIs, for python 3.5+.

Built initially around hapipy, but heavily modified.

Check out the documentation here! (thanks readthedocs)

Quick start

Installation

# install hubspot3
pip install hubspot3

Basic Usage

from hubspot3 import Hubspot3

API_KEY = "your-api-key"

client = Hubspot3(api_key=API_KEY)

# all of the clients are accessible as attributes of the main Hubspot3 Client
contact = client.contacts.get_contact_by_email('[email protected]')
contact_id = contact['vid']

all_companies = client.companies.get_all()

# new usage limit functionality - keep track of your API calls
client.usage_limits
# <Hubspot3UsageLimits: 28937/1000000 (0.028937%) [reset in 22157s, cached for 299s]>

client.usage_limits.calls_remaining
# 971063

Individual Clients

from hubspot3.companies import CompaniesClient

API_KEY = "your-api-key"

client = CompaniesClient(api_key=API_KEY)

for company in client.get_all():
    print(company)

Passing Params

import json
from hubspot3.deals import DealsClient

deal_id = "12345"
API_KEY = "your_api_key"

deals_client = DealsClient(api_key=API_KEY)

params = {
    "includePropertyVersions": "true"
}  # Note values are camelCase as they appear in the Hubspot Documentation!

deal_data = deals_client.get(deal_id, params=params)
print(json.dumps(deal_data))

Command-line interface

There is also a command-line tool available. Install the extra requirement for that tool via:

pip install hubspot3[cli]

and you can use it as a command:

hubspot3 --help

See the Sphinx documentation for more details and explanations.

Rate Limiting

Be aware that this uses the HubSpot API directly, so you are subject to all of the guidelines that HubSpot has in place.

at the time of writing, HubSpot has the following limits in place for API requests:

Free & Starter:

  • 10 requests per second
  • 250,000 requests per day.

Professional & Enterprise:

  • 10 requests per second
  • 500,000 requests per day.

This daily limit resets at midnight based on the time zone setting of the HubSpot account. There is also an additional addon you can purchase for more requests.

Retrying API Calls

By default, hubspot3 will attempt to retry all API calls up to 2 times upon failure.

If you'd like to override this behavior, you can add a number_retries keyword argument to any Client constructor, or to individual API calls.

Extending the BaseClient - thanks @Guysoft!

Some of the APIs are not yet complete! If you'd like to use an API that isn't yet in this repo, you can extend the BaseClient class!

import json
from hubspot3.base import BaseClient


PIPELINES_API_VERSION = "1"


class PipelineClient(BaseClient):
    """
    Lets you extend to non-existing clients, this example extends pipelines
    """

    def __init__(self, *args, **kwargs):
        super(PipelineClient, self).__init__(*args, **kwargs)

    def get_pipelines(self, **options):
        params = {}

        return self._call("pipelines", method="GET", params=params)

    def _get_path(self, subpath):
        return "deals/v{}/{}".format(
            self.options.get("version") or PIPELINES_API_VERSION, subpath
        )


if __name__ == "__main__":
    API_KEY = "your_api_key"
    a = PipelineClient(api_key=API_KEY)
    print(json.dumps(a.get_pipelines()))

Advanced oauth2 token storage - thanks @sangaline!

This is an example of how you can use the oauth2_token_getter and oauth2_token_setter kwargs on the client to use custom storage (in this case redis) so that multiple clients can share the same access/refresh tokens generated by the oauth2 requests.

import aioredis
from hubspot3 import Hubspot3


redis_client = await aioredis.create_redis_pool(url, db=db, encoding='utf-8', timeout=10)

def oauth2_token_getter(token_type: str, client_id: str) -> str:
    loop = asyncio.get_event_loop()
    key = f'hubspot-oauth2-tokens:{token_type}:{client_id}'
    return loop.run_until_complete(redis_client.get(key))

def oauth2_token_setter(token_type: str, client_id: str, token: str) -> None:
    loop = asyncio.get_event_loop()
    key = f'hubspot-oauth2-tokens:{token_type}:{client_id}'
    # Token expiration is six hours, so match that when we store the tokens.
    # See: https://developers.hubspot.com/docs/methods/oauth2/refresh-access-token
    expire_in_seconds = 6 * 60 * 60
    loop.run_until_complete(redis_client.set(key, token, expire=expire_in_seconds))

# This client will share oauth2 credentials with other clients configured in the same way.
hubspot3_client = Hubspot3(
    access_token=access_token,
    client_id=client_id,
    client_secret=client_secret,
    refresh_token=refresh_token,
    oauth2_token_getter=oauth2_token_getter,
    oauth2_token_setter=oauth2_token_setter,
)

Testing

I'm currently working on rewriting many of the tests with pytest to work against the public API and ensure that we get the correct type of mock data back. These tests are currently in a very early state - I'll be working soon to get them all built out.

# Install required test packages
pip install pytest pytest-cov
# or
pip install -r requirements-dev.txt

# run tests
make
# or
make test_all
Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].