Package for alpha release

[willzeng]

For an alpha release we'll want to ensure at least that:

• [x] available via pip
• [x] make the release on github
• [x] docs are building and available publicly
• [ ] some way to track citations of the github [Edit: arXiv paper]

[nathanshammah]

• [x] I added readthedocs to the apps integrated with my current Github account and granted access to unitaryfund's Github organization repos. It indeed sees unitaryfund/unitary-fund. We will need to wait for the mitiq repo to be public to trigger the build and see if it works. To remove ads one needs the gold membership (5$/month), an option that comes free with github pages. I wonder if readthedocs is still required nowadays or is a relic of the past OSS ecosystem. We could have unitaryfund.gitbhub.io/mitiq, or redirect to unitaryfund website. The only problem is that this GH pages build works with the master branch only. So, maybe, readthedocs is still valuable (it allows for multiple version releases).

[nathanshammah]

• [x] Add to PyPI the v0.1a1 release, used in the workshop. This can be done from a zipped version, no need for the repo to be public.

It will be useful to have that version on PyPI – it will also match the first Github release. We'll then update with the subsequent release signaling the closing of this milestone Alpha v4 (on both PyPI and GH, and possibly also on conda-forge if we wish).

[nathanshammah]

@willzeng @rmlarose @andreamari can you please test locally that the Test PyPI version works for you or you can reproduce my error (I'm on mac)? You can do in a new environment:

conda create -n testpypi37 python=3.7
conda activate testpypi37
pip install -i https://test.pypi.org/simple/ mitiq==0.1a1

The following error appears:

ERROR: Could not find a version that satisfies the requirement scipy~=1.4.1 (from mitiq==0.1a1) (from versions: 0.1)
ERROR: No matching distribution found for scipy~=1.4.1 (from mitiq==0.1a1)

both for python 3.7 and 3.8 fresh new conda environments. I faintly remember encountering a similar issue for version 0.0.0.

When this is sorted out, I'll update also on PyPI.

[willzeng]

I followed these instructions and got this error:

ERROR: Could not find a version that satisfies the requirement numpy~=1.18.1 (from mitiq==0.1a1) (from versions: 1.9.3)
ERROR: No matching distribution found for numpy~=1.18.1 (from mitiq==0.1a1)

Am on Python 3.7.2

Regarding github pages vs. readthedocs. I'm fine either way, just pick whichever you'll find easier. $5 a month is no big deal

[andreamari]

@nathanshammah I get for both cases (Python 3.7 and 3.8) the same error as Will:

ERROR: Could not find a version that satisfies the requirement numpy~=1.18.1 (from mitiq==0.1a1) (from versions: 1.9.3)
ERROR: No matching distribution found for numpy~=1.18.1 (from mitiq==0.1a1)

[nathanshammah]

@willzeng @andreamari please retry with

pip install -i https://test.pypi.org/simple/ --extra-index-url https://pypi.python.org/simple/ mitiq==0.1a1

It looks like testpypi is looking for the required dependencies therein (indeed numpy is there only for v. 1.9) instead that on the real pypi.

[andreamari]

@nathanshammah it works for me!

[willzeng]

@nathanshammah This worked for me as well. Should we be thinking about upgrading our numpy dependency? We could make a separate issue for that.