Metadata-Version: 2.1
Name: linguist-breakdown
Version: 2.0.0
Summary: View the language breakdown of your entire GitHub account.
Home-page: http://github.com/justintime50/linguist-breakdown
Author: Justintime50
License: MIT
Description: <div align="center">
        
        # Linguist Breakdown
        
        View the language breakdown of your entire GitHub account.
        
        [![Build Status](https://github.com/Justintime50/linguist-breakdown/workflows/build/badge.svg)](https://github.com/Justintime50/linguist-breakdown/actions)
        [![Coverage Status](https://coveralls.io/repos/github/Justintime50/linguist-breakdown/badge.svg?branch=main)](https://coveralls.io/github/Justintime50/linguist-breakdown?branch=main)
        [![PyPi](https://img.shields.io/pypi/v/linguist-breakdown)](https://pypi.org/project/linguist-breakdown)
        [![Licence](https://img.shields.io/github/license/justintime50/linguist)](https://opensource.org/licenses/mit-license.php)
        
        <img src="assets/showcase.png">
        
        </div>
        
        GitHub displays beautiful language breakdowns on each repo on their website; however, they do not show your entire language breakdown across all your projects.
        
        Linguist Breakdown can return the language breakdown of your personal repos or all repos you have access to individually via the command line, then Linguist Breakdown will build a customized pie chart breakdown of your overall language usage across all repos (limited to the top 8 for clarity; all languages are returned via CLI). Configure some settings and quickly find out what languages you use the most!
        
        **Sample Output:**
        
        ```bash
        Overall language breakdown:
        
        {
            "JavaScript": 33.77,
            "PHP": 27.36,
            "HTML": 12.33,
            "Python": 8.5,
            "Shell": 5.49,
            "CSS": 5.44,
            "Blade": 3.91,
            "Go": 0.77,
            "Dockerfile": 0.39,
            "C#": 0.39,
            "Hack": 0.38,
            "Makefile": 0.34,
            "Java": 0.34,
            "Ruby": 0.2,
            "Emacs Lisp": 0.09,
            "Vue": 0.08,
            "PowerShell": 0.06,
            "Batchfile": 0.05,
            "TSQL": 0.05,
            "Zimpl": 0.03,
            "JSONiq": 0.01,
            "VBScript": 0.01
        }
        ```
        
        ## Install
        
        ```bash
        # Install tool
        pip3 install linguist-breakdown
        
        # Install locally
        make install
        
        # Get Makefile help
        make help
        ```
        
        ## Usage
        
        **NOTE:** Percentages may vary from the terminal output and chart depending on how many chart pieces you elect to use (eg: using only 4 chart pieces when you have 10 languages that output on the console).
        
        ```
        Usage:
            GITHUB_TOKEN=123... linguist-breakdown --type private --pieces 4 --forks --chart
        
        Options:
            -h, --help            show this help message and exit
            -t TYPE, --type TYPE  The repo type to look at (OPTIONS: all, owner, member, private, public).
            -p PIECES, --pieces PIECES
                                    Number of chart pieces to generate (will use greatest percentages)
            -f, --forks           Include forked repos in the language breakdown.
            -c, --chart           Generate a chart of the language breakdown.
        ```
        
        ## Development
        
        ```bash
        # Lint the project
        make lint
        
        # Run tests
        make test
        
        # Run test coverage
        make coverage
        
        # Run the tool locally
        venv/bin/python linguist_breakdown/breakdown.py --help
        ```
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Provides-Extra: dev
