Skip to content

opt-nc/mobitag

Repository files navigation

📚 Mobitag

GitHub release (latest by date) GitHub Workflow Status GitHub go.mod Go version GitHub License GitHub Repo stars Powered By: GoReleaser Conventional Commits

Exemple d'utilisation

🔑 Prérequis

  • ✅ La clé d'API OPTNC_MOBITAGNC_API_KEY chargée dans la session

🚀 QuickStart

Pour installer :

  • Manuellement : Se rendre sur la page de releases et télécharger la version correspondant à votre système d'exploitation
  • Automatique : Installation via brew cf homebrew-tap
  1. Installer mobitag

Avec brew :

brew install opt-nc/homebrew-tap/mobitag

Ou tout simplement avec go :

go install github.com/opt-nc/mobitag-cli@latest
  1. Mettre à jour :
brew update && brew upgrade
mobitag version

🦥 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"

🕹️ Utiliser

Afficher l'aide :

mobitag

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

🗑️ Désinstaller

🍺 brew

brew uninstall opt-nc/homebrew-tap/mobitag
brew list | grep mobitag

🤓 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

🧑‍🤝‍🧑 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 pour but de :

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

🔖 Ressources