gitleaves
Git Based Leaves management system
Project status: Still in early stage but we use it in production
Features
- Pull requests based leaves management. Most natural for software development team
- Github friendly workflow
- Generates github wiki friendly markdown reports. Markdown can be used by different static site generators too
Specifications
File names
- leaves.<YYYY>.csv
- extras.<YYYY>.csv
Format
Leaves
MMDD [- MMDD], Name, Reason / Details [Optional]
Extra days
MMDD [- MMDD], Name, Reason / Details [Optional]
Example
1115 - 1126, Tony Stark, Hawaii
1129 - 1210, Peter Parker,
1129 - 1202, Bruce Wayne,
1220 - 1224, Loki Laufeyson, Smell the flowers
Usage
Organization setup
- Create a git repo for your organization's leaves data
mkdir leavesdata
cd leavesdata
git init
mkdir data
fname=data/leaves.`date +%Y`.csv
# example data
echo `1129 - 1202, Bruce Wayne,` >> $fname
echo `1220 - 1224, Loki Laufeyson, Smell the flowers` >> $fname
git commit -a
git push origin main
- Install gitleaves
pip install gitleaves
- Generate reports
gitleaves genreports
ls reports/
- Automate report generation Document github actions based report generation
Process
- Apply for leave(s) by adding records to leaves.YYYY.csv
- Raise a PR
- Leave is approved if the PR is merged
Dev Guidelines
- Human Readable data files (as much possible)
TODO
Credits
This package was created with Cookiecutter_ and the audreyr/cookiecutter-pypackage project template.
- Cookiecutter: https://github.com/audreyr/cookiecutter
- audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage
Metadata
Release files for gitleaves 0.6.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| gitleaves-0.6.6.tar.gz | 12.5 kB | Without provenance | Details for gitleaves-0.6.6.tar.gz |
Release files / gitleaves-0.6.6.tar.gz
| Download URL | gitleaves-0.6.6.tar.gz |
|---|---|
| Size | 12.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8939f9d8dc6918fb3bd892b040e22570c4d9860c383360f33b713d49340cb992
|
|
BLAKE2b-256 checksum How to use checksums |
6816f767c12f907c4568b71885782319c4331d99d72f279b0c81b769572a0dd3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7
|
Security for gitleaves 0.6.6
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.