Skip to content

Commit 4f4d337

Browse files
authored
Update readme (#63)
1 parent 6312c7e commit 4f4d337

File tree

3 files changed

+183
-3
lines changed

3 files changed

+183
-3
lines changed

CONTRIBUTING.md

Lines changed: 137 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,137 @@
1+
# Contributing
2+
3+
Contributions are welcome, and they are greatly appreciated! Every
4+
little bit helps, and credit will always be given.
5+
6+
You can contribute in many ways:
7+
8+
## Types of Contributions
9+
10+
### Report Bugs
11+
12+
Report bugs at <https://github.com/tr4nt0r/pythonkuma/issues>.
13+
14+
If you are reporting a bug, please include:
15+
16+
- Your operating system name and version.
17+
- Any details about your local setup that might be helpful in
18+
troubleshooting.
19+
- Detailed steps to reproduce the bug.
20+
21+
### Fix Bugs
22+
23+
Look through the GitHub issues for bugs. Anything tagged with "bug"
24+
and "help wanted" is open to whoever wants to implement it.
25+
26+
### Implement Features
27+
28+
Look through the GitHub issues for features. Anything tagged with
29+
"enhancement" and "help wanted" is open to whoever wants to
30+
implement it.
31+
32+
### Write Documentation
33+
34+
Pythonkuma could always use more documentation, whether as part of the
35+
official Pythonkuma docs, in docstrings, or even on the web in blog
36+
posts, articles, and such.
37+
38+
### Submit Feedback
39+
40+
The best way to send feedback is to file an issue at
41+
<https://github.com/tr4nt0r/pythonkuma/issues>.
42+
43+
If you are proposing a feature:
44+
45+
- Explain in detail how it would work.
46+
- Keep the scope as narrow as possible, to make it easier to
47+
implement.
48+
- Remember that this is a volunteer-driven project, and that
49+
contributions are welcome :)
50+
51+
## Development
52+
53+
Ready to contribute? Here's how to set up `pythonkuma` for
54+
local development.
55+
56+
### Setup Git
57+
58+
[Fork](https://github.com/tr4nt0r/pythonkuma/fork) the `pythonkuma` repo on GitHub.
59+
60+
61+
62+
Clone your fork locally:
63+
64+
```bash
65+
$ git clone git@github.com:yourusername/pythonkuma.git
66+
```
67+
68+
Create a branch for local development:
69+
70+
``` bash
71+
$ git checkout -b name-of-your-bugfix-or-feature
72+
```
73+
74+
Now you can make your changes locally.
75+
76+
77+
### Setup environment
78+
79+
We use [Hatch](https://hatch.pypa.io/latest/install/) to manage the development environment and production build. Ensure it's installed on your system.
80+
81+
### Run unit tests
82+
83+
You can run all the tests with:
84+
85+
```bash
86+
hatch run test
87+
```
88+
89+
### Format the code
90+
91+
Execute the following command to apply linting and check typing:
92+
93+
```bash
94+
hatch run lint
95+
```
96+
97+
### Publish a new version
98+
99+
You can bump the version, create a commit and associated tag with one command:
100+
101+
```bash
102+
hatch version patch
103+
```
104+
105+
```bash
106+
hatch version minor
107+
```
108+
109+
```bash
110+
hatch version major
111+
```
112+
113+
Your default Git text editor will open so you can add information about the release.
114+
115+
When you push the tag on GitHub, the workflow will automatically publish it on PyPi and a GitHub release will be created as draft.
116+
117+
118+
## Pull Request Guidelines
119+
120+
Before you submit a pull request, check that it meets these guidelines:
121+
122+
1. The pull request should include tests.
123+
2. If the pull request adds functionality, the docs should be updated.
124+
Put your new functionality into a function with a docstring, and add
125+
the feature to the list in README.md.
126+
3. The pull request should work for Python 3.12 and 3.13. Check
127+
<https://github.com/tr4nt0r/pythonkuma/actions/workflows/build.yaml>
128+
and make sure that the tests pass for all supported Python versions.
129+
130+
131+
## Serve the documentation
132+
133+
You can serve the Mkdocs documentation with:
134+
135+
```bash
136+
hatch run docs-serve
137+
```

LICENSE

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
MIT License
22

3-
Copyright (c) 2022 Bacon
3+
Copyright (c) 2025 Manfred Dennerlein Rodelo
44

55
Permission is hereby granted, free of charge, to any person obtaining a copy
66
of this software and associated documentation files (the "Software"), to deal

README.md

Lines changed: 45 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,24 @@
11
# pythonkuma
2+
23
Simple Python wrapper for Uptime Kuma
34

4-
## Installation
5+
[![build](https://github.com/tr4nt0r/pythonkuma/workflows/Build/badge.svg)](https://github.com/tr4nt0r/pythonkuma/actions)
6+
[![codecov](https://codecov.io/gh/tr4nt0r/pythonkuma/graph/badge.svg?token=RM3MC4LP07)](https://codecov.io/gh/pythonkuma/pynecil)
7+
[![PyPI version](https://badge.fury.io/py/pythonkuma.svg)](https://badge.fury.io/py/pythonkuma)
8+
![PyPI - Downloads](https://img.shields.io/pypi/dm/pythonkuma?style=flat&label=pypi%20downloads)
9+
[!["Buy Me A Coffee"](https://img.shields.io/badge/-buy_me_a%C2%A0coffee-gray?logo=buy-me-a-coffee)](https://www.buymeacoffee.com/tr4nt0r)
10+
[![GitHub Sponsor](https://img.shields.io/badge/GitHub-Sponsor-blue?logo=github)](https://github.com/sponsors/tr4nt0r)
11+
12+
---
13+
14+
## 📖 Documentation
15+
16+
- **Full Documentation**: [https://tr4nt0r.github.io/pythonkuma](https://tr4nt0r.github.io/pythonkuma)
17+
- **Source Code**: [ttps://github.com/tr4nt0r/pythonkuma](ttps://github.com/tr4nt0r/pythonkuma)
18+
19+
---
20+
21+
## 📦 Installation
522

623
```shell
724
pip install pythonkuma
@@ -29,9 +46,35 @@ async def main():
2946

3047

3148
asyncio.run(main())
32-
3349
```
3450

51+
---
52+
53+
## 🛠 Contributing
54+
55+
Contributions are welcome! To contribute:
56+
57+
1. Fork the repository.
58+
2. Create a new branch.
59+
3. Make your changes and commit them.
60+
4. Submit a pull request.
61+
62+
Make sure to follow the [contributing guidelines](CONTRIBUTING.md).
63+
64+
---
65+
66+
## 📜 License
67+
68+
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
69+
70+
---
71+
72+
## ❤️ Support
73+
74+
If you find this project useful, consider [buying me a coffee ☕](https://www.buymeacoffee.com/tr4nt0r) or [sponsoring me on GitHub](https://github.com/sponsors/tr4nt0r)!
75+
76+
---
77+
3578
## Credit
3679

3780
This library is a fork of **pyuptimekuma** by [@jayakornk](https://github.com/jayakornk)

0 commit comments

Comments
 (0)