search

gilch / hissp

It's Python with a Lissp.
https://gitter.im/hissp-lang/community
Apache License 2.0
364 stars 9 forks source link

Docs increment #207

Closed gilch closed 1 year ago

gilch commented 1 year ago

Improved the syntax highlighting in the docs. Moved another example.

I also modified spy# and time# so they can take an Extra file argument. This is because doctests can't handle stderr (only tracebacks). I considered patching with the mock library, which did work. I also considered just using stdout, but I do feel that stderr is a better default. Being able to change the print file makes the macros slightly more useful but is this bloat? The changes were super small and easy with the current extra system though. Test-induced design damage? I kind of did something similar to prelude when I allowed it to take an ns argument. This seems fine.

gilch commented 1 year ago

And somehow missed some highlighting failures. Sometimes I have to delete the Sphinx build directory before I get a true doc build. Looks like these are cases where a traceback occurred at read time, preventing the PythonConsoleLexer from being applied due to the lack of any Python prompt.