Type annotations

[roberto-arista]

The aim of this pull request is to add type annotations to the drawBot public interface. Here are the main things @typemytype and I worked on:

• Adding annotations and fix the bugs the annotations exposed
• Adding annotations to the tools/imageObject.py module did not seem clever, since it's automatically generated from the Core Image Filters. @typemytype found the original Python script on his drive and we updated it to support annotations and add general improvements.
• On the same line, the drawBot.__init__.py file is partially generated to expose the instance methods outside, allowing from drawBot import whatever and benefiting from the annotations in the code editor

Additionally, we made some other minor fixes:

• Removed wildcard imports from drawBot test scripts (type annotations benefit)
• Updated the image URL (from Cloudflare to GitHub) and related test images
• Updated the README

Some tests are failing on my OS (Sonoma 14.4.1). Looking at the difference.pdf, it mostly seems to be related to hinting, hyphenation, text baseline shift, and blending of colors. Depending on the OS GitHub will use to run the tests, the tests might keep failing or not.

We still need to generate automatically basic tests for the ImageObject class. We plan to work on it next week.

[typemytype]

🙌 super!! thanks

[roberto-arista]

thank you for all the support and guidance

[typemytype]

this looks good to me!

sphinx doc building is also adjusted and improved

[roberto-arista]

How is it going with the review process? @typemytype @justvanrossum

[justvanrossum]

How is it going with the review process?

Apologies! I will continue soon.

[justvanrossum]

I started to do a new review, and left some comments. But then I came across my earlier feedback which seems to have not been addressed at all, so I'll stop here.

[roberto-arista]

I'll go through them on Monday!

[roberto-arista]

Hey @justvanrossum! @typemytype and I fixed the issues you highlighted. You can proceed with the review 🤓

[typemytype]

@justvanrossum I would like to finish this PR :)

[justvanrossum]

I would like to finish this PR :)

I can imagine! :)

There's still a bunch of unresolved feedback, though. (And some feedback that has been resolved, but not marked as resolved.)

[roberto-arista]

I think I resolved all the issues. There are commit links too. Am I missing something?

[justvanrossum]

Just go to “show hidden” and within that one more time.

[typemytype]

To be honest, looking to outdated hidden message is a bit confusing... but hurray found them deep inside the comment stream!

[roberto-arista]

@justvanrossum I should have answered to all the issues. Please, if there's something missing tag me directly, as the PR interface is getting a bit confusing, thanks!

[roberto-arista]

Hey! Can I do anything to move the ball forward?