Skip to content

Update development environment configuration and metadata#351

Merged
cary-rowen merged 2 commits into
blindpandas:developfrom
cary-rowen:fix/dev-environment-setup
Jan 3, 2026
Merged

Update development environment configuration and metadata#351
cary-rowen merged 2 commits into
blindpandas:developfrom
cary-rowen:fix/dev-environment-setup

Conversation

@cary-rowen

Copy link
Copy Markdown
Collaborator

Link to issue number:

None

Summary of the issue:

The current development environment configuration has several outdated or restrictive settings that cause setup failures for new contributors, particularly on Windows:

  1. invoke version conflict: The strict pinning of invoke==2.2.0 causes an OSError: [WinError 5] Access is denied on Windows when running invoke dev. This happens because pip attempts to uninstall the running invoke.exe process if a newer version is present in the environment.
  2. Outdated Python version: The documentation recommends Python 3.10, but project dependencies (like pywhatlang) and CI workflows require Python 3.11.
  3. Inaccurate Metadata: setup.py lists support for Windows 7 and 8, which are no longer supported by Python 3.11, and misses Windows 11.

Description of how this pull request fixes the issue:

This PR updates the build configuration and metadata to reflect the current requirements:

  1. requirements-dev.txt: Relaxed the constraint to invoke>=2.2.0. This allows pip to skip re-installation if a newer version is detected, preventing the file locking error on Windows.
  2. README.md: Updated the required Python version to 3.11 series to match CI and package requirements.
  3. setup.py:
    • Updated Programming Language classifier to Python 3.11.
    • Removed Windows 7 and Windows 8 classifiers (incompatible with Python 3.11).
    • Added Windows 11 classifier to reflect current support.

Testing performed:

  1. Created a clean virtual environment with Python 3.11 on Windows 10.
  2. Ran invoke dev.
  3. Verified that dependencies installed successfully without permission errors.
  4. Verified that the application builds and runs successfully (invoke run).

Known issues with pull request:

None

- Replace deprecated `distutils.LooseVersion` with `packaging.Version`
- Add `packaging` to requirements
- Remove obsolete `pkg_resources.py2_warn` from PyInstaller spec
@cary-rowen
cary-rowen merged commit 64ea7ae into blindpandas:develop Jan 3, 2026
5 checks passed
@cary-rowen
cary-rowen deleted the fix/dev-environment-setup branch January 3, 2026 15:17
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