Proofreading using.fr.md

This commit is contained in:
Julien Palard 2023-04-25 22:00:00 +02:00
parent d70b7db79a
commit 708a6f22b0
Signed by: mdk
GPG Key ID: 0EFC1AC1006886F8
1 changed files with 32 additions and 20 deletions

View File

@ -1,6 +1,6 @@
# Paf'Py # PafPy
Et PAF ! Et PAF !
## TL;DR ## TL;DR
@ -13,7 +13,7 @@ paf()
} }
``` ```
Cette fonction permet d'envoyer un fichier : Cette fonction permet denvoyer un fichier :
```bash ```bash
$ paf manage.py $ 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 lAFPy 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 dadapter à votre usage.
En utilisant des requêtes `multipart/form-data` il est possible denvoyer un fichier :
```bash ```bash
$ curl https://p.afpy.org/ -Fmanage.py=@manage.py $ curl https://p.afpy.org/ -Fmanage.py=@manage.py
- https://p.afpy.org/TaPa/manage.py - https://p.afpy.org/TaPa/manage.py
``` ```
ou plusieurs fichiers en même temps : ou plusieurs fichiers en même temps :
```bash ```bash
$ curl https://p.afpy.org/ -Fmanage.py=@manage.py -Frequirements.txt=@requirements.txt $ 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 - https://p.afpy.org/Nz2o/requirements.txt
``` ```
C'est l'extension dans le nom du fichier qui permet de choisir la Cest lextension dans le nom du fichier qui permet de choisir la
coloration syntaxique pour chaque fichier. coloration syntaxique pour chaque fichier.
### Envoyer dans le corps d'une requête ### Envoyer dans le corps dune 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 dune requête POST :
```bash ```bash
$ cal | curl -XPOST --data-binary @- https://p.afpy.org/ $ cal | curl -XPOST --data-binary @- https://p.afpy.org/
- https://p.afpy.org/mo8X - 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 lentête `Content-Type` :
```bash ```bash
$ cal | curl -XPOST -H "Content-Type: text/plain" --data-binary @- https://p.afpy.org/ $ cal | curl -XPOST -H "Content-Type: text/plain" --data-binary @- https://p.afpy.org/
- https://p.afpy.org/i3Y2/request.txt - https://p.afpy.org/i3Y2/request.txt
``` ```
### Choisir l'URL ### Choisir lURL
Il est possible d'utiliser la méthode `PUT` sur une `URL` : Il est possible dutiliser la méthode `PUT` sur une `URL` :
```bash ```bash
$ cal | curl -XPUT --data-binary @- https://p.afpy.org/cal $ 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 ### É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 dun paste, vous pouvez lui affecter un secret via lentête HTTP `Authorization` :
```bash ```bash
$ date | curl -XPUT --data-binary @- -H "Authorization: Secret supersecret" https://p.afpy.org/date $ 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 Tue Apr 25 06:23:44 PM CEST 2023
``` ```
La page d'accueil est maintenue de cette manière la. La page daccueil est maintenue de cette manière la.
### Lister ses envois ### 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 lURL `/::/list/` :
```bash ```bash
$ curl https://p.afpy.org/::/list/ -H "Authorization: Secret supersecret" $ curl https://p.afpy.org/::/list/ -H "Authorization: Secret supersecret"
@ -151,18 +162,19 @@ paf()
Il est possible : Il est possible :
- d'envoyer un ou plusieurs fichiers, - denvoyer un ou plusieurs fichiers,
- d'envoyer `stdin`, - denvoyer `stdin`,
- de lister ses envois. - de lister ses envois.
Exemple d'envoi via `stdin` : Exemple denvoi via `stdin` :
```bash ```bash
$ cal | paf $ cal | paf
- https://p.afpy.org/aAkF - 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 $ paf *.py|paf
@ -188,7 +200,7 @@ Et qui est rendu avec des liens cliquables en HTML !
## Accès aux collages ## Accès aux collages
Chaque collage peut-être consulté dans un navigateur (où il est 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) : ou être consulté en ligne de commande (où il est délivré brut) :
``` ```