https://github.com/b1f6c1c4/pythoness
Check how pythonic a Github user is.
https://github.com/b1f6c1c4/pythoness
demography github programming-language python
Last synced: 10 months ago
JSON representation
Check how pythonic a Github user is.
- Host: GitHub
- URL: https://github.com/b1f6c1c4/pythoness
- Owner: b1f6c1c4
- License: agpl-3.0
- Created: 2019-01-31T02:12:36.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2025-03-11T19:35:27.000Z (11 months ago)
- Last Synced: 2025-03-19T03:57:58.228Z (10 months ago)
- Topics: demography, github, programming-language, python
- Language: JavaScript
- Homepage:
- Size: 91.8 KB
- Stars: 3
- Watchers: 1
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# pythoness
[](https://www.npmjs.com/package/pythoness)
[](https://www.npmjs.com/package/pythoness)
[](https://github.com/b1f6c1c4/pythoness)
[](https://github.com/b1f6c1c4/pythoness)
[](https://github.com/b1f6c1c4/pythoness/blob/master/LICENSE.md)
> Check how pythonic a Github user is.
:heavy_exclamation_mark:
:heavy_exclamation_mark:
**DO NOT judge any one based on how pythonic/a-pythonic they are/it is.**
:heavy_exclamation_mark:
:heavy_exclamation_mark:
## TL;DR
```sh
npm i -g pythoness
# Generate a token at https://github.com/settings/tokens
echo the-token > ~/.pythoness
pythoness # Check your daily Pythoness, public & private
pythoness --public # Check your daily Pythoness, public repo only
pythoness b1f6c1c4 # How Pythonic another user is? (public only)
```
## Installation
```sh
$ npm install --global pythoness
```
## Usage
```
pythoness []
Check pythoness of a Github user
Commands:
pythoness.js show-limit Show GitHub API usage and limit
pythoness.js check [] Check pythoness of a Github user [default]
Positionals:
who Github username [string]
Options:
--version Show version number [boolean]
--token-file Github token file for full control of private repos, see
https://github.com/settings/tokens
[string] [default: "~/.pythoness"]
-t, --token Github token for full control of private repos, see
https://github.com/settings/tokens [string]
--public Ignore all private repos [boolean]
--help Show help [boolean]
-s, --self Check their own repos [boolean] [default: true]
-S, --star Include starred repos [boolean] [default: true]
-f, --following Check following's repos (depth=1) [boolean] [default: true]
-F, --followers Check followers' repos (depth=1) [boolean] [default: true]
```
## FAQ
### Why this program is written in JavaScript, not Python?
Because of neutrality of accounting.
### How Pythoness calculated?
#### Pythoness of a single repo
)
where 
is the ratio of Python bytes among all code bytes (the proportion of Python blue in the Github webpage).
#### Self-Pythoness of an user
Self-Pythoness of an user is defined to be the "congress" average of their repos' Pythoness.
First, a repo is assigned senate and the house seats, separatedly, based on the following rules:
| type | Senate seats | The House seats |
| --- | --- | --- |
| owner, empty, source | 100 | 0 |
| owner, empty, fork | 1 | 0 |
| owner, non-empty, source | 1000 | Number of total code bytes |
| owner, non-empty, fork | 50 | 0 |
| non-owner, starred | 10 | 0 |
Then, senate and the house will "vote", or calculate weighted arithmetic average.
Finally, the "congress" average is defined as
#### Following-Pythoness of an user
First, all users followed by the targeted user will be enumerated and have their self-pythoness calculated.
Next, each one is assigned senate and the house seats, separatedly, based on the following rules:
| type | Senate seats | The House seats |
| --- | --- | --- |
| has written at least one byte code | 1000 | Number of total code bytes |
| has not writeen any code | 10 | 0 |
Then follow the same procedure as above.
#### Followers-Pythoness of an user
All users following the targeted user will be enumerated and have their self-pythoness calculated.
The same procedure as above applies.
#### Final Pythoness of an user
It's defined as the RMS (root-mean-square) of their self-, following-, followers- Pythoness (whichever enabled in the command line).
## Legal
This repo is licensed with GNU AGPLv3 or later.
Again, the output of this program has absolutely no relationship with the Github user's personality, morality, and/or technical skills.
Do NOT judge any person, organization, or entity based on how pythonic they are(aren't)/it is(isn't).
The author(s) hold(s) absolutely no liability for anything caused by any interpretation of pythonic information, including but not limited to the output of this program.