Move to Python 3.11 baseline; increase blocklist import verbosity

[eloquence]

• Bump Python version to 3.11
• Updated dependencies require us to declare html-clean extra
• We previously did not declare bs4 dependency even though it's used in our blocklist; this won't work in production. Added it to dependencies explicitly
• Silently failing blocklist.py import as a result of the above was a bit annoying to debug; made the logic a bit more verbose so we can catch such issues more quickly in future
• Provided an abstract base class for blocklists
• Updated CI to use Python 3.11
• Tweaked .gitignore to catch all pycache directories

Resolves #62

[harrislapiroff]

I offer one comment as food for thought, but am happy to provisionally approve this for your merge, once considered @eloquence

[harrislapiroff]

I'm ambivalent about this. If it's not being used by the core script, it feels like this should be codified in the specific implementation that's using it instead. Like, ideally, our internal ttnconfig repo that includes the blocklist should have a separate requirements spec that lists both ttn and bs4. (If someone else wanted to use PyQuery for example, they'd still have to install that themselves.)

(Looks like I actually removed this requirement in the past for similar reasons heh 64bcb02)

On the other hand, this is a small project that's only used by a handful of people besides us, so I'd accept if it feels like too much bikeshedding to debate this. Probably not a big deal to include.

[eloquence]

What do you think about dropping an abstract base class in this repo that does import bs4? Basically, more of an opinionated plugin-style design pattern intended to minimize the complexity folks may have to wrangle to add something like a basic blocklist.

[harrislapiroff]

Sure, sounds reasonable enough!

[eloquence]

OK, I'll poke at this still in this PR, dragging back to WIP until that's done

[eloquence]

This is now done; I've avoided importing BeautifulSoup in the ABC since it serves no purpose there, but I've annotated pyproject.toml to make it clearer why it's there.

[eloquence]

Back to you Harris; if this looks good, we'll need to land freedomofpress/foiafeed-ttnconfig#3 alongside it.

[harrislapiroff]

We're still not using bs4 in this repo, which is what I thought you meant 😅 But I also don't need to overlitigate this one common dependency. It's good, let's merge!

[eloquence]

I did mean that originally, but importing it in an abstract base class and then not using it there will just make the linter unhappy, so I went with the "comment the dep" approach instead.