[issue32216] Document PEP 557 Data Classes (dataclasses module)

[Barry A. Warsaw]

Barry A. Warsaw  added the comment:


New changeset 0c62e09774e445a185fd192524454ce697ca123b by Barry Warsaw (Miss 
Islington (bot)) in branch '3.7':
bpo-32216: Update dataclasses documentation (GH-6913) (#6918)
https://github.com/python/cpython/commit/0c62e09774e445a185fd192524454ce697ca123b


--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32216] Document PEP 557 Data Classes (dataclasses module)

[Barry A. Warsaw]

Change by Barry A. Warsaw :


--
stage: patch review -> resolved
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32216] Document PEP 557 Data Classes (dataclasses module)

[miss-islington]

Change by miss-islington :


--
pull_requests: +6586

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32216] Document PEP 557 Data Classes (dataclasses module)

[Barry A. Warsaw]

Barry A. Warsaw  added the comment:


New changeset 713a9367366c88662c39ed20dd6bce22399299f1 by Barry Warsaw in 
branch 'master':
bpo-32216: Update dataclasses documentation (#6913)
https://github.com/python/cpython/commit/713a9367366c88662c39ed20dd6bce22399299f1


--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32216] Document PEP 557 Data Classes (dataclasses module)

[Barry A. Warsaw]

Change by Barry A. Warsaw :


--
pull_requests: +6581
stage: resolved -> patch review

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32216] Document PEP 557 Data Classes (dataclasses module)

[Barry A. Warsaw]

Barry A. Warsaw  added the comment:

...although I unfortunately cannot build it because of Issue33543

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32216] Document PEP 557 Data Classes (dataclasses module)

[Barry A. Warsaw]

Barry A. Warsaw  added the comment:

I've got a branch that cleans up and updates the dataclasses documentation, so 
I'm reopening this issue and piggybacking my PR on it.

--
status: closed -> open

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32216] Document PEP 557 Data Classes (dataclasses module)

[Eric V. Smith]

Eric V. Smith  added the comment:

I've added some initial documentation. Most of it is text from the PEP, cleaned 
up and sphinx-ized. It no doubt needs a lot of work, but I think it's good 
enough to close this issue and remove the release blocker. Changes to the 
documentation can be done going forward, including after 3.7.0rc1 is released.

--
assignee: docs@python -> eric.smith
priority: release blocker -> 
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32216] Document PEP 557 Data Classes (dataclasses module)

[miss-islington]

miss-islington  added the comment:


New changeset 04e96da5e4982afeb639d6a4d232c6c221fe3a9d by Miss Islington (bot) 
in branch '3.7':
bpo-32216: Add documentation for dataclasses (GH-6886)
https://github.com/python/cpython/commit/04e96da5e4982afeb639d6a4d232c6c221fe3a9d


--
nosy: +miss-islington

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32216] Document PEP 557 Data Classes (dataclasses module)

[miss-islington]

Change by miss-islington :


--
pull_requests: +6566

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32216] Document PEP 557 Data Classes (dataclasses module)

[Eric V. Smith]

Eric V. Smith  added the comment:


New changeset 98d50cb8f57eb227c373cb94b8680b12ec8aade5 by Eric V. Smith in 
branch 'master':
bpo-32216: Add documentation for dataclasses (GH-6886)
https://github.com/python/cpython/commit/98d50cb8f57eb227c373cb94b8680b12ec8aade5


--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32216] Document PEP 557 Data Classes (dataclasses module)

[Eric V. Smith]

Change by Eric V. Smith :


--
keywords: +patch
pull_requests: +6560
stage: needs patch -> patch review

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32216] Document PEP 557 Data Classes (dataclasses module)

[Raymond Hettinger]

Raymond Hettinger  added the comment:

Mariatta, go ahead and take the lead on this one.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32216] Document PEP 557 Data Classes (dataclasses module)

[Eric V. Smith]

Eric V. Smith  added the comment:

Note that the documentation should make the implications of #33453 very clear.

In short, if an annotation "looks like" a ClassVar or InitVar, it will be 
treated as such. This is true even if it's specified as a string, or if it's a 
string due to "from __future__ import annotations".

I'm planning on specifying more details in #33453.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32216] Document PEP 557 Data Classes (dataclasses module)

[Ned Deily]

Ned Deily  added the comment:

We really need to get this done prior to 370rc1 coming up on 05-21.

--
priority: deferred blocker -> release blocker

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32216] Document PEP 557 Data Classes (dataclasses module)

[Lino Mastrodomenico]

Lino Mastrodomenico  added the comment:

Friendly ping, there's still no documentation for this wonderful new module and 
there's only one planned beta left for 3.7 before the release candidates.

Needless to say, https://www.python.org/dev/peps/pep-0557/ has lots of 
information that could be a starting point.

--
nosy: +mastrodomenico

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32216] Document PEP 557 Data Classes (dataclasses module)

[Mariatta Wijaya]

Mariatta Wijaya  added the comment:

> I've already started on drafting these docs.  Would you like to work together?

Sure, Raymond. Let me know how I can help :)

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32216] Document PEP 557 Data Classes (dataclasses module)

[Christopher Barker]

Christopher Barker  added the comment:

Thanks Raymond. Can a draft be put in a gitHub repo so we can all help out?

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32216] Document PEP 557 Data Classes (dataclasses module)

[Raymond Hettinger]

Raymond Hettinger  added the comment:

> I'd be interested to help write the PR for this.

I've already started on drafting these docs.  Would you like to work together?

--
nosy: +rhettinger

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32216] Document PEP 557 Data Classes (dataclasses module)

[Mariatta Wijaya]

Mariatta Wijaya  added the comment:

I'd be interested to help write the PR for this.

--
nosy: +Mariatta

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32216] Document PEP 557 Data Classes (dataclasses module)

[Ned Deily]

Ned Deily  added the comment:

Marking this as a "deferred blocker" for exiting the beta phase.

--
nosy: +ned.deily
priority: high -> deferred blocker
stage:  -> needs patch
versions: +Python 3.8

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32216] Document PEP 557 Data Classes (dataclasses module)

[Eric V. Smith]

Eric V. Smith  added the comment:

I was hoping a volunteer would step up to write the documentation, as it's 
definitely not my forte.

Raymond has also volunteered to help.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32216] Document PEP 557 Data Classes (dataclasses module)

[Barry A. Warsaw]

Barry A. Warsaw  added the comment:

Do you have an ETA for the documentation PR?  I would be happy to review it.

--
nosy: +barry

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32216] Document PEP 557 Data Classes (dataclasses module)

[STINNER Victor]

STINNER Victor  added the comment:

My Issue32406 has been marked as a duplicate of this one. Copy of my message:

bpo-32214 "Implement PEP 557: Data Classes" added a new dataclasses module and 
was closed, but the new module is not documented:
https://docs.python.org/dev/library/dataclasses.html

And it's also missing from What's New in Python 3.7:
https://docs.python.org/dev/whatsnew/3.7.html

--
nosy: +vstinner

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue32216] Document PEP 557 Data Classes (dataclasses module)

[Eric V. Smith]

Change by Eric V. Smith :


--
title: Document PEP 557 Data Classes -> Document PEP 557 Data Classes 
(dataclasses module)

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com