deezer-oauth-cli


Namedeezer-oauth-cli JSON
Version 1.5.0 PyPI version JSON
download
home_pageNone
SummaryA small CLI to quickly obtain an API token for Deezer API.
upload_time2024-12-19 11:56:11
maintainerNone
docs_urlNone
authorNone
requires_python>=3.9
licenseMIT
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Deezer OAuth CLI

<p align="center">
  <a href="https://github.com/browniebroke/deezer-oauth-cli/actions/workflows/ci.yml?query=branch%3Amain">
    <img src="https://img.shields.io/github/actions/workflow/status/browniebroke/deezer-oauth-cli/ci.yml?branch=main&label=CI&logo=github&style=flat-square" alt="CI Status" >
  </a>
  <a href="https://codecov.io/gh/browniebroke/deezer-oauth-cli">
    <img src="https://img.shields.io/codecov/c/github/browniebroke/deezer-oauth-cli.svg?logo=codecov&logoColor=fff&style=flat-square" alt="Test coverage percentage">
  </a>
</p>
<p align="center">
  <a href="https://github.com/astral-sh/uv">
    <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json" alt="uv">
  </a>
  <a href="https://github.com/astral-sh/ruff">
    <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff">
  </a>
  <a href="https://github.com/pre-commit/pre-commit">
    <img src="https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white&style=flat-square" alt="pre-commit">
  </a>
</p>
<p align="center">
  <a href="https://pypi.org/project/deezer-oauth-cli/">
    <img src="https://img.shields.io/pypi/v/deezer-oauth-cli.svg?logo=python&logoColor=fff&style=flat-square" alt="PyPI Version">
  </a>
  <img src="https://img.shields.io/pypi/pyversions/deezer-oauth-cli.svg?style=flat-square&logo=python&amp;logoColor=fff" alt="Supported Python versions">
  <img src="https://img.shields.io/pypi/l/deezer-oauth-cli.svg?style=flat-square" alt="License">
</p>

---

**Source Code**: <a href="https://github.com/browniebroke/deezer-oauth-cli" target="_blank">https://github.com/browniebroke/deezer-oauth-cli</a>

---

A small CLI to quickly obtain an API token for the Deezer API.

Obtaining API token to develop API applications can be complicated and sometimes feel like a chicken and egg situation: it's hard to play with the API without a token, but it can be difficult to get a token without an application to do the OAuth flow.

Given the app ID and secret, this tool lets you quickly get an API token.

## Installation

Install this via pip (or your favourite package manager):

`pip install deezer-oauth-cli`

## Usage

Before starting to use this tool, you first need to declare your Deezer app in [their developer portal](https://developers.deezer.com). Create a new app with the following Redirect URL: `http://localhost:8080/oauth/return`.

Once created, Deezer will generate an application ID and secret key for you, that's the 2 parameters that you need to run this tool:

```shell
$ deezer-oauth APP_ID APP_SECRET
```

This will:

- Spin up a webserver in the background running at `http://localhost:8080`.
- Open your browser to grant authorisation access to your Deezer account.
- Redirect to a page showing the API token & expiry.
- Write the token to a `.env` file.

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

<!-- prettier-ignore-start -->
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
  <tbody>
    <tr>
      <td align="center"><a href="https://browniebroke.com/"><img src="https://avatars.githubusercontent.com/u/861044?v=4?s=80" width="80px;" alt="Bruno Alla"/><br /><sub><b>Bruno Alla</b></sub></a><br /><a href="https://github.com/browniebroke/deezer-oauth-cli/commits?author=browniebroke" title="Code">💻</a> <a href="#ideas-browniebroke" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/browniebroke/deezer-oauth-cli/commits?author=browniebroke" title="Documentation">📖</a></td>
      <td align="center"><a href="https://github.com/prndrbr"><img src="https://avatars.githubusercontent.com/u/96344856?v=4?s=80" width="80px;" alt="Pierre"/><br /><sub><b>Pierre</b></sub></a><br /><a href="https://github.com/browniebroke/deezer-oauth-cli/commits?author=prndrbr" title="Code">💻</a></td>
    </tr>
  </tbody>
</table>

<!-- markdownlint-restore -->
<!-- prettier-ignore-end -->

<!-- ALL-CONTRIBUTORS-LIST:END -->
<!-- prettier-ignore-end -->

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!

## Credits

This package was created with
[Cookiecutter](https://github.com/audreyr/cookiecutter) and the
[browniebroke/cookiecutter-pypackage](https://github.com/browniebroke/cookiecutter-pypackage)
project template.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "deezer-oauth-cli",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": null,
    "author": null,
    "author_email": "Bruno Alla <alla.brunoo@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/26/cb/e944f16f80e4b8bc0dd669b3ff2ccda57167075bc38e320a88f8e0514379/deezer_oauth_cli-1.5.0.tar.gz",
    "platform": null,
    "description": "# Deezer OAuth CLI\n\n<p align=\"center\">\n  <a href=\"https://github.com/browniebroke/deezer-oauth-cli/actions/workflows/ci.yml?query=branch%3Amain\">\n    <img src=\"https://img.shields.io/github/actions/workflow/status/browniebroke/deezer-oauth-cli/ci.yml?branch=main&label=CI&logo=github&style=flat-square\" alt=\"CI Status\" >\n  </a>\n  <a href=\"https://codecov.io/gh/browniebroke/deezer-oauth-cli\">\n    <img src=\"https://img.shields.io/codecov/c/github/browniebroke/deezer-oauth-cli.svg?logo=codecov&logoColor=fff&style=flat-square\" alt=\"Test coverage percentage\">\n  </a>\n</p>\n<p align=\"center\">\n  <a href=\"https://github.com/astral-sh/uv\">\n    <img src=\"https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json\" alt=\"uv\">\n  </a>\n  <a href=\"https://github.com/astral-sh/ruff\">\n    <img src=\"https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json\" alt=\"Ruff\">\n  </a>\n  <a href=\"https://github.com/pre-commit/pre-commit\">\n    <img src=\"https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white&style=flat-square\" alt=\"pre-commit\">\n  </a>\n</p>\n<p align=\"center\">\n  <a href=\"https://pypi.org/project/deezer-oauth-cli/\">\n    <img src=\"https://img.shields.io/pypi/v/deezer-oauth-cli.svg?logo=python&logoColor=fff&style=flat-square\" alt=\"PyPI Version\">\n  </a>\n  <img src=\"https://img.shields.io/pypi/pyversions/deezer-oauth-cli.svg?style=flat-square&logo=python&amp;logoColor=fff\" alt=\"Supported Python versions\">\n  <img src=\"https://img.shields.io/pypi/l/deezer-oauth-cli.svg?style=flat-square\" alt=\"License\">\n</p>\n\n---\n\n**Source Code**: <a href=\"https://github.com/browniebroke/deezer-oauth-cli\" target=\"_blank\">https://github.com/browniebroke/deezer-oauth-cli</a>\n\n---\n\nA small CLI to quickly obtain an API token for the Deezer API.\n\nObtaining API token to develop API applications can be complicated and sometimes feel like a chicken and egg situation: it's hard to play with the API without a token, but it can be difficult to get a token without an application to do the OAuth flow.\n\nGiven the app ID and secret, this tool lets you quickly get an API token.\n\n## Installation\n\nInstall this via pip (or your favourite package manager):\n\n`pip install deezer-oauth-cli`\n\n## Usage\n\nBefore starting to use this tool, you first need to declare your Deezer app in [their developer portal](https://developers.deezer.com). Create a new app with the following Redirect URL: `http://localhost:8080/oauth/return`.\n\nOnce created, Deezer will generate an application ID and secret key for you, that's the 2 parameters that you need to run this tool:\n\n```shell\n$ deezer-oauth APP_ID APP_SECRET\n```\n\nThis will:\n\n- Spin up a webserver in the background running at `http://localhost:8080`.\n- Open your browser to grant authorisation access to your Deezer account.\n- Redirect to a page showing the API token & expiry.\n- Write the token to a `.env` file.\n\n## Contributors \u2728\n\nThanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):\n\n<!-- prettier-ignore-start -->\n<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->\n<!-- prettier-ignore-start -->\n<!-- markdownlint-disable -->\n<table>\n  <tbody>\n    <tr>\n      <td align=\"center\"><a href=\"https://browniebroke.com/\"><img src=\"https://avatars.githubusercontent.com/u/861044?v=4?s=80\" width=\"80px;\" alt=\"Bruno Alla\"/><br /><sub><b>Bruno Alla</b></sub></a><br /><a href=\"https://github.com/browniebroke/deezer-oauth-cli/commits?author=browniebroke\" title=\"Code\">\ud83d\udcbb</a> <a href=\"#ideas-browniebroke\" title=\"Ideas, Planning, & Feedback\">\ud83e\udd14</a> <a href=\"https://github.com/browniebroke/deezer-oauth-cli/commits?author=browniebroke\" title=\"Documentation\">\ud83d\udcd6</a></td>\n      <td align=\"center\"><a href=\"https://github.com/prndrbr\"><img src=\"https://avatars.githubusercontent.com/u/96344856?v=4?s=80\" width=\"80px;\" alt=\"Pierre\"/><br /><sub><b>Pierre</b></sub></a><br /><a href=\"https://github.com/browniebroke/deezer-oauth-cli/commits?author=prndrbr\" title=\"Code\">\ud83d\udcbb</a></td>\n    </tr>\n  </tbody>\n</table>\n\n<!-- markdownlint-restore -->\n<!-- prettier-ignore-end -->\n\n<!-- ALL-CONTRIBUTORS-LIST:END -->\n<!-- prettier-ignore-end -->\n\nThis project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!\n\n## Credits\n\nThis package was created with\n[Cookiecutter](https://github.com/audreyr/cookiecutter) and the\n[browniebroke/cookiecutter-pypackage](https://github.com/browniebroke/cookiecutter-pypackage)\nproject template.\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A small CLI to quickly obtain an API token for Deezer API.",
    "version": "1.5.0",
    "project_urls": {
        "Bug Tracker": "https://github.com/browniebroke/deezer-oauth-cli/issues",
        "Changelog": "https://github.com/browniebroke/deezer-oauth-cli/blob/main/CHANGELOG.md",
        "Mastodon": "https://fosstodon.org/@browniebroke",
        "Twitter": "https://twitter.com/_BrunoAlla",
        "documentation": "https://github.com/browniebroke/deezer-oauth-cli/blob/main/README.md",
        "repository": "https://github.com/browniebroke/deezer-oauth-cli"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "65c72e15ab8ffd5bf4738c3f0fd31ff41292a43f480b983b1868a59f42fea194",
                "md5": "3bb6eee3cb209a8388293eba0f6df6e4",
                "sha256": "4fc9cd503d7d9f7308079bf4e736bc91f2df5f058747581919147d7bd4f23577"
            },
            "downloads": -1,
            "filename": "deezer_oauth_cli-1.5.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "3bb6eee3cb209a8388293eba0f6df6e4",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 8692,
            "upload_time": "2024-12-19T11:56:10",
            "upload_time_iso_8601": "2024-12-19T11:56:10.250448Z",
            "url": "https://files.pythonhosted.org/packages/65/c7/2e15ab8ffd5bf4738c3f0fd31ff41292a43f480b983b1868a59f42fea194/deezer_oauth_cli-1.5.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "26cbe944f16f80e4b8bc0dd669b3ff2ccda57167075bc38e320a88f8e0514379",
                "md5": "f480be5a49577854cce92df8046020cb",
                "sha256": "285953c6d22f81a587f5bf63370d1135f2f5d5f8bd149921665f210fc6bba23a"
            },
            "downloads": -1,
            "filename": "deezer_oauth_cli-1.5.0.tar.gz",
            "has_sig": false,
            "md5_digest": "f480be5a49577854cce92df8046020cb",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 12020,
            "upload_time": "2024-12-19T11:56:11",
            "upload_time_iso_8601": "2024-12-19T11:56:11.763574Z",
            "url": "https://files.pythonhosted.org/packages/26/cb/e944f16f80e4b8bc0dd669b3ff2ccda57167075bc38e320a88f8e0514379/deezer_oauth_cli-1.5.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-12-19 11:56:11",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "browniebroke",
    "github_project": "deezer-oauth-cli",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "deezer-oauth-cli"
}
        
Elapsed time: 0.37040s