machow / quartodoc

Generate API documentation with quarto
https://machow.github.io/quartodoc
MIT License
186 stars 21 forks source link

Instructions for installing dev version don't work if deps are not already installed #105

Closed wch closed 1 year ago

wch commented 1 year ago

Output:

$ python3 -m pip install -e git+https://github.com/machow/quartodoc.git#egg=quartodoc
Obtaining quartodoc from git+https://github.com/machow/quartodoc.git#egg=quartodoc
  Updating ./src/quartodoc clone
  Running command git fetch -q --tags
  Running command git reset --hard -q 681404024b5e7163559dcdaa88ee795ea2489ac5
  Installing build dependencies ... done
  Checking if build backend supports build_editable ... done
  Getting requirements to build editable ... done
  Preparing editable metadata (pyproject.toml) ... done
Collecting griffe==0.25
  Using cached griffe-0.25.0-py3-none-any.whl (87 kB)
Collecting sphobjinv
  Using cached sphobjinv-2.3.1-py3-none-any.whl (51 kB)
Collecting tabulate
  Using cached tabulate-0.9.0-py3-none-any.whl (35 kB)
Collecting importlib-metadata
  Using cached importlib_metadata-6.3.0-py3-none-any.whl (22 kB)
Collecting panflute
  Using cached panflute-2.3.0-py3-none-any.whl (36 kB)
Collecting pydantic
  Using cached pydantic-1.10.7-cp311-cp311-macosx_11_0_arm64.whl (2.5 MB)
Collecting typing-extensions
  Using cached typing_extensions-4.5.0-py3-none-any.whl (27 kB)
Collecting plum-dispatch
  Using cached plum_dispatch-2.0.1-py3-none-any.whl (27 kB)
Collecting colorama>=0.4
  Using cached colorama-0.4.6-py2.py3-none-any.whl (25 kB)
Collecting zipp>=0.5
  Using cached zipp-3.15.0-py3-none-any.whl (6.8 kB)
Collecting click<9,>=6
  Using cached click-8.1.3-py3-none-any.whl (96 kB)
Collecting pyyaml<7,>=3
  Using cached PyYAML-6.0-cp311-cp311-macosx_11_0_arm64.whl (167 kB)
Collecting beartype
  Using cached beartype-0.13.1-py3-none-any.whl (707 kB)
Collecting attrs>=19.2
  Using cached attrs-22.2.0-py3-none-any.whl (60 kB)
Collecting certifi
  Using cached certifi-2022.12.7-py3-none-any.whl (155 kB)
Collecting jsonschema>=3.0
  Using cached jsonschema-4.17.3-py3-none-any.whl (90 kB)
Collecting pyrsistent!=0.17.0,!=0.17.1,!=0.17.2,>=0.14.0
  Using cached pyrsistent-0.19.3-cp311-cp311-macosx_10_9_universal2.whl (82 kB)
Building wheels for collected packages: quartodoc
  Building editable for quartodoc (pyproject.toml) ... done
  Created wheel for quartodoc: filename=quartodoc-dynamic-0.editable-py2.py3-none-any.whl size=4480 sha256=abfe3c3d35fe32dc73bef3dc2675ec857e0649c413d33048dd57bcebe0857be7
  Stored in directory: /private/var/folders/vd/0_g4hj6d7kq_fw5gd_r0ml5w0000gn/T/pip-ephem-wheel-cache-17nlp31a/wheels/6c/d2/c3/e824117c292ad774f70d34dcbad782adda04bacaf896285c62
  WARNING: Built editable for quartodoc is invalid: Metadata 1.2 mandates PEP 440 version, but 'dynamic' is not
Failed to build quartodoc
ERROR: Could not build wheels for quartodoc, which is required to install pyproject.toml-based projects
machow commented 1 year ago

Do you mind posting python --version and python -m pip --version? It seems like something else is going on, but I'm not able to replicate.

I wonder if this is using a fairly old version of pip? (edit: or maybe a much newer version?) There might be a small pyproject.toml tweak that needs to happen...

wch commented 1 year ago

Hm, I'm not able to reproduce this now. It's possible that's because I upgraded from 3.11.2 to 3.11.3 yesterday, after filing this issue. I was running this with a clean venv both yesterday and today.

Feel free to close this issue, since I can't reproduce it.

machow commented 1 year ago

Oh weird--definitely re-open if you run into it again!