Skip to content

PHEP TBD: Development standards#52

Open
jtniehof wants to merge 1 commit intoheliophysicsPy:mainfrom
jtniehof:phep-development
Open

PHEP TBD: Development standards#52
jtniehof wants to merge 1 commit intoheliophysicsPy:mainfrom
jtniehof:phep-development

Conversation

@jtniehof
Copy link
Copy Markdown
Contributor

@jtniehof jtniehof commented Feb 20, 2026

This PHEP updates standards 7, 9, and 14; these are part of the "software maturity" and "testing" guidelines. It relates to #35 but does not close it.

I really need more examples for the "best practices" section! Please, be bold and suggest!

The changes here are really tiny so I'm not doing any polling (unless someone wants it!). Similarly, there's no tiering (which I guess means this technically doesn't depend on PHEP 4). The meat of this really is in the "best practices" and "how to teach" sections, and trying to make good stuff visible and easy to replicate.

@sapols
Copy link
Copy Markdown
Contributor

sapols commented Mar 25, 2026

Chiming in to publicly say that I support the changes in this draft; I think it strictly improves things.

I would assign this PHEP number 9 when ready.

Sorry for not suggesting new best practices nor reference implementations, but I'm already particularly happy with the current "best practices" content. Hoping community members will offer reference implementations.

<a name="reference-implementations"></a>
Several PyHC projects provide examples of best practices for development practices, and they should be provided here.

[pyspedas](https://github.com/spedas/pyspedas?tab=readme-ov-file) provides automated tests, static checks, and coverage (do we have a better place to link in the repository?). It uses [coveralls](https://coveralls.io/) for [test coverage](https://coveralls.io/github/spedas/pyspedas): [workflow configuration](https://github.com/spedas/pyspedas/blob/master/.github/workflows/pythonpackage.yml).
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

We've retired this pyspedas coverage workflow. It's been replaced with a version that splits the tests up into groups, and runs them in paralllel jobs, bringing the wall-clock runtime down from 6+ hours to more like 90 minutes. New workflow is here: https://github.com/spedas/pyspedas/blob/master/.github/workflows/full_coverage.yml

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.

3 participants