Skip to content

Commit 7a81cfd

Browse files
committed
added detailed steps for publishing a release
1 parent adfacc9 commit 7a81cfd

File tree

1 file changed

+37
-13
lines changed

1 file changed

+37
-13
lines changed

README.md

Lines changed: 37 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -76,24 +76,48 @@ or executed during all tests, is calculated and uploaded to
7676
seeing if you missed any edge cases that need tests added.
7777

7878

79+
### Publishing a release
80+
Following the steps described above, the full process for publishing a release is:
81+
82+
1. Test
83+
84+
- Write new tests as needed
85+
- Run tests to confirm changes pass
86+
87+
2. Pre-commit
88+
89+
- Stage changes in git
90+
- Run `pre-commit` (requires developer mode)
91+
- Resolve any errors/warnings from `pre-commit` (e.g., run `ruff --fix`)
92+
- Stage any new fixes and re-run `pre-commit`
93+
94+
3. Commit changes
95+
96+
- Commit and sync changes
97+
- Confirm project builds on github with no errors (see 'Actions' tab)
98+
- Confirm adequate coverage via `codecov` (click link on github)
99+
100+
4. Document changes
101+
102+
- Edit `CHANGELOG.md` and `README.md` to reflect changes, then commit
103+
- Tag the release using `git tag -a vX.X.X` (updating `X`s) with a short changelog summary as the tag message
104+
- Push changes `git push --tags`
105+
106+
5. Build the release
107+
108+
- Build using `python -m build `
109+
- Add a release to the [github page](https://github.com/GallowayLabMIT/rushd/releases) by copy-pasting the changelog
110+
- Add the `.whl` and `.tar.gz` files (from the build folder) to the github release
111+
- Upload the package to PyPI using `twine upload dist/*`
112+
79113

80114
## Changelog
81115
See the [CHANGELOG](CHANGELOG.md) for detailed changes.
82116
```
83-
## [0.5.0] - 2024-04-15
84-
### Added
85-
- Added new `rd.plot.debug_axes` which draws guide lines to help with axis alignment.
86-
- Added new `rd.plot.adjust_subplot_margins_inches` which allows subplot configuring
87-
using inch offsets (instead of subfigure coordinate offsets)
88-
117+
## [0.5.1] - 2025-02-01
89118
### Modified
90-
- `rd.flow.load_csv_with_metadata` and
91-
`rd.flow.load_groups_with_metadata` can now load a subset of columns.
92-
- The `datadir.txt` can include paths that use `~` to represent the home directory.
93-
- `rd.plot.generate_xticklabels` does not include metadata key labels in plots without yticklabels
94-
- `rd.plot.generate_xticklabels` no longer throws an error when xticklabels don't match the dictionary passed (instead leaves labels as-is)
95-
- `rd.plot.generate_xticklabels` now enables user-specified line spacing
96-
```
119+
- Switched to using `np.nan` instead of `np.NaN` to be compatible with Numpy 2.0
120+
````
97121
98122
## License
99123
This is licensed by the MIT license. Use freely!

0 commit comments

Comments
 (0)