Table of Contents

• Introduction
• First Bad Issue
  • How I tried to fix it?
• Help Each Other!
• MatterMost
  • Issue
  • Purpose of The Issue
• Back To CLI
  • Issue Description
  • What does it mean?
  • Implementation
  • Result
• Conclusion

Introduction

This blog post is about Release 0.3. I would like to start with a little introduction, explaining how hard was to find a good issue. For the last Release 0.2 I had spent all my time on huge JavaFX project, I wasn't satisfied at all, for the reason that I had to find and close two issues within days. This time I was almost caught by the same problem, but by the end I served it as good as I could. Let me walk you through the time-line.

First Bad Issue

At the beginning, I have found an issue, where I was supposed to move App Icon from Dock to Tray for macOS users. It sounds really simple. However, project is written in Go which I had never used before. If you are a reader that is familiar with my blogs, you definitely know how often I learn new programming-languages. Going forward, I decided to learn Go lang from scratch.

Let me quickly explain what's this project about. This is Simple, free and efficient ad-blocker and privacy guard for Windows, macOS and Linux.

systray - First Attempt

Fortunately, Go is really simple to learn, so let's proceed to my attempts moving the icon from Dock to Tray.

For the first attempt I tried to implement using systray library that is written in Objective-C. It helps manipulate the macOS system UI and move application from Dock to Tray. I've written the code, using documentation within 2 hours, was so happy. However, I've got an issue related to the other library called wails which helps implement UI also written in Objective-C. Eventually, building the project failed, for the reason that these two libraries conflict because they use the same namings. I had to move forward and try different library/method.

trayhost - Second Attempt

Basically, this library works the same way as systray, and I had the same issue.

Any other library to do this works the same way, so I was stacked.

How I tried to fix it?

I forked systray project and changed the naming that caused the conflict. Imported my fork, as Go allows to import directly using git-url.
Unfortunately, it didn't work at all...

You may check my fork and see the changes: Click me :D

Objective-C - Third Attempt

This time I tried to write my code, using Objective-C and Go lang. After some time, I came up with the solution, but I got this error:

r0      0x0
r1      0x0
r2      0x0
r3      0x0
r4      0x18fef62cb
r5      0x16d28db00
r6      0x6e
r7      0x0
r8      0x1e844b5b5be91e5a
r9      0x1e844b5a36c1ee5a
r10     0x200
r11     0xb
r12     0x0
r13     0x1ff800
r14     0x7fb
r15     0xd3c1205a
r16     0x148
r17     0x202129928
r18     0x0
r19     0x6
r20     0x16d28f000
r21     0x1003
r22     0x16d28f0e0
r23     0x2
r24     0x0
r25     0x16d28ecc0
r26     0x1f9a37000
r27     0x828
r28     0x140001021c0
r29     0x16d28da70
lr      0x18ff3ac20
sp      0x16d28da50
pc      0x18ff02a60
fault   0x18ff02a60

The error message indicates that you are attempting to initialize an NSWindow instance outside the main thread, which is not allowed in macOS applications. It was a huge problem, as I couldn't do it in the main thread, for the reason the rest of functionality wouldn't work.

Conclusion of First Bad Issue

Maintainer and I had a small talk where I'd been explaining everything. Eventually, he agreed that is impossible to implement with current project structure... I didn't finish it, and don't have PR :c

Help Each Other!

Open-source community is brilliant because people tend to help each other. I had only a week to finish, so I asked my friend Theo for help. He sent me couple of the repos that he worked on, and I decided to work on them.

MatterMost

MatterMost is an open source platform for secure collaboration across the entire software development lifecycle. It's pretty popular platform and has tons of issues, huge documentation as for users as for developers. It wasn't hard to contribute to this project.

Issue

This time I have taken something that matches my current skill level, and I don't shoot my foot. It was simple issue found in early mentioned mattermost.

Purpose of The Issue

The purpose of that issue is to fix linter errors for one of the files. I set up the project, and started working on it.

First thing first, I had to run linter and see all the errors. I checked the lines where it occurred, and fixed them all pretty quickly. Eventually, opened a PR.

Back To CLI

I really liked working on CLI tools because it's fun to me. For the second PR I found a project called lumen. Lumen is an instant AI Git Commit message, Git changes summary from the CLI. I really enjoyed working on this project! Unfortunately, the don't have that many issues, but I was lucky enough to get assigned. In addition, this tool is written in Rust, so I had to refresh my knowledge.

Issue Description

I found an issue Add STDIN support for explain command.

What does it mean?

This tool has an option explain which is invoked this way:

lumen explain <sha>

This command explains everything about certain commit, what it changed and why. Example:

Pretty useful tool, huh?

My implementation should allow to add functionality to this command:

echo "HEAD" | lumen explain -

So it takes STDIN value from echo, in my example HEAD, and replaces - with that HEAD value.

Implementation

I realized how to implement it. Created condition to check if - instead of sha.

if sha == "-" {
   // Pass `-` as an indicator to read from stdin
   GitEntity::Commit(Commit::new_from_stdin()?)
} else {
   GitEntity::Commit(Commit::new(sha)?)
}

Result

After changing 5 files, I came up with the result:

Now it has two options:

lumen explain <sha>

and

echo "<sha>" | lumen explain -

Both of these options are working, my implementation added new functionality, and saved previously implemented! Here's my PR.

Conclusion

Last couple of weeks weren't simple, but was fun. I learnt new language Go. Connected with Open-Source community which helped me to find one of the repos that I contributed to!