Skip to content

Commit

Permalink
Add contribution guidelines
Browse files Browse the repository at this point in the history
  • Loading branch information
SenZmaKi committed Dec 1, 2024
1 parent 9447fa5 commit 5ce60a3
Show file tree
Hide file tree
Showing 5 changed files with 36 additions and 5 deletions.
5 changes: 3 additions & 2 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
.dev-garbage/
.setup-scripts/
.vscode/
.venv/
.venv-termux
tests/
Expand All @@ -13,8 +12,10 @@ build/
dist/
.scraps/
.credentials/
.vscode/*
!.vscode/extensions.json

crap.py
.todo
NOTE
scripts/changelog.md
.env
6 changes: 6 additions & 0 deletions .todo
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
https://www.riverbankcomputing.com/static/Docs/pyqtdeploy/demo.html#android
Handle VC redistributable
Fix verbose output for gogo tests
Remove dub in gogo results
Remove old versions from registry when updating
Make version button in about check for updates
10 changes: 10 additions & 0 deletions .vscode/extensions.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
{
"recommendations": [
"ms-python.vscode-pylance",
"charliermarsh.ruff",
"aaron-bond.better-comments",
"tamasfe.even-better-toml",
"esbenp.prettier-vscode",
"yzhang.markdown-all-in-one",
]
}
17 changes: 14 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
A blazingly fast desktop app for batch downloading anime and auto-downloading new episodes upon release
</p>

<p align="center">
<p align="center"
<a href=https://github.com/SenZmaKi/Senpwai/actions/workflows/test.yml> <img height="30px" src=https://github.com/SenZmaKi/Senpwai/actions/workflows/test.yml/badge.svg alt=test-workflow-status-badge></a>
<a href="https://github.com/SenZmaKi/Senpwai/releases"><img height="30px" src="https://img.shields.io/github/downloads/SenZmaKi/Senpwai/total" alt="Downloads"></a>
<a href="https://discord.gg/invite/e9UxkuyDX2" target="_blank"><img height="30px" alt="Discord" src="https://img.shields.io/discord/1131981618777702540?label=Discord&logo=discord" alt="Discord-icon"></a>
Expand All @@ -17,7 +17,8 @@ A blazingly fast desktop app for batch downloading anime and auto-downloading ne
<a href="#building-from-source">Building from source</a> •
<a href="#support">Support</a> •
<a href="#faq">FAQ</a> •
<a href="#links">Links</a>
<a href="#links">Links</a> •
<a href="#contribution">Contribution</a>
</p>

<img align="center" src="https://raw.githubusercontent.com/SenZmaKi/Senpwai/master/.github/images/one-piece.png" alt="one-piece-screenshot">
Expand Down Expand Up @@ -63,7 +64,7 @@ Check [Senpcli](https://github.com/SenZmaKi/Senpwai/blob/master/docs/senpcli-gui

- You can support the development of Senpwai through donations on [GitHub Sponsors](https://github.com/sponsors/SenZmaKi) or [Patreon](https://patreon.com/Senpwai).
- You can also leave a star on the github for more weebs to know about it.
- Senpwai is open to pull requests, so if you have ideas for improvements, feel free to contribute!
- Senpwai is open to pull requests, so if you have ideas for improvements, feel free to [contribute](#contribution)!

## Sponsors

Expand Down Expand Up @@ -145,6 +146,16 @@ More sources means more writing more code which in turn means fixing more bugs.

[Patreon](https://patreon.com/Senpwai)

## Contribution

- If it's a change to code e.g., `main.py` make the pull request into the most recent branch e.g., `v2.1.5` instead of `master`.
- If it's a change to documentation e.g., `README.md` make the pull request into the `master` branch.
- If you open the project folder on [Visual Studio Code](https://code.visualstudio.com/) you will be prompted to install recommended extensions for the project.
- [Pyright](https://github.com/microsoft/pyright) is used as the type checker, ensure your code is type annotated well and there are no type errors.
- [Ruff](https://github.com/astral-sh/ruff) is used for formatting and linting.
- [Inno Setup](https://jrsoftware.org/isinfo.php) is used for creating the installer, add the installation folder to the `%PATH%` environment variable for access to `ISCC.exe` from the command line. Also set the `SENPWAI_ROOT_DIR` environment variable to the root directory of the project.
- [Poe](https://github.com/nat-n/poethepoet) is used as the task runner, there are various tasks available to run e.g., `poe lint` to lint the code. It autoloads the `.env` file in the root directory of the project. Poe is installed when you setup the project.

## Legal Disclaimer

Senpwai is designed solely for providing access to publicly available content. It is not intended to support or promote piracy or copyright infringement. As the creator of this app, I hereby declare that I am not responsible for, and in no way associated with, any external links or the content they direct to.
Expand Down
3 changes: 3 additions & 0 deletions pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -63,6 +63,9 @@ poetry-plugin-export = "^1.8.0"
requires = ["poetry-core"]
build-backend = "poetry.core.masonry.api"

[tool.poe]
envfile = ".env"

[tool.poe.tasks]
release = "python -m scripts.release"
export_dependencies = "poetry export -f requirements.txt --output requirements.txt"
Expand Down

0 comments on commit 5ce60a3

Please sign in to comment.