Metadata-Version: 2.1
Name: unfollow
Version: 5.0.1
Summary: 😡 Python CLI tool that shows you who has unfollowed you on GitHub
Home-page: https://github.com/TechWiz-3/who-unfollowed-me
Author: Zac the Wise aka TechWiz-3
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Environment :: Console :: Curses
Classifier: Intended Audience :: Developers
Classifier: Operating System :: Microsoft :: Windows
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Utilities
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rich

# Who Unfollowed Me

## Python Implementation

<img src="https://github.com/TechWiz-3/who-unfollowed-me/blob/main/media/regular.png?raw=true" width="700px"></img>  

### About

Python CLI tool that shows you who has unfollowed you on GitHub.  
Heavily inspired by [msaaddev/who-unfollowed-me](https://github.com/msaaddev/who-unfollowed-me)  

### Installation

![PyPI - Downloads](https://img.shields.io/pypi/dm/unfollow?style=flat-square&color=blue)

```py
pip install unfollow
```

### Usage

The first time you run the tool, you will be asked to enter your GitHub username. Subsequent runs will show any unfollowers, with names and links.  

I used this project to learn a lot about [rich](https://github.com/Textualize/rich), thus I created numerous themes which you can use.

`unfollow` - colored text and some panels  
`unfollow panels` - colored text inside panels  
`unfollow bubbles` - all text inside beautiful bubbles - requires a nerd font  
`unfollow simple` - no colors or emojis, just plain text and a table  

### Inspiration

As mentioned, [msaaddev/who-unfollowed-me](https://github.com/msaaddev/who-unfollowed-me) was the reason I created this project and has been a great reference. While I love the project, three things stood out to me that I wanted to improve in my own implementation:

1. The data files for the tool are not hidden and are stored in your current directory rather than the home directory
2. Output looks good but a huge amount is self promotion rather than actual relevant info. (Please don't get me wrong, everyone can self promote as much as they like, I'm just talking about what I wanted to improve)
3. If the tool is run without internet connection, the file that stores the username is erased

### Gallery

#### Bubbles (w/nerd font)

<img src="https://github.com/TechWiz-3/who-unfollowed-me/blob/main/media/bubbles.png?raw=true" ></img>

#### Panels

<img src="https://github.com/TechWiz-3/who-unfollowed-me/blob/main/media/panels.png?raw=true" ></img>

### Development

1. Clone the repo and cd into it:
```
git clone https://github.com/TechWiz-3/who-unfollowed-me.git
cd who-unfollowed-me
```
2. Ensure `poetry` is installed by running:`pip install poetry`
3. Run: `poetry install`
4. Make your changes
5. To test your changes, run: `poetry run unfollow` in project root directory

---

### 🎉 Commit labels

If you're interested in the commit labels used in this repo, check out my [git-commit-emoji](https://github.com/TechWiz-3/git-commit-emojis) project
