github-polyglot 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f117581b34a8275e8eeb3f1a08b0fb91bf9c00b2b58f3d13b97976d3bbeeb78c
+  data.tar.gz: 07b3a83f37124c1f46a5d4ef5be17d576276ed4ec12b55374473eea7fae60624
+SHA512:
+  metadata.gz: ceb3101add8014191e60d18d3adfc1cf894540ea95d5d8f548140699bbe789c8b2495976fda33ccc16a1c5d745561c825ffeba962b7c6d97e4f47f61a4e731c3
+  data.tar.gz: 473fb8f6d833d5b8c54051a27ceb98a79362c99d3ddbb01766971342eff082d774212d0d8532c573fa2717b5c90d7b23abd19a277ea860006d58d0232720443b

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Spenser Black
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,32 @@
+# github-polyglot
+
+[![CI](https://github.com/spenserblack/github-polyglot/actions/workflows/ci.yml/badge.svg)](https://github.com/spenserblack/github-polyglot/actions/workflows/ci.yml)
+
+Linguist, but for the user instead of the repository.
+
+This scans all of the repositories that the user has and compiles the language stats.
+The stats can be output as...
+
+- A human-readable terminal output
+- JSON
+- An SVG file resembling the language bar
+
+If the `GITHUB_TOKEN` environment variable is set, it can use that token to get more
+accurate stats and avoid rate-limiting. You can also avoid needing to pass `--username`
+if you have the token set.
+
+## Building
+
+### Prerequisites
+
+This project depends on [Linguist][github-linguist], which has some dependencies that
+may require extra steps. Read their documentation for more details.
+
+#### On Ubuntu
+
+```shell
+sudo apt install build-essential cmake pkg-config libicu-dev zlib1g-dev libcurl4-openssl-dev libssl-dev ruby-dev
+```
+
+[dotenv-gem]: https://github.com/bkeepers/dotenv
+[github-linguist]: https://github.com/github-linguist/linguist

data/exe/github-polyglot

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'dotenv'
+require 'github_polyglot'
+require 'github_polyglot/cli'
+
+Dotenv.load
+
+cli = GithubPolyglot::CLI.new
+cli.run

data/lib/github_polyglot/cli.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require 'dotenv'
+require 'optparse'
+
+class GithubPolyglot
+  # Class for the command-line interface
+  class CLI
+    FORMAT_OPTIONS = %i[print json pretty-json svg].freeze
+
+    def initialize
+      parser.parse!
+    end
+
+    # Runs the CLI
+    def run
+      Dotenv.load
+
+      token = ENV.fetch(GithubPolyglot::TOKEN_ENV_VAR, nil)
+      token = nil if token&.empty?
+      @polyglot = GithubPolyglot.new(username: @username, token: token)
+      output_format
+    end
+
+    private
+
+    def output_format
+      case format
+      when :print then @polyglot.print
+      when :json then puts @polyglot.json(pretty: false)
+      when :'pretty-json' then puts @polyglot.json(pretty: true)
+      when :svg then puts @polyglot.svg
+      else
+        throw NotImplementedError, "Unexpected format: #{format}"
+      end
+    end
+
+    def parser
+      parser = OptionParser.new
+      parser.on('-u USERNAME', '-l', '--username', '--login', 'The username/login of the GitHub user') do |value|
+        @username = value
+      end
+      parser.on('-F FORMAT', '--format', FORMAT_OPTIONS,
+                "The format to output in (#{FORMAT_OPTIONS.join('/')})") do |value|
+        @format = value
+      end
+
+      parser
+    end
+
+    def format
+      @format ||= :print
+    end
+  end
+end

data/lib/github_polyglot/svg/language_stats.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+class GithubPolyglot
+  class SVG
+    # Helper for language stats
+    module LanguageStats
+      # The number of the most popular languages to show. If there are more than this
+      # amount of languages, the least common get grouped under "Other" languages.
+      TOP_LANGUAGES = 6
+
+      # The number of columns in the language stats area.
+      STATS_COLUMNS = 2
+
+      # The height of a language stat row.
+      STAT_ROW_HEIGHT = 20
+
+      # Classes for the language name in language stats.
+      LANGUAGE_NAME_CLASS = 'text-bold'
+
+      # Class for the language percentage.
+      LANGUAGE_PERCENTAGE_CLASS = 'muted'
+
+      private
+
+      # Builds the language stats entries
+      def language_stats(xml)
+        summarized_languages.each_with_index do |(language, amount), index|
+          language_stat(xml, language, amount, index)
+        end
+      end
+
+      # Adds the language stat to the SVG
+      def language_stat(xml, language, amount, index)
+        x, y = language_stats_coordinates(index)
+        language_stat_circle(xml, language, x, y)
+        x += radius * 4
+        y += radius
+        language_stat_text(xml, language, amount, x, y)
+      end
+
+      # Adds the circle for the language stat
+      def language_stat_circle(xml, language, x_coord, y_coord)
+        fill = color(language)
+        xml.circle(cx: x_coord + radius, cy: y_coord + radius, r: radius, fill: fill)
+      end
+
+      # Adds the text for the language stat
+      def language_stat_text(xml, language, amount, x_coord, y_coord)
+        percentage = (amount * 100.0 / total_amount).round(1)
+        xml.text_(x: x_coord, y: y_coord, 'dominant-baseline': 'middle') do
+          xml.tspan(class: LANGUAGE_NAME_CLASS) do
+            xml.text language.to_s
+          end
+          xml.tspan(class: LANGUAGE_PERCENTAGE_CLASS) { xml.text " #{percentage}%" }
+        end
+      end
+
+      # Gets coordinates for where the language stats should be.
+      def language_stats_coordinates(index)
+        y_offset = BAR_HEIGHT + BAR_PADDING
+        row_num = index / STATS_COLUMNS
+        col_num = index % STATS_COLUMNS
+        x = (width.to_f / STATS_COLUMNS) * col_num
+        y = y_offset + (row_num * STAT_ROW_HEIGHT)
+        [x, y]
+      end
+    end
+  end
+end

data/lib/github_polyglot/svg.css

@@ -0,0 +1,25 @@
+:root {
+  font-family: "Noto Sans", Helvetica, Arial, system-ui, sans-serif;
+  font-size: 12px;
+  font-weight: 400;
+  --text-color: #1F2328;
+  --text-color-muted: #59636E;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --text-color: #D1D7E0;
+    --text-color-muted: #9198A1;
+  }
+}
+
+text, tspan {
+  fill: var(--text-color);
+}
+tspan.muted {
+  fill: var(--text-color-muted);
+}
+
+.text-bold {
+  font-weight: 600;
+}

data/lib/github_polyglot/svg.rb

@@ -0,0 +1,161 @@
+# frozen_string_literal: true
+
+require 'linguist'
+require 'nokogiri'
+require 'github_polyglot/svg/language_stats'
+
+class GithubPolyglot
+  # Generates SVG for language stats
+  class SVG
+    include LanguageStats
+
+    # Width of the SVG image
+    WIDTH = 300
+
+    # Height of the language bar
+    BAR_HEIGHT = 8
+
+    # Padding underneath the language bar
+    BAR_PADDING = 8
+
+    # Radii of rounded elements
+    RADII = 5
+
+    # The name of the entry for remaining languages.
+    OTHER_LANGUAGES = :Other
+
+    # The default color to use if a language doesn't have a color
+    DEFAULT_COLOR = '#EDEDED'
+
+    # The CSS text that gets applied to the SVG.
+    CSS = File.read(File.expand_path('svg.css', __dir__))
+
+    # @param [Hash] languages Maps language name symbols to amounts.
+    def initialize(languages)
+      @languages = languages
+    end
+
+    # Creates an SVG string
+    def generate
+      mask_id = 'mask'
+      builder = Nokogiri::XML::Builder.new do |xml|
+        xml.svg(xmlns: 'http://www.w3.org/2000/svg', width: width, height: height, viewBox: view_box) do
+          xml.style(type: 'text/css') { xml.cdata(CSS) }
+          body(xml, mask_id)
+        end
+      end
+
+      builder.to_xml
+    end
+
+    # Gets the width of the SVG
+    def width
+      WIDTH
+    end
+
+    # Gets the height of the SVG
+    def height
+      BAR_HEIGHT + BAR_PADDING + stats_height
+    end
+
+    # Gets the radii of rounded elements
+    def radii
+      RADII
+    end
+
+    # Alias for radii
+    def radius
+      RADII
+    end
+
+    private
+
+    # The view box for the SVG
+    def view_box
+      [0, 0, width, height].map(&:to_s).join(' ')
+    end
+
+    # Builds the xml body
+    def body(xml, mask_id)
+      xml.defs do
+        mask(xml, mask_id)
+      end
+      language_group(xml, mask_id)
+      language_stats(xml)
+    end
+
+    # Builds the mask for the rounded corners.
+    def mask(xml, id)
+      xml.mask('mask-type': 'luminance', id: id) do
+        xml.rect(x: 0, y: 0, width: width, height: BAR_HEIGHT, rx: radius, ry: radius, fill: 'white')
+      end
+    end
+
+    # Builds the language bar
+    def language_group(xml, mask_id)
+      xml.g(mask: "url(##{mask_id})") do
+        language_x = 0.0
+        summarized_languages.each do |language, amount|
+          language_x = language_entry(xml, language_x, language, amount)
+        end
+      end
+    end
+
+    # Builds a single language entry for the language bar
+    # @return [Integer, Float] The new offset on the X-axis for the next language entry
+    def language_entry(xml, x_offset, language, amount)
+      ratio = amount / total_amount
+      language_width = width * ratio
+      fill = color(language)
+
+      xml.rect(x: x_offset, y: 0, width: language_width, height: BAR_HEIGHT, fill: fill)
+
+      x_offset + language_width
+    end
+
+    # Returns the languages sorted by amount.
+    def sorted_languages
+      @sorted_languages ||= @languages.sort_by { |_, amount| -amount }
+    end
+
+    # Returns the language entries, but groups the least popular under `:Other`.
+    def summarized_languages
+      return @summarized_languages if @summarized_languages
+
+      languages = sorted_languages
+      return @summarized_languages = languages if languages.length <= TOP_LANGUAGES
+
+      @summarized_languages = languages.slice(0, TOP_LANGUAGES)
+      @summarized_languages << [OTHER_LANGUAGES, languages[TOP_LANGUAGES..].inject(0) do |total, (_, amount)|
+        total + amount
+      end]
+    end
+
+    # Gets the total amount for languages.
+    def total_amount
+      @total_amount ||= @languages.values.sum.to_f
+    end
+
+    # Gets the color as a hex code string or CSS color for a language.
+    #
+    # @param [String, Symbol] language The name of the language.
+    def color(language)
+      return DEFAULT_COLOR if language == OTHER_LANGUAGES
+
+      language = language.to_s
+
+      Linguist::Language[language]&.color || DEFAULT_COLOR
+    end
+
+    # Gets the height of the language stats entries.
+    def stats_height
+      stats_rows * STAT_ROW_HEIGHT
+    end
+
+    # Gets the number of rows for language stats entries.
+    def stats_rows
+      # NOTE: + 1 because of the potential extra "Other" entry
+      ((TOP_LANGUAGES + 1) / STATS_COLUMNS.to_f).ceil
+    end
+  end
+end

data/lib/github_polyglot.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+require 'github_polyglot/svg'
+require 'json'
+require 'octokit'
+
+# Gets language usage stats for a GitHub user.
+class GithubPolyglot
+  TOKEN_ENV_VAR = 'GITHUB_TOKEN'
+
+  # @param [String, Nil] username The username to look up.
+  # @param [String, Nil] token The GitHub token to use in requests.
+  def initialize(username: nil, token: nil)
+    @username = username
+    @token = token
+    @client = Octokit::Client.new(access_token: token)
+  end
+
+  # Gets the username to use.
+  def username
+    return @username unless @username.nil?
+
+    @username = token_username
+    @username
+  end
+
+  # Gets language stats for the user.
+  def languages
+    compiled = Hash.new(0)
+    each_repo do |repo|
+      next if repo[:fork]
+
+      languages = repo_languages(repo.name)
+      languages.to_h.each_pair do |language, size|
+        compiled[language] += size
+      end
+    end
+    compiled
+  end
+
+  # Gets the language stats for the user as JSON.
+  def json(pretty: false)
+    options = pretty ? { indent: '  ', space: ' ' } : { indent: '', space: '', array_nl: '', object_nl: '' }
+    JSON.pretty_generate(languages, options)
+  end
+
+  # Prints the languages
+  def print
+    languages.each_pair do |language, amount|
+      puts "#{language}: #{amount}"
+    end
+  end
+
+  # Generates an SVG string for the languages
+  def svg
+    generator = SVG.new(languages)
+    generator.generate
+  end
+
+  private
+
+  # Gets the language stats for a single repository from the GitHub API.
+  #
+  # @param [String] repository The name of the owner's repository.
+  def repo_languages(repository_name)
+    @client.languages(repo_qualifier(repository_name))
+  end
+
+  # Returns the repository path (`owner/repository`) using the username as the owner.
+  def repo_qualifier(repository_name)
+    "#{username}/#{repository_name}"
+  end
+
+  # Yields each repository
+  def each_repo(&block)
+    page = 1
+    loop do
+      repos = @client.repos(username, query: { page: page })
+      break unless repos && !repos.empty?
+
+      repos.each(&block)
+      page += 1
+    end
+  end
+
+  # Gets the username for the authenticated token.
+  # @return [String, Nil] The authenticated user.
+  def token_username
+    return nil if @token.nil?
+
+    @client.user.login
+  end
+end

metadata

@@ -0,0 +1,146 @@
+--- !ruby/object:Gem::Specification
+name: github-polyglot
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Spenser Black
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2026-06-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: dotenv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: faraday-retry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+- !ruby/object:Gem::Dependency
+  name: github-linguist
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '9.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '9.3'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.18'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.18'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.18'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.18.10
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.18'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.18.10
+- !ruby/object:Gem::Dependency
+  name: octokit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+description: "(Unofficial) Fetches and aggregates language usage statistics for a
+  GitHub user"
+email:
+executables:
+- github-polyglot
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- exe/github-polyglot
+- lib/github_polyglot.rb
+- lib/github_polyglot/cli.rb
+- lib/github_polyglot/svg.css
+- lib/github_polyglot/svg.rb
+- lib/github_polyglot/svg/language_stats.rb
+homepage: https://github.com/spenserblack/github-polyglot
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/spenserblack/github-polyglot
+  source_code_uri: https://github.com/spenserblack/github-polyglot
+  github_repo: https://github.com/spenserblack/github-polyglot
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: "(Unofficial) Language stats for the GitHub user"
+test_files: []