Skip to content

Commit 01a65d2

Browse files
add example dev workflow (#6986)
* add example dev workflow * run tests as well * tweak --------- Co-authored-by: Michael Chirico <[email protected]>
1 parent 0fc76f9 commit 01a65d2

File tree

1 file changed

+20
-0
lines changed

1 file changed

+20
-0
lines changed

.dev/README.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,25 @@
11
# data.table developer
22

3+
Inside this repository we provide some tools to improves development experience. Most notable is the `cc()` helper function that recompiles C sources, reloads R sources, and runs tests.
4+
5+
Typical development workflow will then look like:
6+
7+
0. `git checkout -b [branch]`
8+
1. edit package files
9+
2. run `R`
10+
3. call `cc(TRUE)`
11+
4. (if needed) go to point 1.
12+
13+
Once we (and tests) are satisfied with changes, we then run complete package checks:
14+
15+
0. in shell terminal
16+
1. run `make build`
17+
2. run `make check`
18+
3. (optionally) run on `r-devel`, e.g. `R=~/build/R-devel/bin/R make check`
19+
4. (optionally) run on ancient R, e.g. `R=~/build/R-340/bin/R make check`
20+
5. `git commit -m '[changes description]'`
21+
6. `git push [remote] [branch]`
22+
323
## Setup
424

525
To use the optional helper function `cc()`, one needs to set up the project path and source `.dev/cc.R` to use `cc()` conveniently. This works through creating an additional `.Rprofile` in the `data.table` directory.

0 commit comments

Comments
 (0)