Where to take this project: direction, thoughts, proposals

[decentral1se]

Following the recommendation in python/typeshed#1702 (comment) of:

I actually recommend waiting for PEP 561 and its implementation. Having incomplete stubs in typeshed (which I presume the machinalis stubs are) is worse than no stubs, as we've found out with some other packages (sqlalchemy was actually withdrawn for this reason).

I think we need to orientate the development of this repository specifically around how PEP 561 will work and whatever work flow is necessary to support that integration.

There are some notes around this on the mypy documentation:

• https://mypy.readthedocs.io/en/latest/installed_packages.html#making-pep-561-compatible-packages

I see no existing ticket regarding adding type hints on the Django tracker:

• https://code.djangoproject.com/search?q=type+hints&noquickjump=1&changeset=on&milestone=on&ticket=on&wiki=on

It probably makes sense to drop a mail on the dev list to see where we can coordinate.

Open to any thoughts!

I can put an hour or two each week and use Django in my day to day work, so I would definitely like to have access to the type hint system going forward. It's also a way to give back to the Django community which really has got me a long way so far ...

[decentral1se]

Here's some discussions from the Django development mailing list:

• https://groups.google.com/forum/#!searchin/django-developers/type$20hint|sort:date/django-developers/s5yW3kt5JEA/POgy8coxBAAJ
• https://groups.google.com/forum/#!searchin/django-developers/type$20hint|sort:date/django-developers/trTEbURFhEY/H3WsHV5pDgAJ

Oh, right, it seems someone has already started to do this:

• https://www.djangoproject.com/weblog/2016/jun/30/pycharm-and-django-fundraiser/

However, I then saw this:

The JetBrains announcement that they want to fund the project isn't a guarantee that it'll be implemented. The feature needs to go through the normal feature acceptance process, which as Markus said, might involve a DEP.

Assuming the idea is accepted, my sense on timing would be to wait until January when Django drops support for Python 2.7 and 3.4 in master. Then we could use inline annotations rather than the stub files.

Past discussions of type hinting:
https://groups.google.com/d/topic/django-developers/z_P1TvJ6QG8/discussion
https://groups.google.com/d/topic/django-developers/xOTmq93YZuQ/discussion

It seems others were waiting for PEP 561 as well.

I'll create a new mail on the development list and see what kind of traction it gets.

[decentral1se]

Just fired a mail at https://groups.google.com/forum/#!forum/django-developers.

Hasn't appeared just yet but should at some point. Hopefully discussion moves along there.

EDIT: https://groups.google.com/forum/#!topic/django-developers/xB3kla9RJbo

[decentral1se]

Closing off, things have come along, we're focusing work over at:

https://github.com/TypedDjango/django-stubs#django-stubs