Skip to content

200.002 Quick start testing an upcoming fix and contributing

Jump to bottom
MAURIZIO ANDREOTTI edited this page Oct 10, 2023 · 3 revisions

Welcome!

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 or new 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.

Install and configure github command line

  • Install the github command line: 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.

  • 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

Test an upcoming version of D-Rats (PRs)

  • log in with in github with your account to see which PRs are available

  • go to the PRs page: image

  • select the PR you want to test image

  • in the top right you'll find several ways to get the code, e.g. the github Command line: image

  • 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

Reporting issues and comments

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

image

  • in the issue log: in case you have found something else of unexpected image
Clone this wiki locally