use animint title in pages README

[tdhock]

closes #146

[tdhock]

hi @Faye-yufan can you please review this PR?

I believe it solves the issues you ran into in #138 (no permission to delete/create test repo).

I created a new org, animint-test which should contain only repos relevant to testing animint2. This is different from animint org which contains the animint2 repo / project source code.

I created a new fine-grained personal access token which has permission to create/delete any repos under animint-test org. Since there is no important data in animint-test org, there is no risk even if a malicious user gets control of this token. (animint2 source code is under animint org, where the token does not have permission)

I updated test-compiler-ghpages.R with documentation of the new process, and additional tests. First the old test repo is deleted, then a new one is created, then we run animint2pages, twice, to test results of creation and update.

Does that make sense? Please review, and tell me if there is anything you think I could do to improve the code or docs.

[Faye-yufan]

@tdhock Thank you for creating the detailed test for animint test repo. So glad that it passed on GH actions. But I have not tried the test on my local. Did you try run on your local?

[Faye-yufan]

I saw that it has already been set, so I don't need to set the PAT again, correct?
Will the PAT expire?

[tdhock]

I set the PAT to expire in 1 year (that is the max on github)
If you try to run the test locally, it should work, as long as your github token has the right permissions. (it worked for me locally when I used the same token as is currently used on github actions)
Since I added you to the animint-test org as member (can create new repositories), you should be able to run the test code locally with your regular github credentials (no special token required).

[tdhock]

actually I just tried that myself and I got

> gh::gh("DELETE /repos/animint-test/animint2pages_test_repo")
Error in `gh::gh()`:
! GitHub API error (403): Must have admin rights to Repository.
ℹ Read more at <https://docs.github.com/rest/repos/repos#delete-a-repository>
Run `rlang::last_trace()` to see where the error occurred.

but I am owner of animint-test org???

[tdhock]

I had to change base permissions of animint-test org from Read to Admin

https://github.com/organizations/animint-test/settings/member_privileges?enable_tip=#base-permissions

[tdhock]

https://github.com/animint-test/animint2pages_test_repo/settings/access says base role is Admin??

[tdhock]

so I got it to work for local testing by doing the following.
first I used gitcreds::gitcreds_delete() to remove my previous git crendential/token, which I believe only has repo read/write permission (not delete).
then I go to https://github.com/settings/tokens/new and check repo and delete_repo then generate token, as shown below.

Then I open up git bash on windows, type git push, then a window pops up, click token, paste the token, confirm.
Then running the tests locally should work.

[tdhock]

I added some LOCAL TESTING docs in the comments next to this test, does that make sense to you?

[Faye-yufan]

Yes, thank you! I will try on my local tonight.

[Faye-yufan]

I just tested it locally and got it to work!
It seems gitcreds::gitcreds_delete() wasn't deleting my old token, so I used credentials::set_github_pat("my-pat") to reset it.

[tdhock]

great thanks, I moved the docs to the wiki https://github.com/animint/animint2/wiki/Testing#installing-a-github-token-for-use-locally and I mentioned your credentials::set_github_pat("my-pat") trick there.
hopefully this technique will make it easier to implement tests in #138