Source

cpython-withatomic / Doc / libgopherlib.tex

The branch 'legacy-trunk' does not exist.
\section{Standard Module \sectcode{gopherlib}}
\stmodindex{gopherlib}

\renewcommand{\indexsubitem}{(in module gopherlib)}

This module provides a minimal implementation of client side of the
the Gopher protocol.  It is used by the module \code{urllib} to handle
URLs that use the Gopher protocol.

The module defines the following functions:

\begin{funcdesc}{send_selector}{selector\, host\optional{\, port}}
Send a \var{selector} string to the gopher server at \var{host} and
\var{port} (default 70).  Return an open file object from which the
returned document can be read.
\end{funcdesc}

\begin{funcdesc}{send_query}{selector\, query\, host\optional{\, port}}
Send a \var{selector} string and a \var{query} string to a gopher
server at \var{host} and \var{port} (default 70).  Return an open file
object from which the returned document can be read.
\end{funcdesc}

Note that the data returned by the Gopher server can be of any type,
depending on the first character of the selector string.  If the data
is text (first character of the selector is \samp{0}), lines are
terminated by CRLF, and the data is terminated by a line consisting of
a single \samp{.}, and a leading \samp{.} should be stripped from
lines that begin with \samp{..}.  Directory listings (first charactger
of the selector is \samp{1}) are transferred using the same protocol.
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.