#sphinx-doc

I was trying not to be utterly useless, I spent about an hour looking at contrib repos and other extensions nicola_fm, do you rememberwhat it may have been called?

Ummmmmm....

autorun?

py_directive?

https://bitbucket.org/birkenfeld/sphinx-contrib (those are from this url)

And anything from here: http://sphinxext-survey.readthedocs.io/en/lates...

Thanks! will research

Yeah, I think it'll be best to write my own extension

At least you have a few options to base it on now. :)

success! :D

Wrote my own

https://imgur.com/a/8Faex -- https://gist.github.com/jpsenior/95c5484efd8e9d...

pretty simple, very effective...

Thanks for the hints nicola_fm

lots of stackoverflow theft :

:)

[02sphinx] 07tk0miya pushed 037 commits to 03master [+6/-26/±13] 13https://github.com/sphinx-doc/sphinx/compare/...

[02sphinx] 07tk0miya 03ae3b761 - Add testcase for pycode interface

[02sphinx] 07tk0miya 0357667b5 - Add testcase for oneliner

[02sphinx] 07tk0miya 03b1f8042 - Add testcase for sphinx.util.docstrings

[02sphinx] ... and 4 more commits.

isn't there a thing in Sphinx that allows me to run code and take the result and have that be the content for the docs

as a way to generate examples from actual code instead of hard coding them for example

Last day or so I was struggling to do the same, bmbouter, ended up writing my own extension

i might release it when I clean it up and complete the features

sartan: cool ty

Some examples that nicola_fm pointed at me was autorun, py_directive

I checked out sphinx-autorun, it had a weird parser that was kind of tied to docstring constructs

you might find some luck with the doctest module as well depending on your requirements

bmbouter: do you have an example of what you would like to input and what you would like to see as output?

i'm writing a super feature rich 'execute code' for internal usage right now, can cater to your requirements as well

sartan: it's mostly around demonstrating API responses. our docs have a live API available so we can def run things against it and use the response as output

also cli calls to some extent

i hear you, 100% what i am doing

bmbouter: try this: https://gist.github.com/jpsenior/4e0f518e760ea1...

I've got an execute_code directive that will accept python code to highlight, will execute it, and render(and highlight) results. Can also load from a filename -- did that so I can separately unit test api samples

sartan: that looks really legit but I can't try it right now

especially having them outside of the docstrings is nice

sartan: you going to publish an alpha on PyPI?

Yeah, I think so... I found all the other alternatives pretty lacking

no offense to anybody who wrote any of them

what do you mean by 'having hte outside of the docstrings' ?

Anyone know if there's a way in sphinx with the RTD theme to have the menus in the toctree all start completely collapsed, showing only the :caption: of each item?