Skip to content

Installation & Docs Updates - #239

Merged
ClareRobin merged 4 commits into
masterfrom
clare_dev
Aug 4, 2026
Merged

Installation & Docs Updates#239
ClareRobin merged 4 commits into
masterfrom
clare_dev

Conversation

@ClareRobin

Copy link
Copy Markdown
Collaborator

Various updates required for clean install & to update the ReadTheDocs:

Changes:

  • Removed stale Large File Storage (LFS) tracking that was in the .gitattributes file (not required because the tests are small)
  • Migrated setup.py to pyproject.toml (setup.py is deprecated) & updated doc reference (python setup.py install to pip install .)
  • Added .readthedocs.yaml -> since Jan 2025 ReadTheDocs requires a config file, so added this.

Verification:

  • Tested fresh venv install, succeeds & sphinx -b html docs/source build successfully.

…po, and introduced tests/ is small enough to not need large file storage lfs). It was causing lfs issues during repo cloning.
…ed sphinx (theme required for readthedocs) to pyproject.toml

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR modernizes xpore’s packaging and documentation setup to support clean installs and ReadTheDocs builds by migrating from legacy setup.py packaging to a PEP 517/518 pyproject.toml configuration and adding an explicit RTD config.

Changes:

  • Remove legacy packaging/LFS config (setup.py, LFS entries in .gitattributes).
  • Add pyproject.toml with project metadata, dependencies, console script entry point, and dynamic versioning.
  • Update installation docs and add .readthedocs.yaml to support RTD builds.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
setup.py Removed legacy setuptools-based installer in favor of pyproject.toml.
pyproject.toml New PEP 621/517 packaging configuration (metadata, deps, scripts, dynamic version).
docs/source/installation.rst Updates install instructions to pip install ..
.readthedocs.yaml Adds RTD configuration to build docs with pip install + docs extras.
.gitattributes Removes LFS tracking rules that are no longer needed.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread pyproject.toml Outdated
@ClareRobin
ClareRobin requested a review from ch99l July 29, 2026 15:22
@ClareRobin
ClareRobin merged commit ce29ae8 into master Aug 4, 2026
6 checks passed
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.

4 participants