v4.0.0?

[edsu]

Given the recent changes to the leader, I was thinking that a new major release was warranted, v4.0.0. Are there any other major changes we might want to consider as part of this release, or should we just go for it?

[edsu]

One thing i was wondering about, given the fact that more people have contributed to the project than are listed in the copyright statement, is whether it might be good to move the code to being in the Public Domain and not asserting copyright or a license of any kind. What do people think about that, especially @gsf, @anarchivist and @Wooble?

[gsf]

I'm not up to date on the latest moods around licensing, so don't know if there are negatives around going public domain, but I hereby relinquish my copyright claim if you decide to do so.

[anarchivist]

I'm all for a public domain but I would ask us to consider an explicit license or declaration like CC0 or the Unlicense. We could also consider 0BSD along with an explicit copyright waiver.

[anarchivist]

I also relinquish my copyright claim.

[herrboyer]

@edsu maybe it could be time to announce the end of py2 support ? For now by just updating the readme/docs/setup.py/travis.yml, and, one day, do a big cleanup (linting, proper typing, no more six, etc.) that will definitely break py2 compatibility.

[Wooble]

same; I have no strong opinion either way as long as whatever we do doesn't make it suddenly hard for some subset of our users to keep using the library. (IANAL but I've heard vague things about public domain not being a thing in some jurisdictions?)

[this is re: copyright, not py2 support. I'm more than happy to make the subset of our users who refuse to use py3 unhappy ;) ]

[edsu]

@Wooble yes, I think that's an argument for using CC0 as @anarchivist suggested. Thanks everyone for being open to exploring this.

@herrboyer do you think now is the time to lint and type, and remove six?

[herrboyer]

It's always time to lint !

I think a combination of flake8 + flake8-docstring + black would provide a clean base for future development.

I use this config for most of my projects :

[flake8]
ignore = 
	# line length is handled by black
	E501
	# Missing docstring in public nested class (ex. Meta)
	D106
	# Missing docstring in magic method (__str__ ...)
	D105
	# First line should be in imperative mood -> I've never really like/understood this one...
	D401
	# E203 & W503 are not PEP 8 compliant
	# @see https://github.com/psf/black
	W503
	E203
per-file-ignores =
	# empty init does not really require doctrings
	__init__.py D104
	# no need for doctrings in tests
	test_* D103

And we could easily add a step in the CI to check linting before running the tests, this will avoid noise related to formatting in future PRs.

I'll be happy to work on this if everybody's OK with it.

Then we could work on typing and removing six / py2 support ?

[edsu]

This would be awesome @herrboyer and is worth waiting for in v4 I think. I will create new issues for both pylint and python3. If you take the first then I will take the latter (but I will wait till linting is completed before doing it).

I haven't used types much in my own work, does your linter setup do something with them?

[herrboyer]

Great ! I started working on #148 here #150 : please note that I plan to use flake8 instead of pylint which is a bit easier to configure (and to please...).

You'll be using mypy to check types the same you use flake8/pylint for linting (mypy something.py).
Default settings are OK, the only downside of it is that mypy will not raise an error nor a warning when you leave function parameters or returns un-typed.

I think this Python Type Checking (Guide) helped me when I started typing my code especially with custom types, Dict, Union, etc.

[dbs]

I only have a handful of commits in the project's history, and I'm not listed in the contributors list, but I would prefer to maintain the current well-understood permissive license.

I don't think moving to a public domain-type license would remove the burden of maintaining a list of code contributors. See the CC0 FAQ:

CC and the Free Software Foundation suggest that if you choose to apply CC0 to software, you include the following notice at the top of each file:

<PROGRAM NAME> - <DESCRIPTION>

Written in <YEAR> by <AUTHOR NAME> <AUTHOR E-MAIL ADDRESS>

[other author/contributor lines as appropriate]

To the extent possible under law, the author(s) have dedicated all copyright and related and neighboring rights to this software to the public domain worldwide. This software is distributed without any warranty.

You should have received a copy of the CC0 Public Domain Dedication along with this software. If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.

They suggest this because, under the copyright law of many nations, anything you write automatically falls under copyright by you, and you somewhat paradoxically have assert your copyright to be able to license it or dedicate it to the public domain. Given that licensing is the focus of their organizations, it's probably best to take it seriously.

If the real problem is that it's a drag to list all of the contributors, could we solve this problem with code? e.g. something like using "git blame" to generate a list of all of the contributors to a given release and use that to create an accurate first line of the LICENSE file?

[dbs]

On that last point, building on this StackOverflow suggestion, here's what the current master branch list of contributors looks like:

$ git ls-tree -r -z --name-only HEAD -- */*.py | xargs -0 -n1 git blame --line-porcelain HEAD |grep  "^author "|sort|uniq -c|sort -nr
  17992 author Ed Summers
    856 author Jim Nicholls
    185 author Geoffrey Spear
    170 author Dan Michael O. Heggø
    135 author Dan Scott
    118 author Martin Czygan
    114 author Mark A. Matienzo
     54 author Gabriel Farrell
     51 author Victor Seva
     41 author Adam Constabaris
     38 author Mikhail Terekhov
     36 author cyperus-papyrus
     34 author Will Earp
     34 author David Chouinard
     25 author wrCisco
     19 author Sean Chen
     12 author Godmar Back
     12 author gitgovdoc
     11 author Simon Hohl
     10 author André Nesse
      9 author Karol Sikora
      7 author Robert Marchman
      5 author mmh
      4 author jmtaysom
      4 author Helga
      3 author eshellman
      3 author Edward Betts
      2 author Ted Lawless
      2 author Radim Řehůřek
      2 author Michael B. Klein
      2 author Dan Chudnov
      1 author nemobis
      1 author Michael J. Giarlo
      1 author Ed Hill

It's not perfect but maybe not so bad to run once per tag/release?

[anarchivist]

Incidentally, I switched a work project last fall to use all-contributors. I happen to like it, but I won't push for it too hard since it adds another set of dependencies (Node + associated modules) to the toolchain. (There's a bot too that uses Github actions, but I haven't used it.)

[edsu]

@anarchivist thanks for sharing that! How did you end up expressing the copyright statement--was it an institution?