Re: [Python-Dev] cpython: PEP 417: Adding unittest.mock

2012-03-18 Thread Nick Coghlan
On Mon, Mar 19, 2012 at 11:19 AM, "Martin v. Löwis" wrote: >> The commingling of extensive examples with regular docs has >> made it difficult to lookup functionality in argparse for example. > > I have now come to think that this should be considered a subordinate > use case. The primary use case

Re: [Python-Dev] cpython: PEP 417: Adding unittest.mock

2012-03-18 Thread Martin v. Löwis
> The commingling of extensive examples with regular docs has > made it difficult to lookup functionality in argparse for example. I have now come to think that this should be considered a subordinate use case. The primary use case of the documentation should be copy-paste style examples. At least

Re: [Python-Dev] cpython: PEP 417: Adding unittest.mock

2012-03-18 Thread Michael Foord
On 16 Mar 2012, at 11:54, Nick Coghlan wrote: > On Thu, Mar 15, 2012 at 6:27 AM, Michael Foord > wrote: >> On the topic of docs mock documentation is about eight pages long. My >> intention was to strip this down to just the api documentation, along with a >> link to the docs on my site fo

Re: [Python-Dev] cpython: PEP 417: Adding unittest.mock

2012-03-16 Thread Raymond Hettinger
On Mar 16, 2012, at 4:54 AM, Nick Coghlan wrote: > Don't forgot you also have the option of splitting out a separate > HOWTO tutorial section, leaving the main docs as a pure API reference. > (I personally find that style easier to use than the ones which try to > address both needs in the main m

Re: [Python-Dev] cpython: PEP 417: Adding unittest.mock

2012-03-16 Thread Nick Coghlan
On Thu, Mar 15, 2012 at 6:27 AM, Michael Foord wrote: > On the topic of docs mock documentation is about eight pages long. My > intention was to strip this down to just the api documentation, along with a > link to the docs on my site for further examples and so on. I was encouraged > here

Re: [Python-Dev] cpython: PEP 417: Adding unittest.mock

2012-03-14 Thread Benjamin Peterson
2012/3/14 Michael Foord : > On the topic of docs mock documentation is about eight pages long. My > intention was to strip this down to just the api documentation, along with a > link to the docs on my site for further examples and so on. I was encouraged > here at the sprints to include the

Re: [Python-Dev] cpython: PEP 417: Adding unittest.mock

2012-03-14 Thread Michael Foord
On 14 Mar 2012, at 12:33, Georg Brandl wrote: > On 14.03.2012 20:25, michael.foord wrote: >> http://hg.python.org/cpython/rev/2fda048ee32a >> changeset: 75632:2fda048ee32a >> user:Michael Foord >> date:Wed Mar 14 12:24:34 2012 -0700 >> summary: >> PEP 417: Adding unittest.mock

Re: [Python-Dev] cpython: PEP 417: Adding unittest.mock

2012-03-14 Thread Łukasz Langa
Wiadomość napisana przez Georg Brandl w dniu 14 mar 2012, o godz. 12:33: > On 14.03.2012 20:25, michael.foord wrote: >> http://hg.python.org/cpython/rev/2fda048ee32a >> changeset: 75632:2fda048ee32a >> user:Michael Foord >> date:Wed Mar 14 12:24:34 2012 -0700 >> summary: >> PEP

Re: [Python-Dev] cpython: PEP 417: Adding unittest.mock

2012-03-14 Thread Georg Brandl
On 14.03.2012 20:25, michael.foord wrote: http://hg.python.org/cpython/rev/2fda048ee32a changeset: 75632:2fda048ee32a user:Michael Foord date:Wed Mar 14 12:24:34 2012 -0700 summary: PEP 417: Adding unittest.mock files: Lib/unittest/mock.py | 215