[issue37145] collections.abc.MappingView mixins rely on undocumented _mapping

2019-06-04 Thread Geoffrey Sneddon
Geoffrey Sneddon added the comment: Like, where in the documentation can I learn that MappingView's initializer takes an argument "mapping"? -- ___ Python tracker <https://bugs.python.o

[issue37145] collections.abc.MappingView mixins rely on undocumented _mapping

2019-06-04 Thread Geoffrey Sneddon
Geoffrey Sneddon added the comment: You've missed my point: the arguments that MappingView.__init__ takes are undocumented. Nowhere mentions class MappingView(mapping), as I would expect from how initializers are documented elsewhere

[issue37145] collections.abc.MappingView mixins rely on undocumented _mapping

2019-06-04 Thread Geoffrey Sneddon
Geoffrey Sneddon added the comment: Then I guess what I consider a bug is "__init__ is undocumented". -- ___ Python tracker <https://bugs.python.o

[issue37145] collections.abc.MappingView mixins rely on undocumented _mapping

2019-06-03 Thread Geoffrey Sneddon
Geoffrey Sneddon added the comment: How do you use ItemsView without: * relying on __init__ and _mapping, which are both private implementation details, or * reimplementing __len__, __contains__, and __iter__? Given you can't use the mixin implementations of __len__, __contains__

[issue37145] collections.abc.MappingView mixins rely on undocumented _mapping

2019-06-03 Thread Geoffrey Sneddon
New submission from Geoffrey Sneddon : The mixin methods on MappingView and its subclasses all rely on the undocumented MappingView._mapping (set in the undocumented MappingView.__init__). This should probably be documented at least insofar as Set._from_iterable is. -- assignee

[issue34000] Document when compile returns a code object v. AST

2018-06-29 Thread Geoffrey Sneddon
New submission from Geoffrey Sneddon : The compile built-in documentation says: > Compile the source into a code or AST object. It doesn't however go on to say when it returns each! It does however note: > If you want to parse Python code into its AST representation, see ast.parse(

[issue17909] Autodetecting JSON encoding

2016-05-03 Thread Geoffrey Sneddon
Changes by Geoffrey Sneddon <geoffers+pythonb...@gmail.com>: -- nosy: +gsnedders ___ Python tracker <rep...@bugs.python.org> <http://bugs.python