blog page - 1/5¶
Missing signature for functions¶
Upload a single binary on PyPI¶
The packages for multiple distribution are built
on different machine but the upload takes place on
a single machine. I retrieved all available builds
and moved them to the dist folder.
.pypirc was saved into my home with
the following content:
Check RST syntax¶
It is usually a pain to discover I made an error in a
formula while I’m writing documentation. It fails
quite long after after the unit tests started. The
documentation is generated after the unit test pass.
I also use a lot
to run pieces of code inside the documentation.
It is quite annoying to discover it fails long after.
So I creates a unit test which can be used to compile a
single page of the documentation :
I modify the page name when I have some doubt or I move to
Long names on Windows¶
pip 9.0.2 and issue with pip._vendor.urllib3.contrib¶
pip was recently updated and the new version produces a weird error:
Replace pdflatex by xelatex¶
Turn warnings into errors¶
The following code turns warnings into errors. Useful to find the source of a warning.
Issue in ZipFile on Windows¶
Issue 6839 happens when
a zip file is created on Windows. The created zip may contain
full path with
\\ when the file list only contains
This raises exception
BadZipFile with the following message:
File name in directory … and header … differ due to a mismatch
between backslashes. Another consequence found on GitHub:
zipfile raises: File name in directory X and header Y differ..
owerwrites method zipfile.ZipFile.open
to fix the line which checks that names are consistent in the file list
and in the compressed content.
Issues with sphinx-gallery¶
Taking another dependency always means a potential conflicts between version. Is it fact enough updated when it breaks? I realized I was not the only to face an issue with sphinx-gallery. There is a discussion about it on scikit-learn/9189 and the package is now included in the sources. It is not really bothering for a small package like this. But still, it is extra work. I realize open source holds on some kind of magic sometimes. Some are fun but keeping them alive takes some energy.
Pandoc on ubuntu and WSL¶
I was using the Windows Subsystem for Linux
to test a module with Linux. I could not make it work
due to an old version of pandoc.
Surprisingly, the default
apt-get install pandoc installed
a very old version (1.12). I could not convert any notebook
with nbconvert into latex.
I finally installed the latest version (1.19) and it worked perfectly.
You can see the installation step in file
That was not the last issue because
pandoc seems to be very slow on WSL.
About that, you can read:
massive delay to call pandoc using the Windows Subsystem for Linux (WSL) or Bash for Windows,
stack ghc painfully slow.