semvec/pypi-packages huggingface dataset:
git-star-percentile 1.8
A simple tool to quantify your GitHub repo star percentile.
License: MIT
Keywords: GitHub, repository, star, popularity, percentile

<h1 align="center">
&#11088; <code>GitStarPercentile</code>
</h1>

<div align="center">

[![Twitter](https://img.shields.io/twitter/follow/ChenLiu-1996.svg?style=social)](https://twitter.com/ChenLiu_1996)
[![LinkedIn](https://img.shields.io/badge/LinkedIn-ChenLiu-1996?color=blue)](https://www.linkedin.com/in/chenliu1996/)
<br>
[![Latest PyPI version](https://img.shields.io/pypi/v/git-star-percentile.svg)](https://pypi.org/project/git-star-percentile/)
[![PyPI download 3 month](https://static.pepy.tech/badge/git-star-percentile)](https://pepy.tech/projects/git-star-percentile)
[![PyPI download month](https://img.shields.io/pypi/dm/git-star-percentile.svg)](https://pypistats.org/packages/git-star-percentile)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

</div>

<br>

&#129300; Have you ever wondered **how popular your GitHub repository really is**?

&#x1F620; Frustrated that GitHub **doesn’t show star percentiles anywhere**?

Maybe you’ve thought:
> "I have 200 stars — but is that a lot?"

> "Where does my repo rank compared to the other repos?"

<br>
<code>GitStarPercentile</code> tells you instantly:

Enter your star count and instantly see your percentile, calculated from GitHub-wide data.


## &#128640; Features

- &#128202; **Instant percentile lookup** — get your repo’s rank in milliseconds.
- &#128421; **Simple CLI** — just type `git-star-percentile` and enter your star count.


## &#128230; Installation
From the command line:

```bash
pip install git-star-percentile --upgrade
```

## &#9889; Usage
From the command line:

```bash
git-star-percentile
```

You’ll be prompted to enter the number of stars for your repository:

```bash
Enter the number of GitHub stars: 200
Your repo is approximately among the top xx.xxxx%.
```

## &#128196; Data Source

### If we count all public repositories:
<div align="center">
    <img src="assets/github_stars_distribution_all.png" alt="GitHub Stars Distribution" style="max-width:100%; height:auto;">
</div>

### If we only count public repositories with at least 1 star:
<div align="center">
    <img src="assets/github_stars_distribution_nonzero.png" alt="GitHub Stars Distribution" style="max-width:100%; height:auto;">
</div>


- Star statistics are **pulled from all public GitHub repositories**.
- Data is stored in [stats/github_repo_stars.csv](stats/github_repo_stars.csv).
- Want fresher stats? Run [the stats counter](count_all_repo_stars.py) yourself and submit a pull request.
    ```bash
    python count_all_repo_stars.py --github-token $YOUR_GITHUB_TOKEN
    ```

    The line above would run over all public repositories. For a more manageable run, sample 1 million instead.
    ```bash
    python count_all_repo_stars.py --github-token $YOUR_GITHUB_TOKEN --sample-size 1000000
    ```

    Note I will not consider merging results with `--sample-size` below 1 million.
TUI-game 0.1.0
A library for implementing something similar to Pygame in the command line.
License: MIT
Requires Python: >=3.0

# TUI-game

A simple Text-Based User Interface (TUI) game framework for creating terminal-based games. This module allows you to create a text-based game with mouse control, character placement, and screen updates.

## Features

- Initialize screen dimensions based on user input.
- Control a mouse cursor using 'w', 's', 'a', 'd' keys.
- Place characters at specific coordinates on the screen.
- Refresh the screen to reflect changes.
- Exit the game loop gracefully.

## Installation

To install `TUI-game`, you can use pip:

```bash
pip install TUI-game
```

Usage

Basic Example

Here's a basic example of how to use the `TUI-game` module:

```python
import TUI_game
import time

# Initialize the game screen
TUI_game.initialize()

# Main game loop
while True:
    if not TUI_game.run():
        break
    TUI_game.update_screen()
    time.sleep(0.001)  # Add a brief delay to prevent the program from running too fast
```

Customizing the Game Loop

You can also customize the game loop by adding your own logic:

```python
import TUI_game
import time

# Initialize the game screen
TUI_game.initialize()

# Custom game loop
while True:
    # Place a character at a specific position
    TUI_game.place_character('X', (5, 5))
    
    # Move the mouse cursor
    TUI_game.move_mouse('w')
    
    # Process user input
    if not TUI_game.run():
        break
    
    # Update the screen
    TUI_game.update_screen()
    
    # Add a brief delay
    time.sleep(0.001)
```

Functions

`initialize()`
Initializes the screen dimensions and content. This function must be called before entering the game loop.

`run()`
Processes user input and returns `True` to continue the game loop or `False` to exit.

`update_screen()`
Refreshes the screen to reflect changes.

`place_character(character, position)`
Places a character at the specified coordinates on the screen.

`move_mouse(direction)`
Moves the mouse cursor in the specified direction ('w', 's', 'a', 'd').

Contributing

Contributions are welcome! If you have any suggestions or improvements, please feel free to open an issue or submit a pull request.

License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.