https://github.com/devfle/readme-level-up
A small action that converts interactions made on GitHub into experience points
https://github.com/devfle/readme-level-up
automation game github-actions github-api portfolio python
Last synced: 9 months ago
JSON representation
A small action that converts interactions made on GitHub into experience points
- Host: GitHub
- URL: https://github.com/devfle/readme-level-up
- Owner: devfle
- License: mit
- Created: 2022-12-03T21:09:12.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-06-03T21:39:10.000Z (over 1 year ago)
- Last Synced: 2025-04-12T21:37:08.958Z (9 months ago)
- Topics: automation, game, github-actions, github-api, portfolio, python
- Language: Python
- Homepage:
- Size: 40 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Read Me Level Up
Readme level up is a small action that converts interactions made on GitHub into experience points. If you have enough experience points your level increases. The action suits perfectly for the profile page on Github.
# Setup Action
I explain here how to set up the action. The Github profile readme serves as an example. But any other readme can be used as well.
1. Add the following comments to your readme file:
```text
```
2. create a new workflow with the following example content.
# Example Action Setup
```yml
name: Update Readme Level
on:
workflow_dispatch:
schedule:
- cron: '0 08 * * *'
jobs:
update-readme:
runs-on: ubuntu-latest
steps:
- name: checkout project
uses: actions/checkout@v4
- name: update markdown file
uses: devfle/readme-level-up@main
with:
github_username: GITHUB_USERNAME
github_token: ${{ secrets.GITHUB_TOKEN }}
- name: commit markdown file
run: |
git config --local user.email "github-actions[bot]@users.noreply.github.com"
git config --local user.name "github-actions[bot]"
git commit --allow-empty -am "update readme"
- name: push changes
uses: ad-m/github-push-action@master
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
branch: main
```
# Environment Variables
All available environment variables and their default values can be found in the [action.yml file.](../main/action.yml)
# Todos
I started the project because I had a fun idea and wanted to learn Python. Some things still need to be done:
- add types to all vars
- add error management
- add more data to level calculation
- add more options as env vars
- and more...
If you have any ideas about what could be optimized, feel free to create an issue.
# Contribution Guide
I appreciate any support with this project. If you have a suggestion for improvement or found a bug, please create a new issue. Please make sure that there is not already an existing issue for your request.
- This project uses the conventional [commits specification.](https://www.conventionalcommits.org/en/v1.0.0/#specification)
- Currently Python 3.11 is used.
- For development, we recommend the usage of the VS-Code Python linter from Microsoft (Pylance).
- Please test your changes before opening a new merge request.
You have to install some packages before starting to develop:
```bash
pip install -r requirements.txt
```
To start the script, you have to call:
```bash
python main.py
```
Please follow these coding guidelines:
```python
# var names in snake_case
var_name: int = 1
# function names in snake_case
def function_name -> None:
pass
# const names in uppercase
CONSTANT_NAME: int = 1
```