Re: Survey: improving the Python std lib docs

A portion of this thread seems to be focusing on what key word args parameters actually mean, in the Python sense. There is documentation for that, and a modicum of experience with Python makes this a relatively simple question and answer. However, when docs for a specific function or method spe

RE: Survey: improving the Python std lib docs

> -Original Message- > From: Python-list > [mailto:python-list-bounces+python=deborahswanson.net@python.o > rg] On Behalf Of Gregory Ewing > Sent: Thursday, May 18, 2017 5:00 PM > To: python-list@python.org > Subject: Re: Survey: improving the Python std lib docs &g

Re: Survey: improving the Python std lib docs

Deborah Swanson wrote: somenamedtuple._replace(kwargs) Return a new instance of the named tuple replacing specified fields with new values: (Examples box)---| |>>> | | | |>>> p = Point(x=11, y=22) | |>>> p._replace(x=33

RE: Survey: improving the Python std lib docs

justin walters wrote, on Thursday, May 18, 2017 8:09 AM > To: python-list@python.org > Subject: Re: Survey: improving the Python std lib docs > > So, args can be treated as a simple (named)? tuple or a > simple dictionary. `*` unpacks a list or tuple and `**` > unpacks a di

Re: Survey: improving the Python std lib docs

On Thu, May 18, 2017 at 8:08 AM, justin walters wrote: > > > On Thu, May 18, 2017 at 12:09 AM, Deborah Swanson < > pyt...@deborahswanson.net> wrote: > >> Michael Torrie wrote, on Wednesday, May 17, 2017 3:11 PM >> > >> > On 05/17/2017 02:31 PM, Ned Batchelder wrote: >> > > Can you give an example

Re: Survey: improving the Python std lib docs

On Thu, May 18, 2017 at 12:09 AM, Deborah Swanson wrote: > Michael Torrie wrote, on Wednesday, May 17, 2017 3:11 PM > > > > On 05/17/2017 02:31 PM, Ned Batchelder wrote: > > > Can you give an example of such a method? Often, that signature is > > > used because there is no pre-conception of what

RE: Survey: improving the Python std lib docs

Michael Torrie wrote, on Wednesday, May 17, 2017 3:11 PM > > On 05/17/2017 02:31 PM, Ned Batchelder wrote: > > Can you give an example of such a method? Often, that signature is > > used because there is no pre-conception of what the arguments might > > be. > > I'm not sure if this afflicts the

Re: Survey: improving the Python std lib docs

On Thu, May 18, 2017 at 8:11 AM, Michael Torrie wrote: > On 05/17/2017 02:31 PM, Ned Batchelder wrote: >> Can you give an example of such a method? Often, that signature is used >> because there is no pre-conception of what the arguments might be. > > I'm not sure if this afflicts the standard lib

Re: Survey: improving the Python std lib docs

On 05/17/2017 02:31 PM, Ned Batchelder wrote: > Can you give an example of such a method? Often, that signature is used > because there is no pre-conception of what the arguments might be. I'm not sure if this afflicts the standard library, but in my own code, since Python doesn't support construc

Re: Survey: improving the Python std lib docs

On Wednesday, May 17, 2017 at 5:48:30 AM UTC-4, Cem Karan wrote: > On May 16, 2017, at 12:36 PM, rzed wrote: > > > On Friday, May 12, 2017 at 6:02:58 AM UTC-4, Steve D'Aprano wrote: > >> One of the more controversial aspects of the Python ecosystem is the Python > >> docs. Some people love them,

RE: Survey: improving the Python std lib docs

Cem Karan wrote, on Wednesday, May 17, 2017 2:48 AM > > On May 16, 2017, at 12:36 PM, rzed wrote: > > > On Friday, May 12, 2017 at 6:02:58 AM UTC-4, Steve D'Aprano wrote: > >> One of the more controversial aspects of the Python > ecosystem is the > >> Python docs. Some people love them, and so

Re: Survey: improving the Python std lib docs

On May 16, 2017, at 12:36 PM, rzed wrote: > On Friday, May 12, 2017 at 6:02:58 AM UTC-4, Steve D'Aprano wrote: >> One of the more controversial aspects of the Python ecosystem is the Python >> docs. Some people love them, and some people hate them and describe them as >> horrible. >> > [...] >

Re: Survey: improving the Python std lib docs

On Friday, May 12, 2017 at 6:02:58 AM UTC-4, Steve D'Aprano wrote: > One of the more controversial aspects of the Python ecosystem is the Python > docs. Some people love them, and some people hate them and describe them as > horrible. > [...] One thing I would love to see in any function or class

Re: Survey: improving the Python std lib docs

On 15/05/2017 13:44, Ned Batchelder wrote: As it is, if I make a suggestion about the itertools docs (why do we need 20-line "equivalent to" Python code, and why don't we have any usage examples?), then I have to debate it with the developer of itertools, who has a different aesthetic and style

Re: Survey: improving the Python std lib docs

On Friday, May 12, 2017 at 6:02:58 AM UTC-4, Steve D'Aprano wrote: > One of the more controversial aspects of the Python ecosystem is the Python > docs. Some people love them, and some people hate them and describe them as > horrible. > I have a number of ideas for improving the docs, but I think

Re: Survey: improving the Python std lib docs

On Saturday, May 13, 2017 at 3:39:52 PM UTC-7, Terry Reedy wrote: > On 5/13/2017 1:23 PM, jeanbigbo...@gmail.com wrote: > > > Thank you for bringing up this important topic. As an occasional Python > > user, I find that Python documentation is all over the usability map - some > > great, some d

Re: Survey: improving the Python std lib docs

On 5/13/2017 1:23 PM, jeanbigbo...@gmail.com wrote: Thank you for bringing up this important topic. As an occasional Python user, I find that Python documentation is all over the usability map - some great, some difficult. The Python docs have been at best a starting point. I usually need

Re: Survey: improving the Python std lib docs

On 5/12/2017 6:02 AM, Steve D'Aprano wrote: Here are a couple of suggestions for improving(?) the docs. What do you think? (They're not my ideas, the originated on Reddit.) (1) Table of functions/classes at the start of each module doc The only thing possibly 'new' here is 'each' versus 'se

Re: Survey: improving the Python std lib docs

On Friday, May 12, 2017 at 3:02:58 AM UTC-7, Steve D'Aprano wrote: > One of the more controversial aspects of the Python ecosystem is the Python > docs. Some people love them, and some people hate them and describe them as > horrible. > > Here are a couple of suggestions for improving(?) the docs.

Re: Survey: improving the Python std lib docs

Steve D'Aprano writes: > One of the more controversial aspects of the Python ecosystem is the Python > docs. Some people love them, and some people hate them and describe them as > horrible. > > Here are a couple of suggestions for improving(?) the docs. What do you > think? > > (They're not my id

Re: Survey: improving the Python std lib docs

On Sat, May 13, 2017 at 4:05 AM, wrote: > On Friday, May 12, 2017 at 3:02:58 AM UTC-7, Steve D'Aprano wrote: > >> (1) Table of functions/classes at the start of each module doc >> >> The docs for builtins starts with a table of built-in functions: >> >> https://docs.python.org/3/library/functions

Re: Survey: improving the Python std lib docs

On 05/12/2017 03:02 AM, Steve D'Aprano wrote: Here are a couple of suggestions for improving(?) the docs. What do you think? (1) Table of functions/classes at the start of each module doc I like this idea. Even if I don't know the exact thing I am looking for I can usually get close from

Re: Survey: improving the Python std lib docs

On Friday, May 12, 2017 at 3:02:58 AM UTC-7, Steve D'Aprano wrote: > (1) Table of functions/classes at the start of each module doc > > The docs for builtins starts with a table of built-in functions: > > https://docs.python.org/3/library/functions.html > > > Docs for other modules should do s

Re: Survey: improving the Python std lib docs

On Fri, 12 May 2017 21:14:01 +1000, Chris Angelico wrote: > On Fri, May 12, 2017 at 8:02 PM, Steve D'Aprano > wrote: >> (2) The PHP documentation allows you to search for a term by typing it into >> the URL after the domain, e.g. to search for "split", go to: >> >> http://php.net/split >> >> >> I

Re: Survey: improving the Python std lib docs

On Fri, May 12, 2017 at 8:02 PM, Steve D'Aprano wrote: > (2) The PHP documentation allows you to search for a term by typing it into > the URL after the domain, e.g. to search for "split", go to: > > http://php.net/split > > > If you try the same thing with the Python docs: > > http://python.org/s

Re: Survey -- Move To Trash function in Python?

On 18/05/2015 11:31, iMath wrote: 在 2015年5月14日星期四 UTC+8下午11:45:38，Steven D'Aprano写道： I'd like to do a little survey, and get a quick show of hands. How many people have written GUI or text-based applications or scripts where a "Move file to trash" function would be useful? Would you like to se

Re: Survey -- Move To Trash function in Python?

在 2015年5月14日星期四 UTC+8下午11:45:38，Steven D'Aprano写道： > I'd like to do a little survey, and get a quick show of hands. > > How many people have written GUI or text-based applications or scripts where > a "Move file to trash" function would be useful? > > Would you like to see that in the standard li

Re: Survey -- Move To Trash function in Python?

On Friday, May 15, 2015 at 11:27:18 AM UTC-7, rand...@fastmail.us wrote: > On Fri, May 15, 2015, at 00:25, Chris Angelico wrote: > > The main thing is that trashing invites the system to delete the file > > at its leisure, > > I've never seen a system whose trash can emptied itself without user >

Re: Survey -- Move To Trash function in Python?

On Sat, May 16, 2015 at 4:27 AM, wrote: > On Fri, May 15, 2015, at 00:25, Chris Angelico wrote: >> The main thing is that trashing invites the system to delete the file >> at its leisure, > > I've never seen a system whose trash can emptied itself without user > intervention. They always grow to

Re: Survey -- Move To Trash function in Python?

On Fri, May 15, 2015, at 00:25, Chris Angelico wrote: > The main thing is that trashing invites the system to delete the file > at its leisure, I've never seen a system whose trash can emptied itself without user intervention. -- https://mail.python.org/mailman/listinfo/python-list

Re: Survey -- Move To Trash function in Python?

On Fri, May 15, 2015 at 2:09 PM, Steven D'Aprano wrote: >> Yes, but sometimes it's at the file system's discretion - particularly >> when you're working with network mounts. The application may not even >> know that the file got hard deleted. > > Citation needed. > > "Move to trash" is a move oper

Re: Survey -- Move To Trash function in Python?

On Fri, 15 May 2015 12:56 pm, Chris Angelico wrote: > On Fri, May 15, 2015 at 12:49 PM, Ian Kelly wrote: >> On May 14, 2015 7:55 PM, "Chris Angelico" wrote: >>> (Though when >>> it comes to the bikeshedding phase, I'm sure there'll be some who say >>> "if it can't be trashed, just hard delete it

Re: Survey -- Move To Trash function in Python?

On Fri, May 15, 2015 at 12:49 PM, Ian Kelly wrote: > On May 14, 2015 7:55 PM, "Chris Angelico" wrote: >> (Though when >> it comes to the bikeshedding phase, I'm sure there'll be some who say >> "if it can't be trashed, just hard delete it", and others who say "if >> it can't be trashed, raise an

Re: Survey -- Move To Trash function in Python?

On May 14, 2015 7:55 PM, "Chris Angelico" wrote: > (Though when > it comes to the bikeshedding phase, I'm sure there'll be some who say > "if it can't be trashed, just hard delete it", and others who say "if > it can't be trashed, raise an exception". And neither is truly wrong.) The answer is "r

Re: Survey -- Move To Trash function in Python?

On 5/14/2015 10:03 PM, Steven D'Aprano wrote: The idea is that the library will hide that complexity from you, so your python code will just say: import shutil shutil.move_to_trash(filename) Since 'trash' is (or is used as) a verb, shutil.trash(filename) seems sufficient. and it will work o

Re: Survey -- Move To Trash function in Python?

On Fri, 15 May 2015 01:59 am, Chris Angelico wrote: > On Fri, May 15, 2015 at 1:49 AM, Grant Edwards > wrote: >> On 2015-05-14, Steven D'Aprano >> wrote: >> >>> I'd like to do a little survey, and get a quick show of hands. >>> >>> How many people have written GUI or text-based applications or >

Re: Survey -- Move To Trash function in Python?

On Fri, 15 May 2015 03:32 am, Dave Farrance wrote: > Steven D'Aprano wrote: > >>I'd like to do a little survey, and get a quick show of hands. >> >>How many people have written GUI or text-based applications or scripts >>where a "Move file to trash" function would be useful? >> >>Would you like

Re: Survey -- Move To Trash function in Python?

On Fri, May 15, 2015 at 11:37 AM, Steven D'Aprano wrote: > On Fri, 15 May 2015 01:49 am, Grant Edwards wrote: > >> On 2015-05-14, Steven D'Aprano >> wrote: >> >>> I'd like to do a little survey, and get a quick show of hands. >>> >>> How many people have written GUI or text-based applications or

Re: Survey -- Move To Trash function in Python?

On Fri, 15 May 2015 01:49 am, Grant Edwards wrote: > On 2015-05-14, Steven D'Aprano > wrote: > >> I'd like to do a little survey, and get a quick show of hands. >> >> How many people have written GUI or text-based applications or >> scripts where a "Move file to trash" function would be useful?

Re: Survey -- Move To Trash function in Python?

On 05/14/2015 11:43 AM, Chris Warrick wrote: And if you are looking for a mostly-compliant Python library/app (and a shameless plug): https://pypi.python.org/pypi/trashman/1.5.0 The docs listed link to Package Builder. How is that related to TrashMan? -- ~Ethan~ -- https://mail.python.org/m

Re: Survey -- Move To Trash function in Python?

On Thu, May 14, 2015 at 8:11 PM, Grant Edwards wrote: > On 2015-05-14, Dave Farrance wrote: >> Steven D'Aprano wrote: >> >>>I'd like to do a little survey, and get a quick show of hands. >>> >>>How many people have written GUI or text-based applications or scripts where >>>a "Move file to trash"

Re: Survey -- Move To Trash function in Python?

On 05/14/2015 08:45 AM, Steven D'Aprano wrote: I'd like to do a little survey, and get a quick show of hands. How many people have written GUI or text-based applications or scripts where a "Move file to trash" function would be useful? Never. Would you like to see that in the standard librar

Re: Survey -- Move To Trash function in Python?

On 2015-05-14, Dave Farrance wrote: > Steven D'Aprano wrote: > >>I'd like to do a little survey, and get a quick show of hands. >> >>How many people have written GUI or text-based applications or scripts where >>a "Move file to trash" function would be useful? >> >>Would you like to see that in t

Re: Survey -- Move To Trash function in Python?

Steven D'Aprano wrote: >I'd like to do a little survey, and get a quick show of hands. > >How many people have written GUI or text-based applications or scripts where >a "Move file to trash" function would be useful? > >Would you like to see that in the standard library, even if it meant that >th

Re: Survey -- Move To Trash function in Python?

On Fri, May 15, 2015 at 1:49 AM, Grant Edwards wrote: > On 2015-05-14, Steven D'Aprano wrote: > >> I'd like to do a little survey, and get a quick show of hands. >> >> How many people have written GUI or text-based applications or >> scripts where a "Move file to trash" function would be useful?

Re: Survey -- Move To Trash function in Python?

On 2015-05-14, Steven D'Aprano wrote: > I'd like to do a little survey, and get a quick show of hands. > > How many people have written GUI or text-based applications or > scripts where a "Move file to trash" function would be useful? How would you even define what "move to trash" means in a sta

Re: Survey of Python-in-browser technologies

On 05/24/2013 08:38 PM, Carlos Nepomuceno wrote: Date: Fri, 24 May 2013 17:11:18 -0700 Subject: Re: Survey of Python-in-browser technologies From: drsali...@gmail.com To: carlosnepomuc...@outlook.com CC: python-list@python.org Security is an important topic

RE: Survey of Python-in-browser technologies

> Date: Fri, 24 May 2013 17:11:18 -0700 > Subject: Re: Survey of Python-in-browser technologies > From: drsali...@gmail.com > To: carlosnepomuc...@outlook.com > CC: python-list@python.org > > > Security is an important topic... but

Re: Survey of Python-in-browser technologies

Security is an important topic... but I'm not sure how I could gather info about the security of these implementations. Still, it's an idea worth at least keeping in the back of my mind. On Fri, May 24, 2013 at 4:43 PM, Carlos Nepomuceno < carlosnepomuc...@outlook.com> wrote: > Thanks Dan! All o

RE: Survey of Python-in-browser technologies

Thanks Dan! All of that is relevant but I'm specially concerned about security issues and think another column for that purpose would improve your database, although I'm not sure if there's data available or how it would be presented. > Date: Fri, 24 May 2013 16:

Re: Survey: Does your company use Python? Do you know a company that uses Python?

On 7 Ago, 21:15, VanL wrote: > This is a survey to find as many companies using Python as we can. You > can see the survey below: > > > > You don't need to work at the company to add it to this list! We will > filter for

Re: Survey environment for Python?

Kay Schluehr wrote: > exhuma.twn schrieb: > > > Hi, > > > > Just recently I had to take over support for legacy software written in > > Blaise (www.cbs.nl). > > I don't understand the meaning of the link. Do you mean this language? > > http://blaise.sourceforge.net/ Not quite ;) Sorry for being t

Re: Survey environment for Python?

On Dec 14, 9:12 am, "Kay Schluehr" <[EMAIL PROTECTED]> wrote: > exhuma.twn schrieb: > > > Hi, > > > Just recently I had to take over support for legacy software written in > > Blaise (www.cbs.nl).I don't understand the meaning of the link. Do you mean > > this language? > > http://blaise.sourcef

Re: Survey environment for Python?

exhuma.twn schrieb: > Hi, > > Just recently I had to take over support for legacy software written in > Blaise (www.cbs.nl). I don't understand the meaning of the link. Do you mean this language? http://blaise.sourceforge.net/ -- http://mail.python.org/mailman/listinfo/python-list

Re: Survey Tool

Sorry if I wasn't clear- Was after a Python program serving up (using CGI, Django, CherryPy.. or whatever) a survey- filled out using a web browser. Timothy Downs > Wait. . .Do you want it on a website? I don't really understand you > > > -Ivan > > __

RE: Survey Tool

Wait. . .Do you want it on a website? I don't really understand you -Ivan _ Don’t just search. Find. Check out the new MSN Search! http://search.msn.click-url.com/go/onm00200636ave/direct/01/ -- http://mail.python.org/mailman/l

Re: survey of modules to be added to stdlib

It would be amazing if you could add the feature to do combo package installs like : - a scientific python combo (which would include scipy, numarray, Numpy, plotting libs, etc) - an AI python combo(orange, constraint programming modules, agent libs, etc) - a game development python combo (pygam

Re: survey of modules to be added to stdlib

On Sat, 19 Mar 2005 03:40:31 GMT, Ron <[EMAIL PROTECTED]> wrote: > I would prefer to have a install utility included that retrieves a > list of modules we can install, update, or uninstall, from the web in > a consistent easy way. It would really be nice if they listed what > modules they were dep

Re: survey of modules to be added to stdlib

On 18 Mar 2005 14:16:01 -0800, "Alia Khouri" <[EMAIL PROTECTED]> wrote: >This is an informal survey to gauge the community's interest in adding >popular modules to the python standard library. I would prefer to have a install utility included that retrieves a list of modules we can install, updat

Re: survey of modules to be added to stdlib

"Raymond Hettinger" <[EMAIL PROTECTED]> writes: > > psyco - Armin Rigo > This is platform specific. That's ok, there's plenty of platform specific modules in the stdlib already, and this seems like a good one to add. -- http://mail.python.org/mailman/listinfo/python-list

Re: survey of modules to be added to stdlib

> psyco - Armin Rigo This is platform specific. Raymond -- http://mail.python.org/mailman/listinfo/python-list

Re: survey of modules to be added to stdlib

Alia Khouri: > ctypes - Thomas Heller I would like this to go in but it won't be added as it allows unsafe code, such as dereferencing bad pointers. Neil -- http://mail.python.org/mailman/listinfo/python-list

Re: survey of modules to be added to stdlib

Alia Khouri wrote: BTW is there an official set of conditions that have to be met before a module can be accepted into the stdlib? Yes - although this has never been followed to date: In PEP 2, http://www.python.org/peps/pep-0002.html a procedure is defined how new modules can be added. Essentially

Re: survey

D H wrote: Peter Hansen wrote: Dave Zhu wrote: Is there any survey on scripting languages? I would like to get information on several scripting languages including Python, Perl, Ruby, Tcl, etc. What kind of information? ... See the other responses to his question. Why would I want to do that? Did

Re: survey

[EMAIL PROTECTED] wrote: > > The Language Shootout at http://shootout.alioth.debian.org/ has code > > samples in many languages, both interpreted and compiled, including > the > > ones you mentioned. Don't trust the lines-of-code statistics, though > -- > > the LOC measure is wrongly shown as zero

Re: survey

Peter Hansen wrote: Dave Zhu wrote: Hello All, Is there any survey on scripting languages? I would like to get information on several scripting languages including Python, Perl, Ruby, Tcl, etc. What kind of information? ... See the other responses to his question. -- http://mail.python.org/mailman

Re: survey

> The Language Shootout at http://shootout.alioth.debian.org/ has code > samples in many languages, both interpreted and compiled, including the > ones you mentioned. Don't trust the lines-of-code statistics, though -- > the LOC measure is wrongly shown as zero for several codes, and comment > line

Re: survey

I'd like to know how scripts are processed, whether they are compiled into bytecode, how memory is allocated for variables, how scripting languages perform compared to each other, etc. --- Cameron Laird <[EMAIL PROTECTED]> wrote: > In article <[EMAIL PROTECTED]>, > Peter Hansen <[EMAIL PROTECTED]

Re: survey

Dave Zhu wrote: > Hello All, > > Is there any survey on scripting languages? I would > like to get information on several scripting languages > including Python, Perl, Ruby, Tcl, etc. The Language Shootout at http://shootout.alioth.debian.org/ has code samples in many languages, both interpreted a

Re: survey

In article <[EMAIL PROTECTED]>, Peter Hansen <[EMAIL PROTECTED]> wrote: >Dave Zhu wrote: >> Hello All, >> >> Is there any survey on scripting languages? I would >> like to get information on several scripting languages >> including Python, Perl, Ruby, Tcl, etc. > >What kind of information? ... P

Re: survey

Dave Zhu wrote: Hello All, Is there any survey on scripting languages? I would like to get information on several scripting languages including Python, Perl, Ruby, Tcl, etc. What kind of information? ... -- http://mail.python.org/mailman/listinfo/python-list

Re: survey

On Fri, 4 Mar 2005 14:14:05 -0800 (PST), Dave Zhu <[EMAIL PROTECTED]> wrote: > Is there any survey on scripting languages? I would > like to get information on several scripting languages > including Python, Perl, Ruby, Tcl, etc. There are several such comparisons on the web but most will natural

Re: survey

"Dave Zhu" <[EMAIL PROTECTED]> wrote in message news:[EMAIL PROTECTED] > Hello All, > > Is there any survey on scripting languages? I would > like to get information on several scripting languages > including Python, Perl, Ruby, Tcl, etc. > > Thanks > > Dave After a little googling, that's what I