Skip to content

opt-nc/mobitag-cli

Repository files navigation

🔑 Prérequis

  • Une clé d'API, chargée dans l'environnement OPTNC_MOBITAGNC_API_KEY

🚀 QuickStart

Pour installer :

  • Manuellement : Se rendre sur la page de releases et télécharger la version correspondant à votre système d'exploitation
  • Automatique : A venir via brew cf mobitag-cli/issues/8

🕹️ Utiliser

Une fois le binaire dans votre PATH, vous pouvez lancer la commande mobitag dans votre terminal:

# Afficher l'aide
mobitag -h
# Tester l'environnement afin de vérifier la présence de la clé API
mobitag dryRun
# Envoyer un `mobit@g`
mobitag send --to xxxxxx --message "Hello World : a mobit@g from Go(lang) XD"

# En indiquant également le numéro de l'expéditeur
mobitag send --to xxxxxx --message "Hello World : a mobit@g from Go(lang) XD" --from yyyyyy

🤓 Cool oneliners

Depuis le terminal, les oneliners sont super cools : en une commande concise exécutée en une seule ligne dans un terminal ou un script cela permet d’accomplir des tâches rapidement et efficacement, sans avoir à écrire un programme complet.

Gestion du pipe avec la commande sendPipe

"Hey I don't have to do anything here except glue together things that somebody else did for me already" - Brian Kernighan (see short)

# Exemple avec la commande `whoami`
echo "Hello c'est $(whoami) : alors on se le fait ce café ?" |\
    mobitag sendPipe --to $DIDI_MOBILE

㊙️ Envoyer un fichier ou des secrets avec privatebin

privatebin est...

a minimalist, open source online pastebin where the server has zero knowledge of pasted data.

On va ici l'utiliser pour envoyer des fichiers directement par sms depuis le terminal.

  1. Disposer d'une instance à soi ou en choisir une sur privatebin.info/directory/
  2. Créer le fichier de conf ~/.config/privatebin/config.json
  3. Télécharger et installer gearnode/privatebin
  4. Profiter

🐮 Un petit coup de cowsay

Avec cowsay:

cowsay -f tux "Mobitag c'est VACHEMENT cool...surtout depuis le terminal et pipé avec privatebin"\
    | privatebin create\
    | mobitag sendPipe --to $MOBILIS_DEST

🔐 Communiquer un fichier de secrets

cat secrets.txt\
    | privatebin create\
    | mobitag sendPipe --to $MOBILIS_DEST

📚 Exemples en vidéo

Exemple d'utilisation

🦥 Autocomplétion

Pour une UX optimale dans le terminal, il est possible d'activer l'autocomplétion :

# Pour avoir plus d'informations sur l'autocompletion :
mobitag completion <shell> --help

# <shell> peut être bash, zsh, fish, powershell.

Sous zsh :

# Pour activer l'autocompletion dans le shell courant
source <(mobitag completion zsh)
# Pour installer l'autocompletion de manière permanente
mobitag completion zsh > "${fpath[1]}/_mobitag"

🧑‍🤝‍🧑 Equipe

Ce projet d'innovation frugale n'aurait pas vu le jour sans une équipe, par ordre d'entré sur le projet :

  1. Michèle BARRE, aka. @mbarre : backend dev et UX bêta-testeuse
  2. Adrien SALES, aka. @adriens/ : Premier proto Go, Story Teller, Product Owner et alpha testeur
  3. Vinh FAUCHER aka. @supervinh/ : Core Go dev
  4. Romain PELIZZO aka. @Draks898 : Bêta-testeur
  5. 📊 Liste exhaustive des contributeurs

📖 Histoire de ce cli

Cette repo était à l'origine une première expérimentation dont le but était de découvrir le language Go, sur un cas concret car... c'est plus amusant et beaucoup plus motivant 🤓.

Cette expérimentation avait donc pur but de :

créer un cli permettant d'envoyer des mobitags depuis le terminal.

🔖 Ressources