Serving documentation with a simple server.

[gresm]

As discussed in here running python -m pygame.docs in some circumstances may fail - when a default browser is a non-classic snap package and pygame-ce library is installed in a .hidden folder (dotted), as those folders snaps can't access. This pull request solves this issue by introducing another method of opening documentation - running a simple local server for this purpose (with python -m pygame.docs.serve) while not changing the original behavior.

[gresm]

Wasn't really sure whether I should and stubs, as I was changing the part of code without it, but I guess that it isn't that bad idea.

[ankith26]

I'm now thinking we could just make it so that py -m pygame.docs creates a local server and opens it in the browser by default. This change shouldn't be too disruptive right?

[gresm]

It shouldn't, but I didn't want to change the default behavior.

[ankith26]

I'm fine with changing behaviour for this specific case, but let's wait for what others would say and then accordingly move this PR forward

[Starbuck5]

What about changing the default behavior on Linux only?

That way we can test it out as the default without risking it breaking for as many people.

[gresm]

@Starbuck5 It probably will be confusing for some people, but I can re-implement this in the way that one can use python -m pygame.docs.serve to explicitly run server, python -m pygame.docs.static to explicitly use default behavior and python -m pygame.docs to let the program decide itself.

[ankith26]

Left a review, but apart from that this PR LGTM.

Thanks for the PR 🥳

[gresm]

Can someone rerun the test?

[oddbookworm]

Can someone rerun the test?

Running now

[MyreMylar]

LGTM 👍