This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author lorenzo.ancora
Recipients berker.peksag, docs@python, giampaolo.rodola, lorenzo.ancora, terry.reedy
Date 2016-02-03.03:52:28
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1454471548.91.0.6110567569.issue26209@psf.upfronthosting.co.za>
In-reply-to
Content
(msg259229) Terry J. Reedy i Suggest that a standard and globally accepted scheme to manage IPv4 addresses is:

  "Host:PortNumber" --> (host, PortNumber)
  "Host"            --> (host, DefaultPortNumber)
  "IP:PortNumber" --> (host, PortNumber)
  "IP"            --> (host, DefaultPortNumber)

...where DefaultPortNumber is protocol and system dependent (IANA standard, see the SMTP line in: http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.xhtml).

A simple research reveals that all versions of the module are (sadly) poorly documented, but the module is an interface to a very important protocol that indeed must be offered by the standard library.
The only little suggestion in the documentation of the module is: https://docs.python.org/3.6/library/socket.html#socket.socket.accept
...from a one-word link in: https://docs.python.org/3.6/library/smtpd.html#smtpd.SMTPChannel.addr
Which has only an indirect relation with the object itself.

Many users may not recognize the cause of the error if the documentation doesn't explicitate the information to correctly initialize the core objects of the module.
I also Suggest that at least the object should return an helpful error in newer versions of Python.

Thank you for your efforts guys. :-)
History
Date User Action Args
2016-02-03 03:52:29lorenzo.ancorasetrecipients: + lorenzo.ancora, terry.reedy, giampaolo.rodola, docs@python, berker.peksag
2016-02-03 03:52:28lorenzo.ancorasetmessageid: <1454471548.91.0.6110567569.issue26209@psf.upfronthosting.co.za>
2016-02-03 03:52:28lorenzo.ancoralinkissue26209 messages
2016-02-03 03:52:28lorenzo.ancoracreate