Contributing to fortls#
There are a few ways you can support the
We are in the process of restructuring our Sponsorship structure.
In the meantime, please get in contact with
gnikit via email at
gnikit [@] duck [.] com or any other Administrator of Fortran-lang
for instructions to financially back the project.
👍🎉 Thank you for taking the time to contribute! 🎉👍
In this file you will find all the steps necessary to guide you through your first contribution to the project.
Please note our Code of Conduct and adhere to it in all your interactions with this project.
📚 Getting Started#
A good place to start is the Issues tab on GitHub. Look for any issues with the
help wanted tag.
Firstly, fork the repository from https://github.com/fortran-lang/fortls.
Then clone the forked repository into your local machine.
<YOUR-USERNAME> should be your GitHub username.
To build this project you will need Python
>= 3.7 and pip
To install all Python dependencies open a terminal go into the
fortls cloned folder and run:
pip install -e .[dev,docs]
To verify that your cloning of the GitHub repository worked as expected open a terminal and run:
This will run the entire unit test suite. You can also run this to verify that you haven’t broken anything in the code.
👉 Tip! You can run individual tests by selecting the path to the Python file and the method
Developing & Debugging 🐞️#
❗️ Before you start developing, open a terminal inside
fortls and run:
This will ensure that all you commits meet the formatting standards of the project.
You can now start writing code! Your local
fortls version will be updated with every code change you make, so you can use your normal code editor to checkout the
fortls features that you have implemented.
It is however considerably easier to create compact unittests to check if your changes have worked.
fortls test normally involves writing a Python function which sends a JSONRPC request to the server and then test checks for the correct server response.
Often times small bits of Fortran source code also have to be submited to be used by the test.
You can find varisous test examples in the
👉 Tip! You can attach a debugger to the main
fortls source code during unittesting which should allow you to pause, break, step into, etc. while testing, thus making it easier to find mistakes.
To merge your changes to the main
fortls repository push your branch on GitHub and open a Pull Request. Ping
@gnikit to review your PR.