Discussion :

[rambc]

... Python, ou dans un autre langage de programmation. Désolé pour ce titre faussement alléchant.

L'idée serait d'avoir des dossiers contenant des "snippets" commentés, ensuite un programme Python repérerait ces programmes et en gèrerait la mise en forme.

Quelqu'un a-t-il déjà penser à cela ? Quel serait un bon fonctionnement pour commenter les snippets ? Un fichier à part avec les commentaires ? Les commentaires à imprimer directement dans le code source ? Les deux à la fois mon capitaine ?

[PauseKawa]

Bonjour rambc,

Cela me semble lourd pour intégrer cela à du code non ?
En gros ce que tu propose c'est un import 'myrecipes' c'est cela ?
A la limite intégrable à un éditeur mais pour ce qui est mettre cela dans du code... Cela me semble (A mon niveau) lourd.

Bon code

PS:
Par contre pour un site comme developpez cela me semble une bonne idée: Un HOWTO avec des mots clés qui ne ne sortirait que du code, les meilleures recettes de Mr Devellopez...
Cela fais un moment que je me dit que je devrais me faire une BDD des meilleures recettes.

[rambc]

Bonjour,
je remonte ce post qui avait déchaîné les foules...

Ma proposition était en fait très mauvaise. Par exemple, pour un tuto. multi-langue, il faudrait avoir une version des scripts par langue, autant dire du grand n'importe quoi.

Donc je vais opter pour la méthode suivante. On ajoute des marqueurs dans le code qui serviront de références dans le tuto. Voici un exemple.

bidon.py

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# Un petit code
 
#:ref: import
from machin import bidule
 
#:ref: variables
a = 5
b = 7
 
#:ref: fonction
def sum_(x, y):
    return x+y
 
#:ref: test
print(sum_(a,b))

Via mon logiciel et son système de rédaction, on taperait alors les choses comme suit.

Nous allons détaillez morceau par morceau notre premier exemple de programme écrit en Python.


python::
    insert = bidon.py
    ref = import

Cette première ligne demande d'importer machin du module bidule...


python::
    insert = bidon.py
    ref = variables

Nous définissons deux variables...


python::
    insert = bidon.py
    ref = fonction

La fonction sum_ sert à ....


python::
    insert = bidon.py
    ref = test

Pour finir, on teste...

On obtiendra alors :

Nous allons détaillez morceau par morceau notre premier exemple de programme écrit en Python.

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

from machin import bidule

Cette première ligne demande d'importer machin du module bidule...

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
a = 5
b = 7

Nous définissons deux variables...

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
def sum_(x, y):
    return x+y

La fonction sum_ sert à ....

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

print(sum_(a,b))

Pour finir, on teste...

Qu'en pense-vous, ou qu'en penses-tu PauseKawa, ou qu'en pense-je ?...