Content-Convertor
Content-Convertor est un package python permettant de convertir des tweets en fichiers png prêts à être postés sur Instagram.
Installation
Pour l'installer, il suffit de lancer la commande : pip install contentconvertor
.
Utilisation
Importez le package avec le code suivant :
from contentconvertor import tweet2gram as t2g
Ce package comprends différentes fonctions.
1. Se connecter à l'API de Twitter
connexion_to_api
: permet de se connecter à l'API de Twitter. Il faut pour cela rentrer les clés d'API et les tokens d'accès. Pour les obtenir, il faut créer une application sur le site de Twitter.
Liste des paramètres dans l'ordre
-
bearer_token
: clé d'API (Bearer Token)
Retourne la connexion à l'API de Twitter
- Code d'exemple :
api = t2g.connexion_to_api(bearer_token="")
2. Récupérer l'ID de l'utilisateur
get_user_id
: permet de récupérer l'id d'un utilisateur. Il faut pour cela rentrer le nom de l'utilisateur.
Liste des paramètres dans l'ordre
-
api
: connexion à l'API de Twitter (obtenue avec la fonctionconnexion_to_api
) -
username
: nom de l'utilisateur (sans le @)
Retourne l'id de l'utilisateur
- Code d'exemple :
user_id = t2g.get_user_id(api, "iziatask")
3. Récupérer les tweets
get_tweets
: permet de récupérer les tweets d'un utilisateur. Il faut pour cela rentrer le nom de l'utilisateur et le nombre de tweets à récupérer.
Liste des paramètres dans l'ordre
- Obligatoire :
-
api
: connexion à l'API de Twitter (obtenue avec la fonctionconnexion_to_api
) -
user_id
: ID de l'utilisateur (obtenu avec la fonctionget_user_id
)
-
- Optionnel :
-
nb_tweets
: nombre de tweets à récupérer (par défaut : 5) -
exclude
: exclure les tweets de type "replies" ou "retweets" (par défaut : None)
-
Retourne une liste de tweets
- Code d'exemple :
- Minimum requis
list_tweets = t2g.get_tweets(api, user_id)
- Avec tous les paramètres
list_tweets = t2g.get_tweets(api, user_id, nb_tweets=5, exclude=["replies", "retweets"])
4. Télécharger les tweets
download_tweets
:
- permet de télécharger au format png les tweets d'un utilisateur.
- permet de télécharger au format png un tweet en particulier.
Liste des paramètres dans l'ordre
- Obligatoire :
-
user
: utilisateur -
tweet
: (itérer sur la liste obtenue avec la fonctionget_tweets
) ou -
link
: lien du tweet
-
- Optionnel :
-
path
: chemin où télécharger les tweets (par défaut : "") -
name
: nom du fichier (par défaut : "tweet") -
mode
: mode de capture d'écran (par défaut : 0) -
nigh_mode
: mode nuit (par défaut : 2)
-
Retourne rien, vous aurez vos tweets téléchargés au format png, à l'endroit où vous avez lancé votre script.
- Code d'exemple :
- Avec la liste de tweets obtenue avec la fonction
get_tweets
- Minimum requis
for tweet in list_tweets.data: t2g.download_tweets(user, tweet)
- Avec tous les paramètres
for tweet in list_tweets.data: t2g.download_tweets(user, tweets, path="images/", name="screenshot", mode=0, nigh_mode=2)
- Avec le lien du tweet
- Minimum requis
t2g.download_tweets(user, link="https://twitter.com/iziatask/status/1606364038195093504")
- Avec tous les paramètres
t2g.download_tweets(user, link="https://twitter.com/iziatask/status/1606364038195093504", path="images/", name="screenshot", mode=0, nigh_mode=2)
Exemple d'utilisation
Pour voir un exemple d'utilisation complet, rendez-vous ici : GitHub.