Add `-Werror` to pyproject.toml

[jsignell]

It could be a nice improvement to add -Werror to the pytest addopts in pyproject.toml

Originally posted by @jsignell in #832 (comment)

[nlebovits]

@jsignell I can take this. I'd have added it to the previous PR but was traveling for work.