Skip to content

Latest commit

 

History

History
122 lines (83 loc) · 4 KB

CONTRIBUTING.md

File metadata and controls

122 lines (83 loc) · 4 KB
Raw

Contributing

Thank you for wanting to contribute! This project reviews PRs that have an associated issue with them. If you have not make an issue for your PR, please make one first.

Issues, feedback, and sharing that you're using Titanoboa and Vyper on social media is always welcome!

Table of Contents

Setup

Requirements

You must have the following installed to proceed with contributing to this project.

  • git
    • You'll know you did it right if you can run git --version and you see a response like git version x.x.x
  • python
    • You'll know you did it right if you can run python --version and you see a response like Python x.x.x
  • uv
    • You'll know you did it right if you can run uv --version and you see a response like uv 0.4.7 (a178051e8 2024-09-07)
  • anvil
    • You'll know you did it right if you can run anvil --version and you see a response like anvil 0.2.0 (b1f4684 2024-05-24T00:20:06.635557000Z)
  • Linux and/or MacOS
    • This project is not tested on Windows, so it is recommended to use a Linux or MacOS machine, or use a tool like WSL for windows users.
  • just
    • You'll know you did it right if you can run just --version and you see a response like just 1.35.0

Installing for local development

Follow the steps to clone the repo for you to make changes to this project.

  1. Clone the repo
git clone https://github.com/vyperlang/gaboon
cd gaboon
  1. Sync dependencies

This repo uses uv to manage python dependencies and version. So you don't have to deal with virtual environments (much)

uv sync
  1. Create a new branch
git checkout -b <branch_name>

And start making your changes! Once you're done, you can commit your changes and push them to your forked repo.

git add .
git commit -m 'your commit message'
git push <your_forked_github>
  1. Virtual Environment

You can then (optionally) work with the virtual environment created by uv.

source .venv/bin/activate

And to remove the virtual environment, just run:

deactivate

However, if you run tests and scripts using the uv or just commands as we will describe below, you won't have to worry about that.

Note: When you delete your terminal/shell, you will need to reactivate this virtual environment again each time. To exit this python virtual environment, type deactivate

Running Tests

First, you'll need to make sure you have the anvil1 keystore in your ~/.gaboon/keystores folder. You can find it here. Please move it there.

Run the following:

just test # Check out the justfile to see the command this runs

This is equivalent to running pytest in the root directory of the project.

Code Style Guide

We will run the .github/workflows before merging your PR to ensure that your code is up to standard. Be sure to run the scripts in there before submitting a PR.

For type checking:

just typecheck # Check out the justfile to see the command this runs

For code formatting:

just format # Check out the justfile to see the command this runs

Where do you get the typecheck and format command?

You can see in justfile a list of scripts one can run. To see them all you can run simply just

Thank you!

Thank you for wanting to participate in titanoboa and gaboon!