Skip to main content

The next generation Spotify Web API wrapper for Python

Project description

Spotipy2
The next generation Spotify Web API wrapper for Python 3.7+
Documentation Releases Community

Installation

pip install git+https://github.com/CyanBook/spotipy2

Why not spotipy?

Well, Spotipy2 has some big advantages over Spotipy.

Async support

The entire library is async-only, that translates in less overhead for supporting both sync and async code.

Spotipy2 uses aiohttp to make async HTTP requests and every function is async from the ground (even the ones that doesn't need it), giving all the benefits of it.

100% Type hinting

Unlike Spotipy, Spotipy2's types and methods are 100% hinted.

Although it's not mandatory, it speeds up the development and allows for excellent IDE support (auto-completion, warnings in case of wrong type usages, and more...).

A class for each objects

Spotify2 has a custom class for each Spotify object.

This permits easier understanding of what you're doing, code more readable and maintainable, bound methods, and more.

Quick example

import asyncio
from spotipy2 import Spotify
from spotipy2.auth import ClientCredentialsFlow


async def get_track_name(track_id):
    spo_client = Spotify(
        ClientCredentialsFlow(
            client_id="client_id",
            client_secret="client_secret"
        )
    )

    async with spo_client as s:
        track = await s.get_track(track_id)
        print(f"The name of the track is {track.name}")

asyncio.run(get_track_name(input("Insert the track ID: ")))

Copyright & License

  • Copyright (C) 2020 CyanBook https://github.com/cyanbook
  • Licensed under the terms of the GNU Lesser General Public License v3 or later (LGPLv3+)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

spotipy2-0.2.tar.gz (6.8 kB view hashes)

Uploaded Source

Built Distribution

spotipy2-0.2-py3-none-any.whl (11.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page