[Débutant] documentation API (par exemple Socket)

Bonjour,

Une question de novice au sujet de python ...

Cela concerne l'API socket mais mes questions sont un peu plus
générales, je crois.

1)
J'ai mis quelque temps à comprendre que le module à importer
portait le même nom qu'une des classes du module: socket.
Je trouve cela pour le moins curieux et confus ... est-ce quelque
chose de commun en python ? et y-a-t-il un intérêt à faire ceci ?

2)
existe-t--il un truc similaire à la javadoc ... parce que la
doc là : http://docs.python.org/3.1/library/socket.html
est pas mal ... mais ça ne me semble pas remplacer
une javadoc.

3) quand je lis que

socket.socket(socket.AF_INET, socket.SOCK_STREAM)

"Create a new socket using the given address family, socket type and protocol number."...

cela signifie-t-il que c'est le constructeur de socket qui est appelé ? ou une fonction du module socket ... c'est pas clair pour moi
d'autant plus que je ne trouve pas la liste des constructeurs de socket (comme me le donnerait un truc style javadoc ....)

Merci par avance pour vos réponses !

Bonsoir,

Citation:

---

Envoyé par jean-fr

J'ai mis quelque temps à comprendre que le module à importer portait le même nom qu'une des classes du module: socket.
Je trouve cela pour le moins curieux et confus ... est-ce quelque
chose de commun en python ? et y-a-t-il un intérêt à faire ceci ?

---

Python et son utilisation intensive des espaces de nommage, au début c'est surprenant mais avec un peu de pratique vous verrez que c'est aussi un de ses atouts.

Citation:

---

3) quand je lis que
socket.socket(socket.AF_INET, socket.SOCK_STREAM)
"Create a new socket using the given address family, socket type and protocol number."...
cela signifie-t-il que c'est le constructeur de socket qui est appelé ? ou une fonction du module socket ... c'est pas clair pour moi

---

Les modules Python peuvent contenir des variables, des fonctions ou des classes. Dans le module socket,

• has_ipv6 est une variable
• create_connection est une fonction (qui retourne un socket)
• socket est une classe

Compliqué? Une façon de voir les choses est d'imaginer qu'un module est un Singleton.
Comment savoir que socket.socket est une classe? Parce que l'object socket et ses méthodes sont documentées... (relisez la doc).
=> socket.socket est donc à priori un constructeur - il vous retourne une nouvelle instance de...

Citation:

---

d'autant plus que je ne trouve pas la liste des constructeurs de socket (comme me le donnerait un truc style javadoc ....)

---

La documentation Python est construite a partir du code comme Javadoc.
Par contre, vous n'y avez pas encore trouvé vos repères: courage, patience,...

- W

En Python 2.5 c'est en fait un alias de _socketobject qui est le vrai nom de la classe, semble-t-il:

Code:

---

1 2 3 4 5

>>> import socket as s >>> s.socket <class 'socket._socketobject'> >>> s.socket is s._socketobject True

---

En Python 3.1 par contre, la classe s'appelle réellement socket et _socketobject a disparu:

Code:

---

1 2 3

>>> import socket as s >>> s.socket <class 'socket.socket'>

---

C'est un peu inhabituel étant donné que, par convention, le nom d'une classe est généralement capitalisé en Python. socket aurait aussi bien pu être une fonction qui retourne un nouvel object de type Socket...

En réalité peu importe: que ce soit une fonction ou un constructeur, la syntaxe pour l'utiliser est la même. La différence n'est importante que si vous voulez créer une nouvelle classe qui hérite de socket, mais je doute que ce soit le type d'utilisation le plus fréquent.

J'ajouterais qu'il n'y a toujours qu'un seul constructeur en Python, qui s'appelle __init__. Cela n'a donc pas de sens de parler d'une liste de constructeur. Il est par contre aisé de fournir plusieurs fonctions ou "factory methods" qui initialisent un object de différentes façons.

Honteusement ... après plus d'1 mois, je remercie
les contributeurs de ce fil !
J'avais laissé tomber Python ces derniers temps et je m'y remets ...

Merci à vous.

Un petit up sur ce fil pour une nouvelle question relative aux sockets.

dans le module socket, il y a deux fonctions htonl et
htons pour transcoder les long et les short avant
de les envoyer sur le réseau.

Comment puis-je savoir lequel des deux utiliser pour mon numéro
de port lorsque je fais mon bind ?

Etant donné que python 3 ne gère que des int et que les deux fonctions
sont pour des short et des long ... je suis un peu perdu ...
(comme ce n'est pas mon code qui fera le ntoh, je ne peux
pas décider arbitrairement de la fonction à utiliser ...)

merci pour votre aide

Si je ne dis pas de bétise, tu n'as pas besoin de convertir des entiers si tu veux t'en servir comme argument à la méthode bind. C'est cette méthode qui se charge de convertir au bon type.

Citation:

---

Envoyé par Biribibi

Si je ne dis pas de bétise, tu n'as pas besoin de convertir des entiers si tu veux t'en servir comme argument à la méthode bind. C'est cette méthode qui se charge de convertir au bon type.

---

Hum ... tu connais une doc qui parle de ça ?

cela dit, ça ne serait pas idiot ... vu que l'interprétation
du numéro de port n'est pas du ressort du programmeur ...

Salut,

Les différents aggregats (host, port) correspondant à des sockaddr sont des tuples que la bibliothèque C Python convertis avec des htonX ntohX dans socketmodule.c

Citation:

---

cela dit, ça ne serait pas idiot ... vu que l'interprétation
du numéro de port n'est pas du ressort du programmeur ...

---

Heu??
Toute cette histoire de htons est pour que lorsque vous dites "port=1234" dans votre programme... C'est effectivement le port 1234 au sens TCP/IP.
Ce qui ... permet à TCP/IP d'interpréter "correctement" ce que le programmeur veut.

- W