You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Thank you for considering contributing to coURLan!
4
3
5
-
Here are some important resources:
4
+
If you value this software or depend on it for your product,
5
+
consider sponsoring it and contributing to its codebase.
6
+
Your support will help ensure the sustainability and growth of the project.
6
7
7
-
*[List of currently open issues](https://github.com/adbar/courlan/issues) (no pretention to exhaustivity!)
8
-
*[How to Contribute to Open Source](https://opensource.guide/how-to-contribute/)
8
+
There are many ways to contribute:
9
9
10
-
There are many ways to contribute, you could:
10
+
* Sponsor the project: Show your appreciation [on GitHub](https://github.com/sponsors/adbar) or [ko-fi.com](https://ko-fi.com/adbarbaresi).
11
+
* Find bugs and submit bug reports: Help making Courlan an even more robust tool.
12
+
* Write code: Fix bugs or add new features by writing [pull requests](https://docs.github.com/en/pull-requests) with a list of what you have done.
11
13
12
-
* Improve the documentation
13
-
* Find bugs and submit bug reports
14
-
* Submit feature requests
15
-
* Write tutorials or blog posts
16
-
* Write code
17
14
18
-
## Submitting changes
15
+
A special thanks to the [contributors](https://github.com/adbar/courlan/graphs/contributors) who have played a part in Courlan.
19
16
20
-
Please send a [GitHub Pull Request to coURLan](https://github.com/adbar/courlan/pull/new/master) with a clear list of what you've done (read more about [pull requests](http://help.github.com/pull-requests/)).
21
17
22
-
**Working on your first Pull Request?** See this tutorial: [How To Create a Pull Request on GitHub](https://www.digitalocean.com/community/tutorials/how-to-create-a-pull-request-on-github)
18
+
## Testing and evaluating the code
23
19
24
-
For further questions you can contact me by way of [GitHub issues](https://github.com/adbar/courlan/issues), [Twitter](https://twitter.com/adbarbaresi) or [E-Mail](https://adrien.barbaresi.eu/).
20
+
Here is how you can run the tests and code quality checks. Pull requests will only be accepted if the changes are tested and if they there are no errors.
21
+
22
+
1. Install the necessary packages with `pip install courlan[dev]`
23
+
2. Run the tests and code quality tools:
24
+
- Tests with `pytest`
25
+
- Type checking with `mypy` on the directory: `mypy courlan/`
26
+
- Code formatting with `black` on the directory as well
27
+
28
+
29
+
For further questions you can use [GitHub issues](https://github.com/adbar/courlan/issues) or [E-Mail](https://adrien.barbaresi.eu/).
0 commit comments