Skip to content

Install Windows cotdata editable from clone (PyPI 0.1.0 is stale)#47

Merged
mspinola merged 1 commit into
mainfrom
docs-producer-editable-install
Jul 26, 2026
Merged

Install Windows cotdata editable from clone (PyPI 0.1.0 is stale)#47
mspinola merged 1 commit into
mainfrom
docs-producer-editable-install

Conversation

@mspinola

Copy link
Copy Markdown
Owner

What

Reworks Step 3 of the Windows setup guide to install cotdata editable from the cloned repo rather than from PyPI, for both producer and consumer.

Why

PyPI's published release is far behind this repo but still carries the version number 0.1.0. So pip install "cotdata[norgate]" (what the guide told producers to run) installs a build that lacks the entire producer CLI the rest of the docs depend on:

cotdata-update: error: unrecognized arguments: --metadata

A producer following the guide verbatim ends up with a package that imports fine but can't run --prices --metadata --require-final. Hit in practice while setting up a Windows producer.

Changes

  • Step 3 opens with a warning: install from the Step 2 clone, not PyPI, and why (-e also means git pull updates it).
  • Producer and consumer variants are now -e installs from the clone. Producer is listed first since that's the machine that needs the newer CLI. Noted that plain pip install cotdata becomes fine for consumers once a current release is published.
  • Verification no longer trusts the version string — both the clone and the stale PyPI build report 0.1.0, so the guide now says to confirm via cotdata-update --help showing --metadata / --require-final.

Docs-only. Companion issue filed for the version bump + PyPI release that will let this revert to plain pip install.

🤖 Generated with Claude Code

The published PyPI release is far behind the repo but still numbered
0.1.0, so `pip install cotdata[norgate]` installs a build that lacks the
producer CLI the rest of the docs use (--metadata, --require-final,
databento flags) and fails with "unrecognized arguments". A producer
following the guide verbatim ends up unable to run the documented
workflow.

- Lead Step 3 with a warning to install from the Step 2 clone, not PyPI.
- Make both producer and consumer variants `-e` installs from the clone;
  note plain `pip install cotdata` becomes viable once a release lands.
- Because the version wasn't bumped, both builds report 0.1.0, so verify
  by checking `cotdata-update --help` shows --metadata / --require-final
  rather than trusting the version string.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@mspinola
mspinola merged commit a55ed5a into main Jul 26, 2026
5 checks passed
@mspinola
mspinola deleted the docs-producer-editable-install branch July 26, 2026 15:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant