Commit Graph

45 Commits

Author SHA1 Message Date
Hynek Schlawack 6151683244
Eliminate most str.format() and %-formatting (#995)
* Eliminate most str.format() and %-formatting

* Add newsfragment
2022-08-10 12:41:46 +02:00
wouter bolsterlee a22e98c6cb
No longer explicitly subclass ‘object’ (#940)
This is no longer relevant in Python 3+. Follow-up to !936.

Co-authored-by: Hynek Schlawack <hs@ox.cx>
2022-03-21 10:35:44 +01:00
Hynek Schlawack 980c8b04f5
Drop Python 2.7 (#936)
* Drop Python 2.7

The tooling situation around Python 2 has deteriorate to such a degree that
upholding compatibility is not tenable anymore for a volunteer-run project.

Signed-off-by: Hynek Schlawack <hs@ox.cx>

* Add newsfragment

* Run Python 3.5 under coverage to make up for Python 2.7

* Wait for py35 in parallel

* Remove fullmatch kludge

* Remove Python 2-specific code

* Revert empty slot test

Also disable pyupgrade on that file.

Signed-off-by: Hynek Schlawack <hs@ox.cx>

* We DO run under 3.5

* Remove __qualname__ workarounds

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* Update changelog.d/936.breaking.rst

Co-authored-by: Tin Tvrtković <tinchester@gmail.com>

* Compare methods using is

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Tin Tvrtković <tinchester@gmail.com>
2022-03-21 08:47:47 +01:00
Hynek Schlawack 112e50fcfa Use :pep:`#` in Sphinx files & move the rest to new URL 2022-03-10 13:58:57 +01:00
Hynek Schlawack 5a21484d42 Expand __slots__ why example 2022-01-23 14:39:28 +01:00
Hynek Schlawack 41afe6e9bf Add 2016 disclaimer 2022-01-23 14:00:56 +01:00
Aaron Stephens f3dfe96b48
docs: fix typos and some grammar (#900)
Co-authored-by: Hynek Schlawack <hs@ox.cx>
2022-01-04 13:46:36 +01:00
Hynek Schlawack cb6627d5f8
Update comparisons to dataclasses (#872)
* Start on why

* Mention graduality

* Better commas

* Add pydantic

* Paragraphs

* Re-order why topics

* typos

* Address comments from @Julian

Co-authored-by: Julian Berman <Julian@GrayVines.com>

* link features we talk about

* Split cumbersome sentence

* give example

Co-authored-by: Julian Berman <Julian@GrayVines.com>
2021-12-24 07:38:35 +01:00
Hynek Schlawack 1e1742a9c5 Anarchy! 2021-02-25 08:46:28 +01:00
Tim Gates ee44563094 Fix simple typo: developement -> development (#600)
* Fix simple typo: developement -> development

* Add towncrier file

* Fix PR number
2019-11-18 08:54:17 +01:00
Hynek Schlawack eec7e43d37 Fix links 2019-10-15 07:44:05 +02:00
Julian Berman 8824dc26c2 Add default_role for Sphinx. (#571)
* Add default_role for Sphinx.

Fix a bunch of broken refs along the way, which become
errors now via -W if you have default_role set.

In theory you can catch those via sphinx-build -n (i.e.
nitpick mode), which IMHO is a decent idea anyhow, but it's
a longer diff to enable that because it'd involve fixing a
bunch of the places that try to reference types that don't
exist (e.g. :type foo: Any value). But obviously can be done.

Also didn't actually use this anywhere yet (the any role),
but will do so in a follow-up if this is acceptable.

* Remove the roles from builtin objects to demo any.

* Style.

* Add z.i to intersphinx.

Enables the link to z.i.Interface.

* Enable nitpick mode.

Fix the remaining broken links or whitelist them via nitpick_ignore.

* Kill all :func:s.

* Kill all :class:es.

* Kill all :doc:s.

* Kill all :ref:s.

Except one, that probably meant :func:, and which
is a duplicate ref.

* Kill :exc: and :data:.

* Kill :mod:s.

* Kill new explicit refs from the merge.
2019-09-09 15:02:16 +02:00
Hynek Schlawack 6a07b035b7 Fix a bunch of links 2018-08-20 07:21:02 +02:00
Hynek Schlawack a6955bff7d
Add narrative docs for type annotations (#406)
* Add narrative docs for type annotations

* Better wording

* Use better code-block types

* Add newsfragment for #238 that refers to these docs
2018-07-28 12:05:12 +01:00
Dmitry Yutkin 0a47d2bc05 Fix typo (#390) 2018-06-08 13:10:50 +02:00
Hynek Schlawack eca48ca7f3
Explain our position on Data Classes (#337) 2018-01-29 15:12:05 +01:00
Hynek Schlawack 1357de7471 Make example __hash__ closer to reality
Fixes #327
2018-01-18 11:23:29 +01:00
Hynek Schlawack 9af773bdf3 Better wording 2018-01-16 14:04:32 +01:00
Hynek Schlawack 3d3d49b4dd Prepare for narrative docs (#275) 2017-10-26 17:55:45 +02:00
Ned Batchelder ba9e8bcd24 Tweak the English. (#246) 2017-09-18 14:55:39 +02:00
Hynek Schlawack d08753d2e1 Stress that attrs doesn't take away control 2017-08-21 10:29:42 +02:00
Hynek Schlawack 26a8c8c7b3 Expand notes on namedtuples (#237) 2017-08-21 10:25:29 +02:00
Hynek Schlawack 26c166e08b Rip out characteristic bits
Nobody knows about it anymore.
2017-05-22 17:32:39 -07:00
Hynek Schlawack f7a786ab12 Wortdsmith reasons 2017-03-21 16:49:54 +01:00
Damian Quiroga 4f258d5839 Document another reason why not namedtuples (#163) 2017-03-21 16:40:20 +01:00
Hynek Schlawack 6771640853 Yay https @ arxiv.org 2016-11-24 14:58:15 +01:00
Hynek Schlawack aad822a32b Add a why not dicts section
Fixes #89

Shamelessly ripping off @glyph and @cournape .

Sources:

- https://news.ycombinator.com/item?id=12363487
- https://twitter.com/cournape/status/769120659783950336
2016-09-10 20:27:44 +02:00
Hynek Schlawack 395aa07820 Documentation overhaul 2016-08-15 13:59:04 +02:00
Rosslaew 65f3f4ad44 Update why.rst (#57)
Fix of obvious typo.
2016-08-15 10:03:18 +02:00
JesseWeinstein 2f9826c8dd Doc typo fixes (#56)
Native English speaker fixes
2016-08-15 10:00:23 +02:00
Hynek Schlawack 2da44740ce Fix RTD links 2016-04-28 08:06:10 +02:00
Hynek Schlawack 89b542331d Drop support for legacy Python versions
Keep 2.7 and PyPy though.
2016-02-17 12:51:02 +01:00
Hynek Schlawack 03d779427f Fix spelling of hipster clas 2015-02-10 17:31:21 +01:00
Hynek Schlawack 445b6b2e00 Add these argument to attr.s
Useful for third party classes and when using properties.

Based on feedback by @econchick & @hawkowl
2015-02-08 16:31:16 +01:00
Hynek Schlawack 6a1a740c46 Add one more major advantage 2015-02-07 10:06:08 +01:00
Hynek Schlawack 3f2fd8317d More doc polishing 2015-01-28 16:55:45 +01:00
Hynek Schlawack 372c55318c Add validators 2015-01-28 15:54:41 +01:00
Hynek Schlawack 89b4b4462e Linkify characteristic 2015-01-28 12:59:01 +01:00
Hynek Schlawack c5338ba26e Refine reasons 2015-01-28 12:52:55 +01:00
Hynek Schlawack da4c9ca514 Nobody intends to stop maintaining characteristic 2015-01-27 23:52:11 +01:00
Hynek Schlawack ace17a99eb Add some rationale about why forking characteristic 2015-01-27 23:39:24 +01:00
Hynek Schlawack 58d5c0a767 Get rid of <> in repr
Closes #1
2015-01-27 23:08:55 +01:00
Hynek Schlawack 5ce5e48074 Change attr.a to attr.ib
Closes #2
2015-01-27 23:03:42 +01:00
Hynek Schlawack c7381fd0e2 Gut docs for now 2015-01-27 23:03:04 +01:00
Hynek Schlawack 9560908555 Initial commit
Docs aren't there yet
2015-01-27 17:53:17 +01:00