DOC: Format more code blocks

[dsaxton]

Actually, contrary to #36700 (comment) there is quite a lot more clean up to do (so maybe could make for some good first issues @simonjayhawkins), it's just that other docs contain blocks that blacken-docs can't parse (e.g., raw output or ipython code containing magic commands). A workaround is to comment them out, parse the doc, and then uncomment (the commented blocks would then have to be edited manually).

Is it possible to render blocks like this as pure code in rst which are allowed to raise?

   .. code-block:: python

       >>> pd.DataFrame(np.random.randn(10, 2)).to_hdf('test_fixed.h5', 'df')
       >>> pd.read_hdf('test_fixed.h5', 'df', where='index>5')
       TypeError: cannot pass a where specification when reading a fixed format.
                  this store must be selected in its entirety

[jreback]

Actually, contrary to #36700 (comment) there is quite a lot more clean up to do (so maybe could make for some good first issues @simonjayhawkins ), it's just that other docs contain blocks that blacken-docs can't parse (e.g., raw output or ipython code containing magic commands). A workaround is to comment them out, parse the doc, and then uncomment (the commented blocks would then have to be edited manually).

Is it possible to render blocks like this as pure code in rst which are allowed to raise?

   .. code-block:: python

       >>> pd.DataFrame(np.random.randn(10, 2)).to_hdf('test_fixed.h5', 'df')
       >>> pd.read_hdf('test_fixed.h5', 'df', where='index>5')
       TypeError: cannot pass a where specification when reading a fixed format.
                  this store must be selected in its entirety

yes you can add :okexcept: though to be honest it doesn't look as nice I think (maybe there is a way to limit the traceback)

[WillAyd]

lgtm

[jreback]

thanks @dsaxton

[jorisvandenbossche]

IMO this is not an improvement for the specific purpuse here: reading a csv file. To visualize how the csv file looks, the way it was before is better I think. Could also use multi-line string """, which is maybe more "black-proof"

[jorisvandenbossche]

(and the same for all the ones below)

[jorisvandenbossche]

Also, we should not use black's default line length limit of 88, because that will not fit in the code block width of the doc page. For example, this line is 85, and only fits exactly. So anything bigger will cause overflow/scrollbar.

[dsaxton]

Yeah I was wondering about this afterwards, will work on fixing these