Ryan Kelly added the comment: Sorry, "endpoint" is just a noun that seemed to fit for me, I've no idea if there is a standard term for this. Perhaps "origin server" if you follow the terminology from the RFC? By way of example, suppose I'm running a proxy on localhost:3128 and I want to tunnel through it to connect to www.example.com:443.

From the train of thought that "I need to tunnel through localhost:3128 to connect to www.example.com:443" my instinct was to write code like this:

c = HTTPSConnection("www.example.com",443) c.set_tunnel("localhost",3128) c.send('...etc...') This doesn't work; it tries to tunnel through www.example.com to get to localhost. The correct way around is: c = HTTPSConnection("localhost",3128) c.set_tunnel("www.example.com",443) c.send('...etc...') Another way to put it: the arguments to set_tunnel are the host/port to tunnel *to*, not the host/port to tunnel *through*. I was only able to work this out by looking through to code for urllib2. It's not clear from the docs. Then again, sounds like my doc patch didn't make things any clearer :-) ---------- _______________________________________ Python tracker http://bugs.python.org/issue11448 _______________________________________

karl added the comment: This is a possible additional example for set_tunnel, modification of python3.3/html/_sources/library/http.client.txt Hope it helps. ---------- nosy: +karlcow Added file: http://bugs.python.org/file29243/http.client.patch _______________________________________ Python tracker http://bugs.python.org/issue11448 _______________________________________

karl added the comment: Ah thanks Eric, I will fix that. ---------- _______________________________________ Python tracker http://bugs.python.org/issue11448 _______________________________________

Nikolaus Rath added the comment: Is there anything that needs to be done to get this patch applied? It would be nice if this could be committed together with the patch in issue 7776. ---------- nosy: +Nikratio _______________________________________ Python tracker http://bugs.python.org/issue11448 _______________________________________

Nikolaus Rath added the comment: The patches look fine to me. They are only docpatches, so no testcase is needed. I have rebased them on current hg tip to avoid fuzz, but otherwise left them unchanged. I think this is ready to be committed. ---------- nosy: +ezio.melotti, georg.brandl versions: -Python 3.5 Added file: http://bugs.python.org/file33609/issue11448_r2.patch _______________________________________ Python tracker http://bugs.python.org/issue11448 _______________________________________

karl added the comment: ooops right, my bad. s/on port 8080. We first/on port 8080, we first/ better? ---------- _______________________________________ Python tracker http://bugs.python.org/issue11448 _______________________________________

Roundup Robot added the comment: New changeset 68a257ca6be6 by Benjamin Peterson in branch '3.3': improve set_tunnel docs (closes #11448) http://hg.python.org/cpython/rev/68a257ca6be6 New changeset 5cab0ada97b2 by Benjamin Peterson in branch 'default': merge 3.3 (#11448) http://hg.python.org/cpython/rev/5cab0ada97b2 ---------- nosy: +python-dev resolution: -> fixed stage: -> committed/rejected status: open -> closed _______________________________________ Python tracker http://bugs.python.org/issue11448 _______________________________________