Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Modernize packaging #78

Merged
merged 8 commits into from
Apr 22, 2024
Merged

Modernize packaging #78

merged 8 commits into from
Apr 22, 2024

Conversation

douglatornell
Copy link
Member

@douglatornell douglatornell commented Apr 22, 2024

  • Replace setup.cfg with project metadata in pyproject.toml
  • Change build backend from setuptools to hatchling
  • Move version identifier to __about__.py file
  • Change to use importlib.metadata.version() to access version identifier
  • Add release process section to dev docs
  • Change badges layout in README & dev docs to table

The setup.cfg file has been removed and its functionality migrated to the
pyproject.toml file. This aligns with the move towards PEP 518 compliance,
providing a more standardized and simplified project configuration. Importantly,
setup.cfg's metadata and options have been incorporated into pyproject.toml's
[project] and [tool.*] sections.
Hatch is now being used for package management in the project. Various files
including 'docs/index.rst', 'envs/environment-dev.yaml', 'pyproject.toml', and
'README.rst' have been updated to include the necessary usage and references
for Hatch. This commit also implements changes in build system requirements and
target wheel inclusion.
Move the version identifier from __init__.py a new __about__.py file. The
version is now dynamically read from that file to maintain the consistency of
version info.
More robust, consistent, and modern.
Necessary so that Sphinx can access the package metadata.
@douglatornell douglatornell added documentation Improvements or additions to documentation maintenance Codebase & repo maintenance labels Apr 22, 2024
@douglatornell douglatornell added this to the v24.1 milestone Apr 22, 2024
Copy link

codecov bot commented Apr 22, 2024

Codecov Report

Attention: Patch coverage is 0% with 1 lines in your changes are missing coverage. Please review.

Project coverage is 74.72%. Comparing base (f8b4be2) to head (a7f8eca).

Files Patch % Lines
salishsea_site/__about__.py 0.00% 1 Missing ⚠️
Additional details and impacted files
@@            Coverage Diff             @@
##             main      #78      +/-   ##
==========================================
- Coverage   74.83%   74.72%   -0.12%     
==========================================
  Files          14       15       +1     
  Lines         906      906              
  Branches      161      161              
==========================================
- Hits          678      677       -1     
- Misses        221      222       +1     
  Partials        7        7              
Flag Coverage Δ
unittests 74.72% <0.00%> (-0.12%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

This commit introduces a comprehensive "Release Process" section in the
documentation. It provides detailed steps on handling version bumps, creating
annotations and tags for the release, and managing the associated GitHub
milestones and issues.
@douglatornell douglatornell merged commit fc4eb8a into main Apr 22, 2024
6 of 8 checks passed
@douglatornell douglatornell deleted the modernize-pkg branch April 23, 2024 01:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation maintenance Codebase & repo maintenance
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant