From 708a6f22b079ccc227617637a4f540ce7a8e2975 Mon Sep 17 00:00:00 2001 From: Julien Palard Date: Tue, 25 Apr 2023 22:00:00 +0200 Subject: [PATCH] Proofreading using.fr.md --- using.fr.md | 52 ++++++++++++++++++++++++++++++++-------------------- 1 file changed, 32 insertions(+), 20 deletions(-) diff --git a/using.fr.md b/using.fr.md index 2fde635..5eecee4 100644 --- a/using.fr.md +++ b/using.fr.md @@ -1,6 +1,6 @@ -# Paf'Py +# Paf’Py -Et PAF ! +Et PAF ! ## TL;DR @@ -13,7 +13,7 @@ paf() } ``` -Cette fonction permet d'envoyer un fichier : +Cette fonction permet d’envoyer un fichier : ```bash $ paf manage.py @@ -34,16 +34,27 @@ $ paf *.py ``` -## Utilisation avec curl +## Le projet -En utilisant des requêtes `multipart/form-data` il est possible d'envoyer un fichier : +Pasteque est un projet libre et open-source développé par Alexandre +Henriet en 2013 sous licence MIT puis repris par Julien Palard en 2018 pour +https://wyz.fr et enfin par l’AFPy en 2023 pour https://p.afpy.org. + +Le code source est disponible ici : https://git.afpy.org/AFPy/pasteque + + +## Utilisation avec `curl` + +Tous les exemples sont rédigés avec `curl`, libre à vous d’adapter à votre usage. + +En utilisant des requêtes `multipart/form-data` il est possible d’envoyer un fichier : ```bash $ curl https://p.afpy.org/ -Fmanage.py=@manage.py - https://p.afpy.org/TaPa/manage.py ``` -ou plusieurs fichiers en même temps : +ou plusieurs fichiers en même temps : ```bash $ curl https://p.afpy.org/ -Fmanage.py=@manage.py -Frequirements.txt=@requirements.txt @@ -51,29 +62,29 @@ $ curl https://p.afpy.org/ -Fmanage.py=@manage.py -Frequirements.txt=@requiremen - https://p.afpy.org/Nz2o/requirements.txt ``` -C'est l'extension dans le nom du fichier qui permet de choisir la +C’est l’extension dans le nom du fichier qui permet de choisir la coloration syntaxique pour chaque fichier. -### Envoyer dans le corps d'une requête +### Envoyer dans le corps d’une requête -Il est possible de coller un unique fichier via le corps d'une requête POST : +Il est possible de coller un unique fichier via le corps d’une requête POST : ```bash $ cal | curl -XPOST --data-binary @- https://p.afpy.org/ - https://p.afpy.org/mo8X ``` -Dans ce cas, il est possible de choisir la coloration syntaxique via l'entête `Content-Type` : +Dans ce cas, il est possible de choisir la coloration syntaxique via l’entête `Content-Type` : ```bash $ cal | curl -XPOST -H "Content-Type: text/plain" --data-binary @- https://p.afpy.org/ - https://p.afpy.org/i3Y2/request.txt ``` -### Choisir l'URL +### Choisir l’URL -Il est possible d'utiliser la méthode `PUT` sur une `URL` : +Il est possible d’utiliser la méthode `PUT` sur une `URL` : ```bash $ cal | curl -XPUT --data-binary @- https://p.afpy.org/cal @@ -88,7 +99,7 @@ $ curl -XPUT --data-binary @manage.py https://p.afpy.org/manage.py ### Écraser un paste existant -Lors du premier envoi d'un paste, vous pouvez lui affecter un secret via l'entête HTTP `Authorization` : +Lors du premier envoi d’un paste, vous pouvez lui affecter un secret via l’entête HTTP `Authorization` : ```bash $ date | curl -XPUT --data-binary @- -H "Authorization: Secret supersecret" https://p.afpy.org/date @@ -108,12 +119,12 @@ $ curl https://p.afpy.org/date Tue Apr 25 06:23:44 PM CEST 2023 ``` -La page d'accueil est maintenue de cette manière la. +La page d’accueil est maintenue de cette manière la. ### Lister ses envois -Tous les envois effectiés avec le même secret peuvent être listés via l'URL `/::/list/` : +Tous les envois effectiés avec le même secret peuvent être listés via l’URL `/::/list/` : ```bash $ curl https://p.afpy.org/::/list/ -H "Authorization: Secret supersecret" @@ -151,18 +162,19 @@ paf() Il est possible : -- d'envoyer un ou plusieurs fichiers, -- d'envoyer `stdin`, +- d’envoyer un ou plusieurs fichiers, +- d’envoyer `stdin`, - de lister ses envois. -Exemple d'envoi via `stdin` : +Exemple d’envoi via `stdin` : ```bash $ cal | paf - https://p.afpy.org/aAkF ``` -Si vous voulez partager un dossier complet, vous pouvez simplement envoyer la liste des URL qui vous est renvoyée : +Si vous voulez partager un dossier complet, vous pouvez simplement +envoyer la liste des URL qui vous est renvoyée : ``` $ paf *.py|paf @@ -188,7 +200,7 @@ Et qui est rendu avec des liens cliquables en HTML ! ## Accès aux collages Chaque collage peut-être consulté dans un navigateur (où il est -présenté avec de la coloration syntaxique : https://p.afpy.org/manage.py), +présenté avec de la coloration syntaxique : https://p.afpy.org/manage.py), ou être consulté en ligne de commande (où il est délivré brut) : ```