Forem: bashbunni

Replicate My Setup

bashbunni — Sun, 01 Jan 2023 00:27:37 +0000

System Requirements

N/A; can use a VM + my dotfiles to set it all up. i3wm is for Linux, but Tmux and Neovim are just terminal tools, so you can use it for any OS.

i3

shouldn't require any special treatment; just install i3wm and yoink config files
it will ask if you want to create a config file (see section 4 of docs)
- save it to ~/.i3/config

Tmux

install tpm (plugin manager), yoink my config, then do <Ctrl-b> (default mod key) + I (capital I) to install the plugins once you start tmux

Neovim

install it
Install Packer
:PackerInstall

Getting Started With OSS

bashbunni — Wed, 18 May 2022 03:22:26 +0000

Why Contribute?

Contributing to open source is a fantastic way to collaborate and build connections with other developers. It also helps a lot with imposter syndrome; it gives you great practice for your first developer job and allows you to tackle progressively more challenging tasks. In addition, a lot of open source companies look to their contributors when hiring for a position, so the connections you build through open source can be valuable to your career.

What Do I Work On?

Look for low-hanging fruits in the issues, i.e. something easy enough to change and test.
If there aren't tons of issues, then take a stab at improving test coverage in the repo.
I'd always recommend opening an issue before submitting a pull request so you get feedback on your proposed changes before going through the effort of implementing those changes.

What If I Get Stuck

A really important part of being a developer is learning to navigate a code base. I enjoy using tools like ripgrep and Sourcegraph for finding key words in either a local repo (ripgrep) or remote repo (Sourcegraph). Both support regular expressions, so you can get very specific with the sequences you're looking for. I definitely recommend getting comfortable with these tools and learning to backtrack to find solutions.

Of course, with any new code base you'll get stuck and need help. Don't worry, most open source projects have communities associated with them that you can find easily on their Github or website. Joining their community and asking questions or asking questions as issues or discussions on the repo are great ways to get answers to your questions. Note that nobody is going to spoon-feed you, so make sure you've checked the docs for your language when applicable and that you've tried to answer your own question by searching through their code and documentation.

If anything is unclear about how to run the program or get it set up for development, definitely ask!

What Do I Need to Know?

Git, more specifically:
- conventional commits (follow the standard used in the repo you're contributing to)
- Merge vs Rebase
- Squashing commits
- Cherry picking*
- Partial commits*
How to create an issue
How to create a pull request
Writing user stories* (helpful for giving an issue more context in few words)

Don't forget to check if they have a contributing.md file that specifies the format for issues, PRs, etc.
You can also look at previous PRs that have been merged to get an idea of what has been accepted in the past.

*nice to know, not need to know

Let me know in the comments if there's anything I missed!

First Developer Job!

bashbunni — Fri, 18 Feb 2022 19:08:50 +0000

I'm so excited to announce that I've accepted a position at charm!

I'll be hacking away at their tools with the team and working with the community to improve the products, host fun events, and add value to users as a developer relations person. The team is truly incredible and I'm looking forward to growing more as a developer and content creator.

If you haven't heard about Charm, they build command line tools for developers. If you've ever seen my live coding on Twitch, you'll know how much I enjoy living in the terminal and how convenient it is to have useful terminal tools. I'm actually building a side project using bubbletea and glamour that acts as a project journal for keeping track of your design decisions throughout the lifespan of a project.

If you want to learn more about that project, you can check out my "elevator pitch" here

I'm really excited to dive deeper into their ecosystem and provide guidance to other developers on how to use the tools to improve their quality of life. I think that providing developers with tools that make the command line fun and accessible will lead to significant improvements in their workflows just like it has mine.

Stay tuned for updates on how to get started with their tools and for cool projects that get built with them.

Set up Yubikey for Passwordless Sudo Authentication

bashbunni — Mon, 24 Jan 2022 20:36:03 +0000

Passwordless auth with Yubico 5 NFC on Ubuntu

Resources

Using U2F for passwordless sudo

Prerequisites

sudo apt-get install libpam-u2f
you'll need to setup your yubikey with the yubikey manager prior to doing this tutorial.

Setup

Plug-in yubikey and type: mkdir ~/.config/Yubico
- ignore if the folder already exists
type pamu2fcfg > ~/.config/Yubico/u2f_keys to add your yubikey to the list of accepted yubikeys
- enter your PIN if one if set for the key, then touch the key when the key's light blinks.
(optional) Register additional keys with the command: pamu2fcfg -n >> ~/.config/Yubico/u2f_keys
type sudo nano /etc/pam.d/sudo (or sudo nvim /etc/pam.d/sudo to use neovim as the text editor) to edit the PAM config for sign-on
Then type auth sufficient pam_u2f.so before
@include common-auth

To make this 2FA instead of passwordless authentication with Yubikey

instead of the final step, adjust the file /etc/pam.d/sudo to include:

@include common-auth
auth       required   pam_u2f.so

Save the file and DO NOT CLOSE THE FILE - CONFIRM that the deployment was successful (see below)

Always confirm success BEFORE closing the edit window in terminal of the pam_u2f.so file

You can test the deployment is successful by opening a new terminal tab or window then running sudo echo SUCCESS

If you enabled sign-in with yubikey only, then you will see your yubikey flashing for touch input
If you enabled 2FA with your key, then you will be prompted to enter your password, then the yubikey will flash for touch input.

Once the behaviour works as expected, you may close the terminal windows

How to Set up Neovim for Full Stack Development

bashbunni — Thu, 09 Dec 2021 21:49:57 +0000

Set up Neovim for Full Stack Development

You'll need:

Coc
emmet

If you're new to neovim:

install neovim
Install vim-plug (or any other plugin manager)
https://github.com/junegunn/vim-plug
I recommend checking out my dotfiles which has lots of comments so you can find any extra features that might be helpful for you.

I will write another post for a more in-depth description of getting started with neovim...

Install Coc

To install Coc, you'll want to follow their instructions at the link below. It is
https://github.com/neoclide/coc.nvim

Configuring Coc

With neovim open, type the following:
:CocInstall coc-html coc-tsserver coc-json coc-emmet coc-prettier

Coc tsserver is for javascript, typescript, and JSX support

You'll want to create a shortcut for :call CocAction('format'). I have the following shortcut so that I can format my projects with space + f:
nnoremap <leader>f :call CocAction('format')<CR>

Install Node and Npm

head over to the Node.js downloads page and follow their installation instructions. You can also use your package manager to install Node.

Debian and Ubuntu

sudo apt install nodejs

Arch Linux

sudo pacman -S nodejs

Other Recommendations

I highly recommend installing tmux so you can run your frontend, backend, neovim, and git cli in the same terminal window which makes it way easier to keep your workspace clear. Tmux is great because you can name your sessions and easily navigate to the right spot for what you're looking to do.
e.g.

Managing Go Modules

bashbunni — Thu, 09 Dec 2021 21:21:17 +0000

Managing Dependencies with go.mod

A project's dependencies are declared in the go.mod file. This is where the modules are stored when you do go get <module name>. You can remove unused dependencies using go mod tidy and your go.mod will only include all used imports.

When you clone a Go project from github, for example, you'll want to run go get to install all of the dependencies declared in the go.mod file. If you're coming from a background in web development, this is similar to how you run npm install to install all of the dependencies declared in your package.json file.

Indirect Dependencies

You may see some dependencies in your go.mod file that are indirect (denoted by // indirect). This means that one of your dependencies doesn't have its own go.mod file, so, the dependencies that it imports are included in your project's go.mod file.

For example:
Let's say we're building a Twitch bot, we need github.com/gempir/go-twitch-irc/v2, but it doesn't have a go.mod file and it uses functions from github.com/gempir/go-twitch-irc. You would then have github.com/gempir/go-twitch-irc // indirect in your project's go.mod file.

note: the above is a hypothetical scenario, you won't actually have any indirect dependencies with github.com/gempir/go-twitch-irc/v2

What is go.sum?

go.sum includes the checksum for the dependencies to make sure that you're installing the exact same dependency as the author used.

Managing your Projects as Go Modules

To create a new Go project where you can have a go.mod file, you need to set it up on your GOPATH with a name for your project.

Running go mod init <module name>
Your module name can be your project name or it can be a link to your github repo, just remove the https:// portion of the url.

You need to run go mod init before you're able to get dependencies for your project with go get

Forem: bashbunni

Replicate My Setup

System Requirements

i3

Related Links

Tmux

Related Links

Neovim

Related Links

Getting Started With OSS

Why Contribute?

What Do I Work On?

What If I Get Stuck

What Do I Need to Know?

First Developer Job!

Set up Yubikey for Passwordless Sudo Authentication

Passwordless auth with Yubico 5 NFC on Ubuntu

Resources

Prerequisites

Setup

To make this 2FA instead of passwordless authentication with Yubikey

Always confirm success BEFORE closing the edit window in terminal of the pam_u2f.so file

How to Set up Neovim for Full Stack Development

Set up Neovim for Full Stack Development

If you're new to neovim:

Install Coc

Configuring Coc

Install Node and Npm

Debian and Ubuntu

Arch Linux

Other Recommendations

Managing Go Modules

Managing Dependencies with go.mod

Indirect Dependencies

What is go.sum?

Managing your Projects as Go Modules