Skip to content

🇫🇷 ☎️ Un petit script Python 2 ou 3 pour s'envoyer des textos (messages SMS) via l'API de Free (uniquement pour cartes SIM Free)

License

Notifications You must be signed in to change notification settings

Naereen/FreeSMS.py

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🇫🇷 ☎️ FreeSMS.py

Un petit script Python 2 ou 3 pour s'envoyer des textos (messages SMS) en ligne de commande, via l'API de Free (ancien lien) (uniquement pour un téléphone avec une carte SIM Free).

Exemples

Usage simple

  1. Installer ce script,
  2. Configurer l'API SMS de Free, via votre espace client, et noter votre identifiant et clé d'accès à l'API,
  3. Lancer une première fois le script FreeSMS.py pour savoir comment stocker ces deux codes,
  4. Tester avec un exemple :
    FreeSMS.py "Lis cet article très intéressant plus tard : http://tryalgo.org/fr/2017/08/08/bellman/"
  5. Soyez tout content 👍 ! Et ajouter une petite étoile ⭐ à ce projet !

Cela va vous envoyer un texto contenant ce texte, si tout est bien configuré.

screenshots/example1.png

Aide

L'usage du script est le suivant :

FreeSMS.py --help|-h | -f file | body of the message
  • Sans argument, envoie un message de test, screenshots/example2.png

  • Avec -h ou --help, affiche l'aide,

  • Avec -f FILE, envoie le contenu de ce fichier (en plusieurs morceaux si besoin).

Aide détaillée

$ ./FreeSMS.py --help
Opening the hidden file '~/.smsapifreemobile_number.b64', read and decode (base64) and return its content...

FreeSMS.py --help|-h | -f file | body of the message

A simple Python script to send a text message to a Free Mobile phone.
The message should be smaller than 480 caracters.

Examples:
$ FreeSMS.py --help
Print this help message!

$ FreeSMS.py -f MyMessageFile.txt
Try to send the content of the file MyMessageFile.txt.

$ FreeSMS.py "I like using Python to send me SMS from my laptop -- and it's free thanks to Free !"
Will send a test message to your mobile phone.

Copyleft 2014-17 Lilian Besson (License MIT)
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND.

Usage automatisé ?

Mon script mymake.sh enrobe l'outil GNU make pour m'envoyer un texto quand une simulation est terminée (avec un texte différent selon un échec ou une réussite).

screenshots/example3.png

Suggestions

  • J'utilise des Makefile pour lancer mes simulations numériques sur un serveur de calcul, afin de me prévenir en cas d'erreur ou quand les calculs sont finis,
  • Par exemple, pour ces simulations,
  • Et avec un fichier .use_FreeSMS_for_mymake créé dans le HOME, l'option --FreeSMS est activé par défaut.

Cas d'échec

Le script est traduit en français et anglais, et il affiche des messages d'erreurs clairs selon les causes d'échec.


Installation

Manuellement ?

Facile ! Cloner ce dépôt, aller dans le dossier, et déplacer le script FreeSMS.py dans un autre dossier accessible dans votre $PATH.

Au premier lancement du script, il vous expliquera comment créer les fichiers privés nécessaires à l'utilisation de FreeSMS.py, et les stocke dans votre HOME (~) :

Les trois fichiers fournis en exemple ne sont, bien-sûr, pas valides, mais montre la forme qu'ils doivent avoir.

En résumé, exécuter ça :

cd /tmp/
git clone https://GitHub.com/Naereen/FreeSMS.py
cd FreeSMS.py/
cp FreeSMS.py /un/dossier/dans/votre/PATH  # exemple ~/.local/bin/
FreeSMS.py   # va vous aider à créer ~/.smsapifreemobile_number.b64  ~/.smsapifreemobile_password.b64  ~/.smsapifreemobile_user.b64

Si quelque chose ne fonctionne pas bien, merci de signaler un problème 👏 !

Avec pip ?

TODO: écrire un setup.py pour installer ça !

Vu son usage très restreint, ce projet ne sera pas distribué sur le dépôt de packet Pypi, mais il peut être installé directement depuis GitHub avec pip et cette commande :

sudo pip install git+https://github.com/Naereen/FreeSMS.py

Vérifiez que vous utilisez pip2 ou pip3 selon la version de Python pour laquelle vous voulez installer cet outil. (Python 3 est évidemment recommandé)

PyPI implementation


Comparaison à d'autres projets

  • https://github.com/bfontaine/freesms est un module et pas un script, qui fait en gros la même chose. L'avantage de son approche est de pouvoir être facilement utilisée par d'autres applications en Python, l'avantage de mon approche est d'être très facile à utiliser depuis un terminal et donc des scripts Bash (cf. cet exemple, mymake.sh).

  • ?


À propos 📓

Langage et version(s) ?

Python v2.7+ ou Python v3.1+ (version CPython).

📜 Licence ? GitHub licence

Ce script et cette documentation sont distribuées en accès libre selon les conditions de la licence MIT (cf le fichier LICENSE en anglais). © Lilian Besson, 2017-2021.

Merci à Thibault Groueix pour des tests et des commentaires utiles en juillet 2016 et novembre 2017.

Maintenance Demandez moi n'importe quoi ! Analytics

ForTheBadge uses-badges ForTheBadge uses-git

forthebadge made-with-python ForTheBadge built-with-swag

About

🇫🇷 ☎️ Un petit script Python 2 ou 3 pour s'envoyer des textos (messages SMS) via l'API de Free (uniquement pour cartes SIM Free)

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Packages

No packages published

Languages