diff options
| -rw-r--r-- | .gitignore | 1 | ||||
| -rw-r--r-- | python-tiktokapi.spec | 708 | ||||
| -rw-r--r-- | sources | 1 |
3 files changed, 710 insertions, 0 deletions
@@ -0,0 +1 @@ +/TikTokApi-5.2.2.tar.gz diff --git a/python-tiktokapi.spec b/python-tiktokapi.spec new file mode 100644 index 0000000..f249596 --- /dev/null +++ b/python-tiktokapi.spec @@ -0,0 +1,708 @@ +%global _empty_manifest_terminate_build 0 +Name: python-TikTokApi +Version: 5.2.2 +Release: 1 +Summary: The Unofficial TikTok API Wrapper in Python 3. +License: MIT +URL: https://github.com/davidteather/tiktok-api +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/a3/d7/422a5ef0a1caea158dc8ce5ead529c0940a340d8a0dacd84e41cfda2fee9/TikTokApi-5.2.2.tar.gz +BuildArch: noarch + + +%description + +# Unofficial TikTok API in Python + +This is an unofficial api wrapper for TikTok.com in python. With this api you are able to call most trending and fetch specific user information as well as much more. + + [](https://zenodo.org/badge/latestdoi/188710490) [](https://www.linkedin.com/in/davidteather/) [](https://github.com/sponsors/davidteather) [](https://github.com/davidteather/TikTok-Api/releases) [](https://github.com/davidteather/TikTok-Api/actions/workflows/package-test.yml) [](https://github.com/davidteather/TikTok-Api/blob/master/LICENSE) [](https://pypi.org/project/TikTokApi/)  [](https://discord.gg/yyPhbfma6f) + +## Sponsors +These sponsors have paid to be placed here and beyond that I do not have any affiliation with them, the TikTokAPI package will always be free and open-source. If you wish to be a sponsor of this project check out my [GitHub sponsors page](https://github.com/sponsors/davidteather). + +<div align="center"> + <p> + <a href="https://tikapi.io/?ref=davidteather" target="_blank"> + <div> + <img src="https://raw.githubusercontent.com/davidteather/TikTok-Api/master/imgs/tikapi.png" width="100" alt="TikApi"> + </div> + <b></b> + <div> + <b>TikAPI</b> is a paid TikTok API service providing a full out-of-the-box solution, making life easier for developers — trusted by 500+ companies. + </div> + </a> + </p> +</div> + +<br> + +<div align="center"> + <p> + <a href="https://trendpop.social/?ref=github-davidteather-tiktokapi" target="_blank"> + <div> + <img src="https://raw.githubusercontent.com/davidteather/TikTok-Api/master/imgs/trendpop.png" width="100" alt="Trendpop"> + </div> + <div> + Trendpop builds software to help creators and businesses go viral on social video platforms. + </div> + <div> + <sub> + Excited about building in this space? + <a href="https://trendpop.social/careers?ref=github-davidteather-tiktokapi"> + <sub>We're hiring engineers across all roles</sub> + </a> + <a href="https://trendpop.social/careers?ref=github-davidteather-tiktokapi" target="_blank"> + <sub>- shoot us a message at </sub> + </a> + <a href="mailto:founders@trendpop.social" target="_blank"> + <sub><code>founders@trendpop.social</code></sub> + </a> + </sub> + </div> + </a> + </p> +</div> + +<br> + +<div align="center"> + <p> + <a href="https://influencerhunters.com/docs.html?utm_source=github&utm_medium=githubpage&utm_campaign=david_thea_github&utm_id=david_t" target="_blank"> + <div> + <img src="https://raw.githubusercontent.com/andrearama/TikTok-Api/master/imgs/IH_LOGO.png" width="100" alt="IH_logo"> + </div> + <b></b> + <div> + TikTok data through APIs, providing 10+ Million posts / day to the largest Marketing and Social listening platforms. + </div> + </a> + </p> +</div> + +## Table of Contents +- [Documentation](#documentation) +- [Getting Started](#getting-started) + - [How to Support The Project](#how-to-support-the-project) + - [Installing](#installing) + - [Common Issues](#common-issues) +- [Quick Start Guide](#quick-start-guide) + - [Examples](https://github.com/davidteather/TikTok-Api/tree/master/examples) + +[**Upgrading from V4 to V5**](#upgrading-from-v4-to-v5) + +## Documentation + +You can find the full documentation [here](https://davidteather.github.io/TikTok-Api/docs/TikTokApi.html), the [TikTokApi Class](https://davidteather.github.io/TikTok-Api/docs/TikTokApi/tiktok.html) is where you'll probably spend most of your time. +## Getting Started + +To get started using this api follow the instructions below. + +**Note:** If you want to learn how to web scrape websites check my [free and open-source course for web scraping](https://github.com/davidteather/web-scraping-with-reverse-engineering) + +### How to Support The Project +* Star the repo 😎 +* Consider [sponsoring](https://github.com/sponsors/davidteather) me on GitHub +* Send me an email or a [LinkedIn](https://www.linkedin.com/in/davidteather/) message telling me what you're using the API for, I really like hearing what people are using it for. +* Submit PRs for issues :) + +### Installing + +If you run into an issue please check the closed issues on the github, although feel free to re-open a new issue if you find an issue that's been closed for a few months. The codebase can and does run into similar issues as it has before, because TikTok changes things up. + +```sh +pip install TikTokApi +python -m playwright install +``` +If you would prefer a video walk through of setting up this package [YouTube video](https://www.youtube.com/watch?v=-uCt1x8kINQ) just for that. + +If you want a quick video to listen for [TikTok Live](https://www.youtube.com/watch?v=307ijmA3_lc) events in python. + +#### Docker Installation + +Clone this repository onto a local machine (or just the Dockerfile since it installs TikTokApi from pip) then run the following commands. + +```sh +docker pull mcr.microsoft.com/playwright:focal +docker build . -t tiktokapi:latest +docker run -v TikTokApi --rm tiktokapi:latest python3 your_script.py +``` + +**Note** this assumes your script is named your_script.py and lives in the root of this directory. + +### Common Issues + +Please don't open an issue if you're experiencing one of these just comment if the provided solution do not work for you. + +* **Browser Has no Attribute** - make sure you ran `python3 -m playwright install`, if your error persists try the [playwright-python](https://github.com/microsoft/playwright-python) quickstart guide and diagnose issues from there. + +## Quick Start Guide + +Here's a quick bit of code to get the most recent trending videos on TikTok. There's more examples in the [examples](https://github.com/davidteather/TikTok-Api/tree/master/examples) directory. + +**Note:** If you want to learn how to web scrape websites check my [free and open-source course for web scraping](https://github.com/davidteather/web-scraping-with-reverse-engineering) + +```py +from TikTokApi import TikTokApi + +# Watch https://www.youtube.com/watch?v=-uCt1x8kINQ for a brief setup tutorial +with TikTokApi() as api: + for trending_video in api.trending.videos(count=50): + # Prints the author's username of the trending video. + print(trending_video.author.username) +``` + +**Note**: Jupyter (ipynb) only works on linux, see [microsoft/playwright-python #178](https://github.com/microsoft/playwright-python/issues/178) + +To run the example scripts from the repository root, make sure you use the `-m` option on python. +```sh +python -m examples.get_trending +``` + +You can access the dictionary type of an object using `.as_dict`. On a video this may look like +[this](https://gist.github.com/davidteather/7c30780bbc30772ba11ec9e0b909e99d), although TikTok changes their structure from time to time so it's worth investigating the structure of the dictionary when you use this package. + +## Upgrading from V4 to V5 + +All changes will be noted on [#803](https://github.com/davidteather/TikTok-Api/pull/803) if you want more information. + +### Motivation + +This package has been difficult to maintain due to it's structure, difficult to work with since the user of the package must write parsing methods to extract information from dictionaries, more memory intensive than it needs to be (although this can be further improved), and in general just difficult to work with for new users. + +As a result, I've decided to at least attempt to remedy some of these issues, the biggest changes are that +1. The package has shifted to using classes for different TikTok objects resulting in an easier, higher-level programming experience. +2. All methods that used to return a list of objects have been switched to using iterators, to hopefully decrease memory utilization for most users. + + +### Upgrading Examples + + +#### Accessing Dictionary on Objects (similar to V4) + +You'll probably need to use this beyond just for legacy support, since not all attributes are parsed out and attached +to the different objects. + +You may want to use this as a workaround for legacy applications while you upgrade the rest of the app. I'd suggest that you do eventually upgrade to using the higher-level approach fully. +```py +user = api.user(username='therock') +user.as_dict # -> dict of the user_object +for video in user.videos(): + video.as_dict # -> dict of TikTok's video object as found when requesting the videos endpoint +``` + +Here's a few more examples that help illustrate the differences in the flow of the usage of the package with V5. + +```py +# V4 +api = TikTokApi.get_instance() +trending_videos = api.by_trending() + +#V5.1 +with TikTokApi() as api: # .get_instance no longer exists + for trending_video in api.trending.videos(): + # do something +``` + +Where in V4 you had to extract information yourself, the package now handles that for you. So it's much easier to do chained related function calls. +```py +# V4 +trending_videos = api.by_trending() +for video in trending_videos: + # The dictionary responses are also different depending on what endpoint you got them from + # So, it's usually more painful than this to deal with + trending_user = api.get_user(id=video['author']['id'], secUid=video['author']['secUid']) + + +# V5 +# This is more complicated than above, but it illustrates the simplified approach +for trending_video in api.trending.videos(): + user_stats = trending_video.author.info_full['stats'] + if user_stats['followerCount'] >= 10000: + # maybe save the user in a database +``` + + + + +%package -n python3-TikTokApi +Summary: The Unofficial TikTok API Wrapper in Python 3. +Provides: python-TikTokApi +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-TikTokApi + +# Unofficial TikTok API in Python + +This is an unofficial api wrapper for TikTok.com in python. With this api you are able to call most trending and fetch specific user information as well as much more. + + [](https://zenodo.org/badge/latestdoi/188710490) [](https://www.linkedin.com/in/davidteather/) [](https://github.com/sponsors/davidteather) [](https://github.com/davidteather/TikTok-Api/releases) [](https://github.com/davidteather/TikTok-Api/actions/workflows/package-test.yml) [](https://github.com/davidteather/TikTok-Api/blob/master/LICENSE) [](https://pypi.org/project/TikTokApi/)  [](https://discord.gg/yyPhbfma6f) + +## Sponsors +These sponsors have paid to be placed here and beyond that I do not have any affiliation with them, the TikTokAPI package will always be free and open-source. If you wish to be a sponsor of this project check out my [GitHub sponsors page](https://github.com/sponsors/davidteather). + +<div align="center"> + <p> + <a href="https://tikapi.io/?ref=davidteather" target="_blank"> + <div> + <img src="https://raw.githubusercontent.com/davidteather/TikTok-Api/master/imgs/tikapi.png" width="100" alt="TikApi"> + </div> + <b></b> + <div> + <b>TikAPI</b> is a paid TikTok API service providing a full out-of-the-box solution, making life easier for developers — trusted by 500+ companies. + </div> + </a> + </p> +</div> + +<br> + +<div align="center"> + <p> + <a href="https://trendpop.social/?ref=github-davidteather-tiktokapi" target="_blank"> + <div> + <img src="https://raw.githubusercontent.com/davidteather/TikTok-Api/master/imgs/trendpop.png" width="100" alt="Trendpop"> + </div> + <div> + Trendpop builds software to help creators and businesses go viral on social video platforms. + </div> + <div> + <sub> + Excited about building in this space? + <a href="https://trendpop.social/careers?ref=github-davidteather-tiktokapi"> + <sub>We're hiring engineers across all roles</sub> + </a> + <a href="https://trendpop.social/careers?ref=github-davidteather-tiktokapi" target="_blank"> + <sub>- shoot us a message at </sub> + </a> + <a href="mailto:founders@trendpop.social" target="_blank"> + <sub><code>founders@trendpop.social</code></sub> + </a> + </sub> + </div> + </a> + </p> +</div> + +<br> + +<div align="center"> + <p> + <a href="https://influencerhunters.com/docs.html?utm_source=github&utm_medium=githubpage&utm_campaign=david_thea_github&utm_id=david_t" target="_blank"> + <div> + <img src="https://raw.githubusercontent.com/andrearama/TikTok-Api/master/imgs/IH_LOGO.png" width="100" alt="IH_logo"> + </div> + <b></b> + <div> + TikTok data through APIs, providing 10+ Million posts / day to the largest Marketing and Social listening platforms. + </div> + </a> + </p> +</div> + +## Table of Contents +- [Documentation](#documentation) +- [Getting Started](#getting-started) + - [How to Support The Project](#how-to-support-the-project) + - [Installing](#installing) + - [Common Issues](#common-issues) +- [Quick Start Guide](#quick-start-guide) + - [Examples](https://github.com/davidteather/TikTok-Api/tree/master/examples) + +[**Upgrading from V4 to V5**](#upgrading-from-v4-to-v5) + +## Documentation + +You can find the full documentation [here](https://davidteather.github.io/TikTok-Api/docs/TikTokApi.html), the [TikTokApi Class](https://davidteather.github.io/TikTok-Api/docs/TikTokApi/tiktok.html) is where you'll probably spend most of your time. +## Getting Started + +To get started using this api follow the instructions below. + +**Note:** If you want to learn how to web scrape websites check my [free and open-source course for web scraping](https://github.com/davidteather/web-scraping-with-reverse-engineering) + +### How to Support The Project +* Star the repo 😎 +* Consider [sponsoring](https://github.com/sponsors/davidteather) me on GitHub +* Send me an email or a [LinkedIn](https://www.linkedin.com/in/davidteather/) message telling me what you're using the API for, I really like hearing what people are using it for. +* Submit PRs for issues :) + +### Installing + +If you run into an issue please check the closed issues on the github, although feel free to re-open a new issue if you find an issue that's been closed for a few months. The codebase can and does run into similar issues as it has before, because TikTok changes things up. + +```sh +pip install TikTokApi +python -m playwright install +``` +If you would prefer a video walk through of setting up this package [YouTube video](https://www.youtube.com/watch?v=-uCt1x8kINQ) just for that. + +If you want a quick video to listen for [TikTok Live](https://www.youtube.com/watch?v=307ijmA3_lc) events in python. + +#### Docker Installation + +Clone this repository onto a local machine (or just the Dockerfile since it installs TikTokApi from pip) then run the following commands. + +```sh +docker pull mcr.microsoft.com/playwright:focal +docker build . -t tiktokapi:latest +docker run -v TikTokApi --rm tiktokapi:latest python3 your_script.py +``` + +**Note** this assumes your script is named your_script.py and lives in the root of this directory. + +### Common Issues + +Please don't open an issue if you're experiencing one of these just comment if the provided solution do not work for you. + +* **Browser Has no Attribute** - make sure you ran `python3 -m playwright install`, if your error persists try the [playwright-python](https://github.com/microsoft/playwright-python) quickstart guide and diagnose issues from there. + +## Quick Start Guide + +Here's a quick bit of code to get the most recent trending videos on TikTok. There's more examples in the [examples](https://github.com/davidteather/TikTok-Api/tree/master/examples) directory. + +**Note:** If you want to learn how to web scrape websites check my [free and open-source course for web scraping](https://github.com/davidteather/web-scraping-with-reverse-engineering) + +```py +from TikTokApi import TikTokApi + +# Watch https://www.youtube.com/watch?v=-uCt1x8kINQ for a brief setup tutorial +with TikTokApi() as api: + for trending_video in api.trending.videos(count=50): + # Prints the author's username of the trending video. + print(trending_video.author.username) +``` + +**Note**: Jupyter (ipynb) only works on linux, see [microsoft/playwright-python #178](https://github.com/microsoft/playwright-python/issues/178) + +To run the example scripts from the repository root, make sure you use the `-m` option on python. +```sh +python -m examples.get_trending +``` + +You can access the dictionary type of an object using `.as_dict`. On a video this may look like +[this](https://gist.github.com/davidteather/7c30780bbc30772ba11ec9e0b909e99d), although TikTok changes their structure from time to time so it's worth investigating the structure of the dictionary when you use this package. + +## Upgrading from V4 to V5 + +All changes will be noted on [#803](https://github.com/davidteather/TikTok-Api/pull/803) if you want more information. + +### Motivation + +This package has been difficult to maintain due to it's structure, difficult to work with since the user of the package must write parsing methods to extract information from dictionaries, more memory intensive than it needs to be (although this can be further improved), and in general just difficult to work with for new users. + +As a result, I've decided to at least attempt to remedy some of these issues, the biggest changes are that +1. The package has shifted to using classes for different TikTok objects resulting in an easier, higher-level programming experience. +2. All methods that used to return a list of objects have been switched to using iterators, to hopefully decrease memory utilization for most users. + + +### Upgrading Examples + + +#### Accessing Dictionary on Objects (similar to V4) + +You'll probably need to use this beyond just for legacy support, since not all attributes are parsed out and attached +to the different objects. + +You may want to use this as a workaround for legacy applications while you upgrade the rest of the app. I'd suggest that you do eventually upgrade to using the higher-level approach fully. +```py +user = api.user(username='therock') +user.as_dict # -> dict of the user_object +for video in user.videos(): + video.as_dict # -> dict of TikTok's video object as found when requesting the videos endpoint +``` + +Here's a few more examples that help illustrate the differences in the flow of the usage of the package with V5. + +```py +# V4 +api = TikTokApi.get_instance() +trending_videos = api.by_trending() + +#V5.1 +with TikTokApi() as api: # .get_instance no longer exists + for trending_video in api.trending.videos(): + # do something +``` + +Where in V4 you had to extract information yourself, the package now handles that for you. So it's much easier to do chained related function calls. +```py +# V4 +trending_videos = api.by_trending() +for video in trending_videos: + # The dictionary responses are also different depending on what endpoint you got them from + # So, it's usually more painful than this to deal with + trending_user = api.get_user(id=video['author']['id'], secUid=video['author']['secUid']) + + +# V5 +# This is more complicated than above, but it illustrates the simplified approach +for trending_video in api.trending.videos(): + user_stats = trending_video.author.info_full['stats'] + if user_stats['followerCount'] >= 10000: + # maybe save the user in a database +``` + + + + +%package help +Summary: Development documents and examples for TikTokApi +Provides: python3-TikTokApi-doc +%description help + +# Unofficial TikTok API in Python + +This is an unofficial api wrapper for TikTok.com in python. With this api you are able to call most trending and fetch specific user information as well as much more. + + [](https://zenodo.org/badge/latestdoi/188710490) [](https://www.linkedin.com/in/davidteather/) [](https://github.com/sponsors/davidteather) [](https://github.com/davidteather/TikTok-Api/releases) [](https://github.com/davidteather/TikTok-Api/actions/workflows/package-test.yml) [](https://github.com/davidteather/TikTok-Api/blob/master/LICENSE) [](https://pypi.org/project/TikTokApi/)  [](https://discord.gg/yyPhbfma6f) + +## Sponsors +These sponsors have paid to be placed here and beyond that I do not have any affiliation with them, the TikTokAPI package will always be free and open-source. If you wish to be a sponsor of this project check out my [GitHub sponsors page](https://github.com/sponsors/davidteather). + +<div align="center"> + <p> + <a href="https://tikapi.io/?ref=davidteather" target="_blank"> + <div> + <img src="https://raw.githubusercontent.com/davidteather/TikTok-Api/master/imgs/tikapi.png" width="100" alt="TikApi"> + </div> + <b></b> + <div> + <b>TikAPI</b> is a paid TikTok API service providing a full out-of-the-box solution, making life easier for developers — trusted by 500+ companies. + </div> + </a> + </p> +</div> + +<br> + +<div align="center"> + <p> + <a href="https://trendpop.social/?ref=github-davidteather-tiktokapi" target="_blank"> + <div> + <img src="https://raw.githubusercontent.com/davidteather/TikTok-Api/master/imgs/trendpop.png" width="100" alt="Trendpop"> + </div> + <div> + Trendpop builds software to help creators and businesses go viral on social video platforms. + </div> + <div> + <sub> + Excited about building in this space? + <a href="https://trendpop.social/careers?ref=github-davidteather-tiktokapi"> + <sub>We're hiring engineers across all roles</sub> + </a> + <a href="https://trendpop.social/careers?ref=github-davidteather-tiktokapi" target="_blank"> + <sub>- shoot us a message at </sub> + </a> + <a href="mailto:founders@trendpop.social" target="_blank"> + <sub><code>founders@trendpop.social</code></sub> + </a> + </sub> + </div> + </a> + </p> +</div> + +<br> + +<div align="center"> + <p> + <a href="https://influencerhunters.com/docs.html?utm_source=github&utm_medium=githubpage&utm_campaign=david_thea_github&utm_id=david_t" target="_blank"> + <div> + <img src="https://raw.githubusercontent.com/andrearama/TikTok-Api/master/imgs/IH_LOGO.png" width="100" alt="IH_logo"> + </div> + <b></b> + <div> + TikTok data through APIs, providing 10+ Million posts / day to the largest Marketing and Social listening platforms. + </div> + </a> + </p> +</div> + +## Table of Contents +- [Documentation](#documentation) +- [Getting Started](#getting-started) + - [How to Support The Project](#how-to-support-the-project) + - [Installing](#installing) + - [Common Issues](#common-issues) +- [Quick Start Guide](#quick-start-guide) + - [Examples](https://github.com/davidteather/TikTok-Api/tree/master/examples) + +[**Upgrading from V4 to V5**](#upgrading-from-v4-to-v5) + +## Documentation + +You can find the full documentation [here](https://davidteather.github.io/TikTok-Api/docs/TikTokApi.html), the [TikTokApi Class](https://davidteather.github.io/TikTok-Api/docs/TikTokApi/tiktok.html) is where you'll probably spend most of your time. +## Getting Started + +To get started using this api follow the instructions below. + +**Note:** If you want to learn how to web scrape websites check my [free and open-source course for web scraping](https://github.com/davidteather/web-scraping-with-reverse-engineering) + +### How to Support The Project +* Star the repo 😎 +* Consider [sponsoring](https://github.com/sponsors/davidteather) me on GitHub +* Send me an email or a [LinkedIn](https://www.linkedin.com/in/davidteather/) message telling me what you're using the API for, I really like hearing what people are using it for. +* Submit PRs for issues :) + +### Installing + +If you run into an issue please check the closed issues on the github, although feel free to re-open a new issue if you find an issue that's been closed for a few months. The codebase can and does run into similar issues as it has before, because TikTok changes things up. + +```sh +pip install TikTokApi +python -m playwright install +``` +If you would prefer a video walk through of setting up this package [YouTube video](https://www.youtube.com/watch?v=-uCt1x8kINQ) just for that. + +If you want a quick video to listen for [TikTok Live](https://www.youtube.com/watch?v=307ijmA3_lc) events in python. + +#### Docker Installation + +Clone this repository onto a local machine (or just the Dockerfile since it installs TikTokApi from pip) then run the following commands. + +```sh +docker pull mcr.microsoft.com/playwright:focal +docker build . -t tiktokapi:latest +docker run -v TikTokApi --rm tiktokapi:latest python3 your_script.py +``` + +**Note** this assumes your script is named your_script.py and lives in the root of this directory. + +### Common Issues + +Please don't open an issue if you're experiencing one of these just comment if the provided solution do not work for you. + +* **Browser Has no Attribute** - make sure you ran `python3 -m playwright install`, if your error persists try the [playwright-python](https://github.com/microsoft/playwright-python) quickstart guide and diagnose issues from there. + +## Quick Start Guide + +Here's a quick bit of code to get the most recent trending videos on TikTok. There's more examples in the [examples](https://github.com/davidteather/TikTok-Api/tree/master/examples) directory. + +**Note:** If you want to learn how to web scrape websites check my [free and open-source course for web scraping](https://github.com/davidteather/web-scraping-with-reverse-engineering) + +```py +from TikTokApi import TikTokApi + +# Watch https://www.youtube.com/watch?v=-uCt1x8kINQ for a brief setup tutorial +with TikTokApi() as api: + for trending_video in api.trending.videos(count=50): + # Prints the author's username of the trending video. + print(trending_video.author.username) +``` + +**Note**: Jupyter (ipynb) only works on linux, see [microsoft/playwright-python #178](https://github.com/microsoft/playwright-python/issues/178) + +To run the example scripts from the repository root, make sure you use the `-m` option on python. +```sh +python -m examples.get_trending +``` + +You can access the dictionary type of an object using `.as_dict`. On a video this may look like +[this](https://gist.github.com/davidteather/7c30780bbc30772ba11ec9e0b909e99d), although TikTok changes their structure from time to time so it's worth investigating the structure of the dictionary when you use this package. + +## Upgrading from V4 to V5 + +All changes will be noted on [#803](https://github.com/davidteather/TikTok-Api/pull/803) if you want more information. + +### Motivation + +This package has been difficult to maintain due to it's structure, difficult to work with since the user of the package must write parsing methods to extract information from dictionaries, more memory intensive than it needs to be (although this can be further improved), and in general just difficult to work with for new users. + +As a result, I've decided to at least attempt to remedy some of these issues, the biggest changes are that +1. The package has shifted to using classes for different TikTok objects resulting in an easier, higher-level programming experience. +2. All methods that used to return a list of objects have been switched to using iterators, to hopefully decrease memory utilization for most users. + + +### Upgrading Examples + + +#### Accessing Dictionary on Objects (similar to V4) + +You'll probably need to use this beyond just for legacy support, since not all attributes are parsed out and attached +to the different objects. + +You may want to use this as a workaround for legacy applications while you upgrade the rest of the app. I'd suggest that you do eventually upgrade to using the higher-level approach fully. +```py +user = api.user(username='therock') +user.as_dict # -> dict of the user_object +for video in user.videos(): + video.as_dict # -> dict of TikTok's video object as found when requesting the videos endpoint +``` + +Here's a few more examples that help illustrate the differences in the flow of the usage of the package with V5. + +```py +# V4 +api = TikTokApi.get_instance() +trending_videos = api.by_trending() + +#V5.1 +with TikTokApi() as api: # .get_instance no longer exists + for trending_video in api.trending.videos(): + # do something +``` + +Where in V4 you had to extract information yourself, the package now handles that for you. So it's much easier to do chained related function calls. +```py +# V4 +trending_videos = api.by_trending() +for video in trending_videos: + # The dictionary responses are also different depending on what endpoint you got them from + # So, it's usually more painful than this to deal with + trending_user = api.get_user(id=video['author']['id'], secUid=video['author']['secUid']) + + +# V5 +# This is more complicated than above, but it illustrates the simplified approach +for trending_video in api.trending.videos(): + user_stats = trending_video.author.info_full['stats'] + if user_stats['followerCount'] >= 10000: + # maybe save the user in a database +``` + + + + +%prep +%autosetup -n TikTokApi-5.2.2 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-TikTokApi -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Tue Apr 11 2023 Python_Bot <Python_Bot@openeuler.org> - 5.2.2-1 +- Package Spec generated @@ -0,0 +1 @@ +34bb6ab70e69c2bfd4ff5e28c4ee8eb3 TikTokApi-5.2.2.tar.gz |