200.002 Quick start testing an upcoming fix and contributing
Glad to see here, we hope you now want to contribute to the project!
The development team is happy to have some support in testing the new fix of features.
In order to do this you don't need to be a programmer: it is enough to download the upcoming code, execute it and report if it works fine or not into the PR page.
you can install the github client for MSYS executing:
pacman -S mingw-w64-x86_64-github-cli
this will provide you with the "gh" command.
-
install the github command line.
-
configure github command line to access to access git hub.:
$ gh auth login
? What account do you want to log into? GitHub.com
? What is your preferred protocol for Git operations? HTTPS
? Authenticate Git with your GitHub credentials? Yes
? How would you like to authenticate GitHub CLI? Login with a web browser
! First copy your one-time code: EE82-649C
Press Enter to open github.com in your browser...
✓ Authentication complete.
- gh config set -h github.com git_protocol https
✓ Configured git protocol
✓ Logged in as xxxxxxxxxx
-
log in with in github with your account to see which PRs are available
-
go to the PRs page:
-
select the PR you want to test
-
in the top right you'll find several ways to get the code, e.g. the github Command line:
-
go into your console and create a folder to host the code to be tested
mkdir PRs
cd PRs
- and now get the PR locally:
$ git clone https://github.com/ham-radio-software/D-Rats.git
Cloning into 'D-Rats'...
remote: Enumerating objects: 3124, done.
remote: Counting objects: 100% (1164/1164), done.
remote: Compressing objects: 100% (434/434), done.
remote: Total 3124 (delta 755), reused 792 (delta 709), pack-reused 1960
Receiving objects: 100% (3124/3124), 2.46 MiB | 2.11 MiB/s, done.
Resolving deltas: 100% (2206/2206), done.
Updating files: 100% (229/229), done.
at this point you have a new .git folder containing the master D-Rats version.
move the D-Rats folder with a name of your choice. I use "PR-code" so to be able to recall which PR I am testing, eg:
mv D-Rats PR-254
enter into the new folder and issue the pr command to get the code to test
$ cd PR-254
$ gh pr checkout 254
remote: Enumerating objects: 230, done.
remote: Counting objects: 100% (230/230), done.
remote: Compressing objects: 100% (58/58), done.
remote: Total 192 (delta 132), reused 174 (delta 114), pack-reused 0
Receiving objects: 100% (192/192), 98.08 KiB | 1.58 MiB/s, done.
Resolving deltas: 100% (132/132), completed with 27 local objects.
From https://github.com/ham-radio-software/D-Rats
* [new ref] refs/pull/254/head -> wb8tyw_italian_localazation
Switched to branch 'wb8tyw_italian_localazation'
at this point you can test the new D-Rats code:
- build the localization files
$ ./build_pot.sh
- Now, execute D-Rats will detect if there is already an existing config file and in case it will use it:
$ ./d-rats.py
After you have done your tests we'll be happy to see your feedbacks;
- in the PR log in case of issues related to the new features
- in the issue log in case you have found something else of unexpected
