{ "info": { "author": "Manolomon", "author_email": "contacto@manolomon.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Programming Language :: Python :: 3.8", "Topic :: Multimedia :: Sound/Audio :: Analysis", "Topic :: Scientific/Engineering :: Information Analysis", "Topic :: Software Development" ], "description": "# Spotichart\n\n![Badge](https://github.com/Manolomon/spotichart/workflows/spotichart/badge.svg) [![Documentation Status](https://readthedocs.org/projects/spotichart/badge/?version=latest)](https://spotichart.readthedocs.io/en/latest/?badge=latest) [![Codacy Badge](https://api.codacy.com/project/badge/Grade/67c312b4fdab4303a3be7516fad3d2a6)](https://www.codacy.com/manual/Manolomon/spotichart?utm_source=github.com&utm_medium=referral&utm_content=Manolomon/spotichart&utm_campaign=Badge_Grade)\n\nCollector Module for Spotify National Trending Analysis\n\n## Introduction\n\nThe Spotichart module makes it easy for data scientist and programmers get the features from the trending songs on Spotify. You can define period of time and a region and get the main characteristics of the top songs.\n\n## Documentation\n\nThe oficial documentations is available at: [Read The Docs](https://spotichart.readthedocs.io/en/latest/)\n\n## Installation\n\n```bash\n$ pip install spotichart\n```\n\n## Requirements\n\n - **Python** >= 3.6\n - **Spotify Web API Access Token**, you can request yours [here](https://developer.spotify.com/console/get-audio-features-track/) and click on `GET TOKEN`. Then copy the token on the `OAuth Token` field.\n - (Optional) **Genius Web API Access Token**. From [the official docs page](https://docs.genius.com/#/search-h2) you can just select `Authenticate wih the Docs App To Try`, and copy the `Authorization Bearer` provided after logging in.\n\n## Synopsis\n\n### Usage\n\nJust to get the audio features, given a date (or period) and a region\n\n```python\nimport spotichart\n\nspotify_token = 'YOUR-ACCESS-TOKEN-FROM-THE-WEB-API'\n\nchart = spotichart.generate_top_chart(spotify_token, start='2019-01-01', end='2019-10-13', region='mx')\n\n```\n\nTo additionally retrieve each song's lyrics, Genius ID an auto-detect the language, you can do as well:\n\n```python\nimport spotichart\n\nspotify_token = 'YOUR-SPOTIFY-ACCESS-TOKEN-FROM-THE-WEB-API'\ngenius_token = 'YOUR-GENIUS-ACCESS-TOKEN-FROM-THE-WEB-API'\n\nchart = spotichart.generate_top_chart(spotify_token, start='2019-01-01',\n end='2019-10-13', region='mx', sleep=0.5)\n\nchart_with_lyrics = spotichart.get_lyrics_from_chart(genius_token, chart, sleep=0.1)\n```\n\n**Note:** Since these functions imply web requests to get the data, the `sleep` parameter is meant to make the algorithm rest and avoid the server to refuse the requests. By default `sleep` is set to 1 second.\n\n### The DataFrame\n\nA `pandas.DataFrame` will be generated with the data of interest:\n\n```python\n>>> chart\n Position Track Name Artist Streams ... speechiness tempo time_signature valence\n0 1 Calma - Remix Pedro Cap\u00f3 737894 ... 0.0524 126.899 4 0.761\n1 2 Adan y Eva Paulo Londra 415066 ... 0.3360 171.993 4 0.720\n2 3 Taki Taki (with Selena Gomez, Ozuna & Cardi B) DJ Snake 409061 ... 0.2290 95.948 4 0.591\n3 4 MIA (feat. Drake) Bad Bunny 377855 ... 0.0621 97.062 4 0.158\n4 5 A Trav\u00e9s Del Vaso Grupo Arranke 346975 ... 0.0297 143.851 3 0.920\n... ... ... ... ... ... ... ... ... ...\n14295 46 Con Calma Daddy Yankee 141397 ... 0.0593 93.989 4 0.656\n14296 47 La Escuela No Me Gust\u00f3 Adriel Favela 139350 ... 0.0371 112.548 4 0.844\n14297 48 De Los Besos Que Te Di Christian Nodal 139294 ... 0.0422 195.593 4 0.709\n14298 49 Pa M\u00ed - Remix Dalex 137812 ... 0.2200 170.018 4 0.727\n14299 50 Circles Post Malone 131109 ... 0.0395 120.042 4 0.5\n\n[14300 rows x 20 columns]\n```\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/larsi-uv/spotichart", "keywords": "", "license": "License :: OSI Approved :: MIT License", "maintainer": "Manolomon", "maintainer_email": "contacto@manolomon.com", "name": "spotichart", "package_url": "https://pypi.org/project/spotichart/", "platform": "", "project_url": "https://pypi.org/project/spotichart/", "project_urls": { "Homepage": "https://github.com/larsi-uv/spotichart" }, "release_url": "https://pypi.org/project/spotichart/1.0.0/", "requires_dist": [ "beautifulsoup4 (==4.8.1)", "bs4 (==0.0.1)", "certifi (==2019.9.11)", "chardet (==3.0.4)", "guess-language-spirit (==0.5.3)", "idna (==2.8)", "numpy (==1.17.3)", "pandas (==0.25.2)", "python-dateutil (==2.8.0)", "pytz (==2019.3)", "requests (==2.22.0)", "six (==1.12.0)", "soupsieve (==1.9.4)", "tqdm (==4.36.1)", "urllib3 (==1.25.6)" ], "requires_python": ">=3.6", "summary": "Collector Module for Spotify National Trending Analysis", "version": "1.0.0", "yanked": false, "yanked_reason": null }, "last_serial": 6149065, "releases": { "0.6.0": [ { "comment_text": "", "digests": { "md5": "8ad31142a36d636bb007b3f29366ff40", "sha256": "6d75a914f475909c3208320bbc737e30fdb860b8f73c00ed3861e2733b2fb35c" }, "downloads": -1, "filename": "spotichart-0.6.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "8ad31142a36d636bb007b3f29366ff40", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": ">=3.6", "size": 12841, "upload_time": "2019-10-21T16:31:10", "upload_time_iso_8601": "2019-10-21T16:31:10.842780Z", "url": "https://files.pythonhosted.org/packages/6a/b7/97a786064ed0f14878c2ef00fbcb8735ce6aced10343b4966fc9d1b38290/spotichart-0.6.0-py2.py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "md5": "43a26ed3f44861de3ba043d46a75bb77", "sha256": "8c200fead87f844c2c259ac8c7817c3b3ec86f72c5c173c69a47b3058718a2c6" }, "downloads": -1, "filename": "spotichart-0.6.0.tar.gz", "has_sig": false, "md5_digest": "43a26ed3f44861de3ba043d46a75bb77", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 10689, "upload_time": "2019-10-21T16:31:13", "upload_time_iso_8601": "2019-10-21T16:31:13.721110Z", "url": "https://files.pythonhosted.org/packages/58/f5/35d81a75ae1de1bb283d0b7323a865804a736e66605c0e6eac1e828276f3/spotichart-0.6.0.tar.gz", "yanked": false, "yanked_reason": null } ], "1.0.0": [ { "comment_text": "", "digests": { "md5": "b1eefe7651d0f986cd756b56a14f3a06", "sha256": "e344f2a365a3ab88c668853dce668fac738016586b831f3329ca6a9fed356d6c" }, "downloads": -1, "filename": "spotichart-1.0.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "b1eefe7651d0f986cd756b56a14f3a06", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": ">=3.6", "size": 12307, "upload_time": "2019-11-17T00:53:53", "upload_time_iso_8601": "2019-11-17T00:53:53.011447Z", "url": "https://files.pythonhosted.org/packages/cd/6e/660d424ce0de17650607f9428c84cc9a0eef6ebf42f665e9ce27e9cf4b2e/spotichart-1.0.0-py2.py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "md5": "2038b7ce0397f9d9166a20e4413f3fae", "sha256": "33f49a2c3e5087d0ae8242ab92f2fe4724c10228249ed5e93b9f034a653bf22a" }, "downloads": -1, "filename": "spotichart-1.0.0.tar.gz", "has_sig": false, "md5_digest": "2038b7ce0397f9d9166a20e4413f3fae", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 10238, "upload_time": "2019-11-17T00:53:54", "upload_time_iso_8601": "2019-11-17T00:53:54.267725Z", "url": "https://files.pythonhosted.org/packages/e2/61/6a9fc88af96f2e48cb6c1fd2e961f56ccba77fe871f7fe52308d94a1679d/spotichart-1.0.0.tar.gz", "yanked": false, "yanked_reason": null } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "b1eefe7651d0f986cd756b56a14f3a06", "sha256": "e344f2a365a3ab88c668853dce668fac738016586b831f3329ca6a9fed356d6c" }, "downloads": -1, "filename": "spotichart-1.0.0-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "b1eefe7651d0f986cd756b56a14f3a06", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": ">=3.6", "size": 12307, "upload_time": "2019-11-17T00:53:53", "upload_time_iso_8601": "2019-11-17T00:53:53.011447Z", "url": "https://files.pythonhosted.org/packages/cd/6e/660d424ce0de17650607f9428c84cc9a0eef6ebf42f665e9ce27e9cf4b2e/spotichart-1.0.0-py2.py3-none-any.whl", "yanked": false, "yanked_reason": null }, { "comment_text": "", "digests": { "md5": "2038b7ce0397f9d9166a20e4413f3fae", "sha256": "33f49a2c3e5087d0ae8242ab92f2fe4724c10228249ed5e93b9f034a653bf22a" }, "downloads": -1, "filename": "spotichart-1.0.0.tar.gz", "has_sig": false, "md5_digest": "2038b7ce0397f9d9166a20e4413f3fae", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 10238, "upload_time": "2019-11-17T00:53:54", "upload_time_iso_8601": "2019-11-17T00:53:54.267725Z", "url": "https://files.pythonhosted.org/packages/e2/61/6a9fc88af96f2e48cb6c1fd2e961f56ccba77fe871f7fe52308d94a1679d/spotichart-1.0.0.tar.gz", "yanked": false, "yanked_reason": null } ], "vulnerabilities": [] }