RubyGems - default-avatar-generator - Versions diffs - 0.1.0 - Mend

default-avatar-generator 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (28) hide show

checksums.yaml +7 -0
data/CHANGELOG.md +13 -0
data/README.md +52 -0
data/lib/assets/backgrounds/gradient-2h.svg +19 -0
data/lib/assets/backgrounds/gradient-3h.svg +24 -0
data/lib/assets/backgrounds/gradient-backslash.svg +12 -0
data/lib/assets/backgrounds/gradient-lr.svg +12 -0
data/lib/assets/backgrounds/gradient-slash.svg +12 -0
data/lib/assets/backgrounds/gradient-tb.svg +12 -0
data/lib/assets/backgrounds/solid.svg +3 -0
data/lib/assets/foregrounds/head1-hollow.svg +7 -0
data/lib/assets/foregrounds/head1-solid.svg +7 -0
data/lib/assets/foregrounds/head2.svg +7 -0
data/lib/assets/foregrounds/head3.svg +9 -0
data/lib/assets/text/base.svg +4 -0
data/lib/assets/text/hack.svg +4 -0
data/lib/default_avatar_generator/background_layer.rb +12 -0
data/lib/default_avatar_generator/colors.rb +346 -0
data/lib/default_avatar_generator/composer.rb +18 -0
data/lib/default_avatar_generator/foreground_layer.rb +16 -0
data/lib/default_avatar_generator/generator.rb +93 -0
data/lib/default_avatar_generator/image_converter.rb +27 -0
data/lib/default_avatar_generator/layer.rb +44 -0
data/lib/default_avatar_generator/svg_utils.rb +12 -0
data/lib/default_avatar_generator/text_layer.rb +12 -0
data/lib/default_avatar_generator/version.rb +5 -0
data/lib/default_avatar_generator.rb +17 -0
metadata +98 -0

checksums.yaml ADDED Viewed

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 74971c4d340f209e3c83dc104158b023f74ce58c47bbf01c99b4f716bb2b75d0
+  data.tar.gz: 34d505f98d67c5d944001bd5a0d7de6b78bf9dd75226088cc9e53416c0678890
+SHA512:
+  metadata.gz: '03832b376aad000e209eafdd17c114aa94672e8916013375ac4eff993eb0652a8b1d4646e3dcea81deece7b802ac3f233dad14c010fe939164d109fdfe69b1d0'
+  data.tar.gz: f3203f2a6adc655f5a8ec8e736aafa586e10550e0082fbee9ce1c269fc4a8bce666d61d94003be78c9f41f80883429c04cdf491d4e4dd00ca22d83d2d96bb637

data/CHANGELOG.md ADDED Viewed

@@ -0,0 +1,13 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+## [0.1.0] - 2024-04-08
+### Added
+- Initial project setup as a ruby gem
+- Generates SVG and JPEG images based on the included SVG files

data/README.md ADDED Viewed

@@ -0,0 +1,52 @@
+# Default Avatar Generator
+[![CI](https://github.com/pas256/default-avatar-generator/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/pas256/default-avatar-generator/actions/workflows/ci.yml)
+A Ruby gem that generates beautiful default avatars for user accounts when no custom avatar is provided.
+## Installation
+Add this line to your application's Gemfile:
+```ruby
+gem 'default-avatar-generator'
+```
+And then execute:
+    $ bundle install
+Or install it yourself as:
+    $ gem install default-avatar-generator
+## Usage
+```ruby
+require 'default_avatar_generator'
+# Generate an avatar for a user
+generator = DefaultAvatarGenerator::Generator.new(text: { character: "A" })
+svg_avatar = generator.generate
+jpeg_avatar = DefaultAvatarGenerator::ImageConverter.svg_to_jpeg(svg_avatar)
+# Save the avatar to a file (if you need to)
+```
+## Development
+After checking out the repo:
+    bundle install
+    ./viewer
+This will bring up a development server on http://localhost:9292 where you can reload the page and keep generating new avatars.
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+## Contributing
+Bug reports and pull requests are welcome on GitHub. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](CODE_OF_CONDUCT.md).
+## License
+The gem is available as open source under the terms of the [MIT License](LICENSE).

data/lib/assets/backgrounds/gradient-2h.svg ADDED Viewed

@@ -0,0 +1,19 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <g>
+    <!-- Definitions for the gradients -->
+    <defs>
+      <linearGradient id="gradient1" x1="0%" y1="0%" x2="100%" y2="0%">
+        <stop offset="0%" stop-color="{{color1}}" />
+        <stop offset="100%" stop-color="{{color2}}" />
+      </linearGradient>
+      <linearGradient id="gradient2" x1="0%" y1="0%" x2="100%" y2="0%">
+        <stop offset="0%" stop-color="{{color3}}" />
+        <stop offset="100%" stop-color="{{color4}}" />
+      </linearGradient>
+    </defs>
+    <!-- Three horizontal bands with gradients -->
+    <rect x="0" y="0" width="512" height="256" fill="url(#gradient1)" />
+    <rect x="0" y="256" width="512" height="256" fill="url(#gradient2)" />
+  </g>
+</svg>

data/lib/assets/backgrounds/gradient-3h.svg ADDED Viewed

@@ -0,0 +1,24 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <g>
+    <!-- Definitions for the gradients -->
+    <defs>
+      <linearGradient id="gradient1" x1="0%" y1="0%" x2="100%" y2="0%">
+        <stop offset="0%" stop-color="{{color1}}" />
+        <stop offset="100%" stop-color="{{color2}}" />
+      </linearGradient>
+      <linearGradient id="gradient2" x1="0%" y1="0%" x2="100%" y2="0%">
+        <stop offset="0%" stop-color="{{color3}}" />
+        <stop offset="100%" stop-color="{{color4}}" />
+      </linearGradient>
+      <linearGradient id="gradient3" x1="0%" y1="0%" x2="100%" y2="0%">
+        <stop offset="0%" stop-color="{{color5}}" />
+        <stop offset="100%" stop-color="{{color6}}" />
+      </linearGradient>
+    </defs>
+    <!-- Three horizontal bands with gradients -->
+    <rect x="0" y="0" width="512" height="170" fill="url(#gradient1)" />
+    <rect x="0" y="170" width="512" height="172" fill="url(#gradient2)" />
+    <rect x="0" y="342" width="512" height="170" fill="url(#gradient3)" />
+  </g>
+</svg>

data/lib/assets/backgrounds/gradient-backslash.svg ADDED Viewed

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <g>
+    <defs>
+      <linearGradient id="gradient1" x1="0%" y1="100%" x2="100%" y2="0%">
+        <stop offset="0%" stop-color="{{color1}}" />
+        <stop offset="100%" stop-color="{{color2}}" />
+      </linearGradient>
+    </defs>
+    <rect x="0" y="0" width="512" height="512" fill="url(#gradient1)" />
+  </g>
+</svg>

data/lib/assets/backgrounds/gradient-lr.svg ADDED Viewed

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <g>
+    <defs>
+      <linearGradient id="gradient1" x1="0%" y1="0%" x2="100%" y2="0%">
+        <stop offset="0%" stop-color="{{color1}}" />
+        <stop offset="100%" stop-color="{{color2}}" />
+      </linearGradient>
+    </defs>
+    <rect x="0" y="0" width="512" height="512" fill="url(#gradient1)" />
+  </g>
+</svg>

data/lib/assets/backgrounds/gradient-slash.svg ADDED Viewed

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <g>
+    <defs>
+      <linearGradient id="gradient1" x1="0%" y1="0%" x2="100%" y2="100%">
+        <stop offset="0%" stop-color="{{color1}}" />
+        <stop offset="100%" stop-color="{{color2}}" />
+      </linearGradient>
+    </defs>
+    <rect x="0" y="0" width="512" height="512" fill="url(#gradient1)" />
+  </g>
+</svg>

data/lib/assets/backgrounds/gradient-tb.svg ADDED Viewed

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <g>
+    <defs>
+      <linearGradient id="gradient1" x1="0%" y1="0%" x2="0%" y2="100%">
+        <stop offset="0%" stop-color="{{color1}}" />
+        <stop offset="100%" stop-color="{{color2}}" />
+      </linearGradient>
+    </defs>
+    <rect x="0" y="0" width="512" height="512" fill="url(#gradient1)" />
+  </g>
+</svg>

data/lib/assets/backgrounds/solid.svg ADDED Viewed

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <rect x="0" y="0" width="512" height="512" fill="{{color1}}" />
+</svg>

data/lib/assets/foregrounds/head1-hollow.svg ADDED Viewed

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <g transform="{{transformation}}">
+    <path
+      d="M 276.506 38.653 C 251.084 38.653 226.657 44.164 203.86 54.93 C 174.909 68.413 150.391 89.677 132.93 116.455 C 114.927 144.047 105.427 175.983 105.427 209.005 L 105.427 232.257 L 74.668 291.062 C 68.787 302.371 68.515 313.951 73.944 322.998 C 79.372 332.044 89.776 337.201 102.532 337.201 L 105.427 337.201 L 105.427 383.432 C 105.427 408.493 125.784 428.849 150.843 428.849 C 151.477 428.849 152.02 428.849 152.651 428.757 L 184.226 424.052 L 184.226 455.807 C 184.226 456.261 184.226 456.805 184.317 457.257 C 185.222 468.475 194.27 476.798 205.759 476.798 C 207.117 476.798 208.473 476.708 209.92 476.435 L 374.126 447.304 C 386.066 445.223 395.476 434.006 395.476 421.882 L 395.476 330.506 C 428.137 298.573 446.682 254.512 446.682 208.823 C 446.682 115.01 370.324 38.653 276.506 38.653 Z M 374.94 316.213 C 372.405 318.566 370.959 321.822 370.959 325.168 L 370.959 421.702 C 370.867 422.154 370.235 422.968 369.783 423.149 L 208.563 451.646 L 208.473 409.578 C 208.473 406.049 206.935 402.613 204.22 400.35 C 201.96 398.45 199.154 397.364 196.26 397.364 C 195.626 397.364 195.084 397.364 194.449 397.456 L 149.849 404.059 C 138.631 403.607 129.673 394.379 129.673 383.07 L 129.673 324.626 C 129.673 317.841 124.245 312.412 117.46 312.412 L 102.532 312.412 C 97.918 312.412 95.476 311.147 94.843 310.06 C 94.208 308.974 94.12 306.171 96.289 302.099 L 128.496 240.67 C 129.402 238.95 129.855 236.96 129.855 234.97 L 129.855 208.733 C 129.855 152.275 162.966 100.529 214.174 76.737 L 214.264 76.737 C 233.715 67.691 254.704 63.073 276.506 63.073 C 356.845 63.073 422.256 128.484 422.256 208.823 C 422.256 249.537 404.976 288.71 374.94 316.213 Z"
+      fill="{{color}}" transform="matrix(1, 0, 0, 1, -1.4210854715202004e-14, 0)" />
+  </g>
+</svg>

data/lib/assets/foregrounds/head1-solid.svg ADDED Viewed

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <g transform="{{transformation}}">
+    <path
+      d="M 276.506 38.653 C 251.084 38.653 226.657 44.164 203.86 54.93 C 174.909 68.413 150.391 89.677 132.93 116.455 C 114.927 144.047 105.427 175.983 105.427 209.005 L 105.427 232.257 L 74.668 291.062 C 68.787 302.371 68.515 313.951 73.944 322.998 C 79.372 332.044 89.776 337.201 102.532 337.201 L 105.427 337.201 L 105.427 383.432 C 105.427 408.493 125.784 428.849 150.843 428.849 C 151.477 428.849 152.02 428.849 152.651 428.757 L 184.226 424.052 L 184.226 455.807 C 184.226 456.261 184.226 456.805 184.317 457.257 C 185.222 468.475 194.27 476.798 205.759 476.798 C 207.117 476.798 208.473 476.708 209.92 476.435 L 374.126 447.304 C 386.066 445.223 395.476 434.006 395.476 421.882 L 395.476 330.506 C 428.137 298.573 446.682 254.512 446.682 208.823 C 446.682 115.01 370.324 38.653 276.506 38.653 Z"
+      fill="{{color}}" transform="matrix(1, 0, 0, 1, -1.4210854715202004e-14, 0)" />
+  </g>
+</svg>

data/lib/assets/foregrounds/head2.svg ADDED Viewed

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <g transform="{{transformation}}">
+    <path
+      d="M204.6,20.6c-46,3.2-86.2,19.6-113,46c-10.8,10.8-17.6,19.6-24.8,32.6C53.6,122.8,46,155.2,46,186.6c0,24.8,5.8,41.6,28.2,80.4c18.4,31.8,24.2,44,31,63.4c7.4,22,10.6,41.4,10.6,67c0,25.2-3.6,48.4-11,76c-1.8,6.4-3.2,12.2-3.2,12.8c0,0.6,1,2.2,2.4,3.4l2,1.8h108.4h108.4l2.2-2.4c2.4-2.2,2.4-2.4,2.4-19.2c0-18.4,1.6-33.8,4.4-41c1.6-4.2,2-4.6,5.8-5.8c2.2-0.6,11.8-1.6,21.2-2.2c28.2-1.6,39.8-3.8,51-9.4c6.4-3.4,13.6-10,16.4-15.6c2.8-5.4,5-16.2,4.2-21.2c-0.2-2.4-1.4-7-2.4-10.6l-2-6.2l4.8-4.6c5.8-5.8,6.6-8.8,3.8-15.4l-2-4.8l2.4-2.6c5.2-5.4,5.4-9.4,1.4-21.2c-1.6-4.8-2.6-8.8-2.4-9c0.2-0.2,2.8-0.8,5.6-1.2c14.2-2.4,26.4-12.8,26.4-22.6c0-4-3.6-11.2-11.2-22.6c-3.2-4.8-11.2-16.6-17.6-26.2c-6.4-9.4-12-18.2-12.2-19.6c-0.4-1.6,0.2-3.6,2.2-6.8c3.8-6,4.8-9.6,4.8-19.6c0-18-4.8-42.2-11.6-59c-19-47.2-61.4-80.2-122-95C271.2,21.6,233.8,18.6,204.6,20.6z"
+      fill="{{color}}" transform="matrix(1, 0, 0, 1.053, 0, -0.529683)" />
+  </g>
+</svg>

data/lib/assets/foregrounds/head3.svg ADDED Viewed

@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <g transform="{{transformation}}">
+    <path
+      d="M258.374,20c-27.9,0-54.2,6.2-77.8,17.4c-62.2,28.9-105.4,91.9-105.4,165l0,0v24.3v5.9l-37.2,70.9
+		  c-9.4,17.9-0.5,32.5,19.7,32.5h17.5v0.4v30.8v36.1c0,21.1,17.2,38.3,38.3,38.3l52.6-7.8l0.1,52.6v0.4l0,0c0.3,6.7,6,11.3,12.9,10
+		  l189.4-33.6c7.2-1.3,12.9-8.2,12.9-15.5v-8.3v-6.6v-96.4c36.2-33.4,59.1-81.2,59.1-134.4C440.574,99.7,359.174,20,258.374,20z"
+      fill="{{color}}" />
+  </g>
+</svg>

data/lib/assets/text/base.svg ADDED Viewed

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <text x="256" y="256" font-family="Arial" font-size="220" font-weight="bold" text-anchor="middle"
+    dominant-baseline="middle" fill="{{color}}">{{character}}</text>
+</svg>

data/lib/assets/text/hack.svg ADDED Viewed

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <text x="256" y="310" font-family="Arial" font-size="220" font-weight="bold" text-anchor="middle"
+    fill="{{color}}">{{character}}</text>
+</svg>

data/lib/default_avatar_generator/background_layer.rb ADDED Viewed

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+module DefaultAvatarGenerator
+  # Background SVG layer
+  class BackgroundLayer < Layer
+    private
+    def template_path
+      File.join(__dir__, '..', 'assets', 'backgrounds', "#{template_name}.svg")
+    end
+  end
+end

data/lib/default_avatar_generator/colors.rb ADDED Viewed

@@ -0,0 +1,346 @@
+# frozen_string_literal: true
+module DefaultAvatarGenerator
+  # List of colors
+  class Colors
+    class << self
+      def all
+        COLORS
+      end
+      def get(color_name, shade = 500)
+        COLORS.dig(color_name.to_sym, shade)
+      end
+      def available_colors
+        COLORS.keys
+      end
+      def select_solid_color
+        get(available_colors.sample, solid_shades.sample)
+      end
+      def select_contrast_color
+        get(available_colors.sample, contrast_shades.sample)
+      end
+      def available_shades
+        [50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 950]
+      end
+      def solid_shades
+        [300, 400, 500, 600, 700, 800, 900]
+      end
+      def contrast_shades
+        [50, 100, 950]
+      end
+      def opposite_shade(shade)
+        shade_map = {
+          50 => 950,
+          100 => 900,
+          200 => 800,
+          300 => 700,
+          400 => 600,
+          500 => 500,
+          600 => 400,
+          700 => 300,
+          800 => 200,
+          900 => 100,
+          950 => 50
+        }
+        shade_map[shade]
+      end
+    end
+    COLORS = {
+      slate: {
+        50 => '#f8fafc',
+        100 => '#f1f5f9',
+        200 => '#e2e8f0',
+        300 => '#cbd5e1',
+        400 => '#94a3b8',
+        500 => '#64748b',
+        600 => '#475569',
+        700 => '#334155',
+        800 => '#1e293b',
+        900 => '#0f172a',
+        950 => '#020617'
+      },
+      gray: {
+        50 => '#f9fafb',
+        100 => '#f3f4f6',
+        200 => '#e5e7eb',
+        300 => '#d1d5db',
+        400 => '#9ca3af',
+        500 => '#6b7280',
+        600 => '#4b5563',
+        700 => '#374151',
+        800 => '#1f2937',
+        900 => '#111827',
+        950 => '#030712'
+      },
+      zinc: {
+        50 => '#fafafa',
+        100 => '#f4f4f5',
+        200 => '#e4e4e7',
+        300 => '#d4d4d8',
+        400 => '#a1a1aa',
+        500 => '#71717a',
+        600 => '#52525b',
+        700 => '#3f3f46',
+        800 => '#27272a',
+        900 => '#18181b',
+        950 => '#09090b'
+      },
+      neutral: {
+        50 => '#fafafa',
+        100 => '#f5f5f5',
+        200 => '#e5e5e5',
+        300 => '#d4d4d4',
+        400 => '#a3a3a3',
+        500 => '#737373',
+        600 => '#525252',
+        700 => '#404040',
+        800 => '#262626',
+        900 => '#171717',
+        950 => '#0a0a0a'
+      },
+      stone: {
+        50 => '#fafaf9',
+        100 => '#f5f5f4',
+        200 => '#e7e5e4',
+        300 => '#d6d3d1',
+        400 => '#a8a29e',
+        500 => '#78716c',
+        600 => '#57534e',
+        700 => '#44403c',
+        800 => '#292524',
+        900 => '#1c1917',
+        950 => '#0c0a09'
+      },
+      red: {
+        50 => '#fef2f2',
+        100 => '#fee2e2',
+        200 => '#fecaca',
+        300 => '#fca5a5',
+        400 => '#f87171',
+        500 => '#ef4444',
+        600 => '#dc2626',
+        700 => '#b91c1c',
+        800 => '#991b1b',
+        900 => '#7f1d1d',
+        950 => '#450a0a'
+      },
+      orange: {
+        50 => '#fff7ed',
+        100 => '#ffedd5',
+        200 => '#fed7aa',
+        300 => '#fdba74',
+        400 => '#fb923c',
+        500 => '#f97316',
+        600 => '#ea580c',
+        700 => '#c2410c',
+        800 => '#9a3412',
+        900 => '#7c2d12',
+        950 => '#431407'
+      },
+      amber: {
+        50 => '#fffbeb',
+        100 => '#fef3c7',
+        200 => '#fde68a',
+        300 => '#fcd34d',
+        400 => '#fbbf24',
+        500 => '#f59e0b',
+        600 => '#d97706',
+        700 => '#b45309',
+        800 => '#92400e',
+        900 => '#78350f',
+        950 => '#451a03'
+      },
+      yellow: {
+        50 => '#fefce8',
+        100 => '#fef9c3',
+        200 => '#fef08a',
+        300 => '#fde047',
+        400 => '#facc15',
+        500 => '#eab308',
+        600 => '#ca8a04',
+        700 => '#a16207',
+        800 => '#854d0e',
+        900 => '#713f12',
+        950 => '#422006'
+      },
+      lime: {
+        50 => '#f7fee7',
+        100 => '#ecfccb',
+        200 => '#d9f99d',
+        300 => '#bef264',
+        400 => '#a3e635',
+        500 => '#84cc16',
+        600 => '#65a30d',
+        700 => '#4d7c0f',
+        800 => '#3f6212',
+        900 => '#365314',
+        950 => '#1a2e05'
+      },
+      green: {
+        50 => '#f0fdf4',
+        100 => '#dcfce7',
+        200 => '#bbf7d0',
+        300 => '#86efac',
+        400 => '#4ade80',
+        500 => '#22c55e',
+        600 => '#16a34a',
+        700 => '#15803d',
+        800 => '#166534',
+        900 => '#14532d',
+        950 => '#052e16'
+      },
+      emerald: {
+        50 => '#ecfdf5',
+        100 => '#d1fae5',
+        200 => '#a7f3d0',
+        300 => '#6ee7b7',
+        400 => '#34d399',
+        500 => '#10b981',
+        600 => '#059669',
+        700 => '#047857',
+        800 => '#065f46',
+        900 => '#064e3b',
+        950 => '#022c22'
+      },
+      teal: {
+        50 => '#f0fdfa',
+        100 => '#ccfbf1',
+        200 => '#99f6e4',
+        300 => '#5eead4',
+        400 => '#2dd4bf',
+        500 => '#14b8a6',
+        600 => '#0d9488',
+        700 => '#0f766e',
+        800 => '#115e59',
+        900 => '#134e4a',
+        950 => '#042f2e'
+      },
+      cyan: {
+        50 => '#ecfeff',
+        100 => '#cffafe',
+        200 => '#a5f3fc',
+        300 => '#67e8f9',
+        400 => '#22d3ee',
+        500 => '#06b6d4',
+        600 => '#0891b2',
+        700 => '#0e7490',
+        800 => '#155e75',
+        900 => '#164e63',
+        950 => '#083344'
+      },
+      sky: {
+        50 => '#f0f9ff',
+        100 => '#e0f2fe',
+        200 => '#bae6fd',
+        300 => '#7dd3fc',
+        400 => '#38bdf8',
+        500 => '#0ea5e9',
+        600 => '#0284c7',
+        700 => '#0369a1',
+        800 => '#075985',
+        900 => '#0c4a6e',
+        950 => '#082f49'
+      },
+      blue: {
+        50 => '#eff6ff',
+        100 => '#dbeafe',
+        200 => '#bfdbfe',
+        300 => '#93c5fd',
+        400 => '#60a5fa',
+        500 => '#3b82f6',
+        600 => '#2563eb',
+        700 => '#1d4ed8',
+        800 => '#1e40af',
+        900 => '#1e3a8a',
+        950 => '#172554'
+      },
+      indigo: {
+        50 => '#eef2ff',
+        100 => '#e0e7ff',
+        200 => '#c7d2fe',
+        300 => '#a5b4fc',
+        400 => '#818cf8',
+        500 => '#6366f1',
+        600 => '#4f46e5',
+        700 => '#4338ca',
+        800 => '#3730a3',
+        900 => '#312e81',
+        950 => '#1e1b4b'
+      },
+      violet: {
+        50 => '#f5f3ff',
+        100 => '#ede9fe',
+        200 => '#ddd6fe',
+        300 => '#c4b5fd',
+        400 => '#a78bfa',
+        500 => '#8b5cf6',
+        600 => '#7c3aed',
+        700 => '#6d28d9',
+        800 => '#5b21b6',
+        900 => '#4c1d95',
+        950 => '#2e1065'
+      },
+      purple: {
+        50 => '#faf5ff',
+        100 => '#f3e8ff',
+        200 => '#e9d5ff',
+        300 => '#d8b4fe',
+        400 => '#c084fc',
+        500 => '#a855f7',
+        600 => '#9333ea',
+        700 => '#7e22ce',
+        800 => '#6b21a8',
+        900 => '#581c87',
+        950 => '#3b0764'
+      },
+      fuchsia: {
+        50 => '#fdf4ff',
+        100 => '#fae8ff',
+        200 => '#f5d0fe',
+        300 => '#f0abfc',
+        400 => '#e879f9',
+        500 => '#d946ef',
+        600 => '#c026d3',
+        700 => '#a21caf',
+        800 => '#86198f',
+        900 => '#701a75',
+        950 => '#4a044e'
+      },
+      pink: {
+        50 => '#fdf2f8',
+        100 => '#fce7f3',
+        200 => '#fbcfe8',
+        300 => '#f9a8d4',
+        400 => '#f472b6',
+        500 => '#ec4899',
+        600 => '#db2777',
+        700 => '#be185d',
+        800 => '#9d174d',
+        900 => '#831843',
+        950 => '#500724'
+      },
+      rose: {
+        50 => '#fff1f2',
+        100 => '#ffe4e6',
+        200 => '#fecdd3',
+        300 => '#fda4af',
+        400 => '#fb7185',
+        500 => '#f43f5e',
+        600 => '#e11d48',
+        700 => '#be123c',
+        800 => '#9f1239',
+        900 => '#881337',
+        950 => '#4c0519'
+      }
+    }.freeze
+  end
+end

data/lib/default_avatar_generator/composer.rb ADDED Viewed

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+module DefaultAvatarGenerator
+  # Composes all of the layers together into a single SVG
+  class Composer
+    def initialize(layers)
+      @layers = layers
+    end
+    def compose
+      SvgUtils.minify(<<~SVG)
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+          #{@layers.map(&:render).join("\n          ")}
+        </svg>
+      SVG
+    end
+  end
+end

data/lib/default_avatar_generator/foreground_layer.rb ADDED Viewed

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+module DefaultAvatarGenerator
+  # Foreground SVG layer
+  class ForegroundLayer < Layer
+    def self.select_transform
+      ['', 'scale(-1, 1) translate(-512, 0)'].sample
+    end
+    private
+    def template_path
+      File.join(__dir__, '..', 'assets', 'foregrounds', "#{template_name}.svg")
+    end
+  end
+end

data/lib/default_avatar_generator/generator.rb ADDED Viewed

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+module DefaultAvatarGenerator
+  # The Generator class is responsible for creating avatar images with customizable
+  # backgrounds, foregrounds, and text layers.
+  class Generator
+    AVAILABLE_BACKGROUNDS = %w[
+      gradient-2h
+      gradient-3h
+      gradient-backslash
+      gradient-slash
+      gradient-lr
+      gradient-tb
+      solid
+    ].freeze
+    AVAILABLE_FOREGROUNDS = %w[
+      head1-solid
+      head2
+      head3
+    ].freeze
+    # NOTE: 'base' doesn't work because libvips doesn't support `dominant-baseline` in SVG.
+    # Can move back once https://gitlab.gnome.org/GNOME/librsvg/-/merge_requests/1072
+    # makes it way into the latest version.
+    AVAILABLE_TEXT = %w[
+      hack
+    ].freeze
+    def initialize(options = {})
+      @options = options
+    end
+    def generate # rubocop:disable Metrics/AbcSize
+      # Create layers with dynamic parameters
+      layers = [
+        BackgroundLayer.new(
+          select_background,
+          background_params.merge(@options[:background] || {})
+        ),
+        ForegroundLayer.new(
+          select_foreground,
+          foreground_params.merge(@options[:foreground] || {})
+        ),
+        TextLayer.new(
+          select_text,
+          text_params.merge(@options[:text] || {})
+        )
+      ]
+      Composer.new(layers).compose
+    end
+    def select_background
+      AVAILABLE_BACKGROUNDS.sample
+    end
+    def background_params
+      {
+        color1: Colors.select_solid_color,
+        color2: Colors.select_solid_color,
+        color3: Colors.select_solid_color,
+        color4: Colors.select_solid_color,
+        color5: Colors.select_solid_color,
+        color6: Colors.select_solid_color
+      }
+    end
+    def select_foreground
+      AVAILABLE_FOREGROUNDS.sample
+    end
+    def foreground_params
+      @foreground_color_name = Colors.available_colors.sample
+      @foreground_shade = Colors.contrast_shades.sample
+      {
+        color: Colors.get(@foreground_color_name, @foreground_shade),
+        transformation: ForegroundLayer.select_transform
+      }
+    end
+    def select_text
+      AVAILABLE_TEXT.sample
+    end
+    def text_params
+      {
+        color: Colors.get(@foreground_color_name, Colors.opposite_shade(@foreground_shade))
+        # character: ('A'..'Z').to_a.sample
+      }
+    end
+  end
+end

data/lib/default_avatar_generator/image_converter.rb ADDED Viewed

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+require 'tempfile'
+module DefaultAvatarGenerator
+  # Converts SVG to other image formats
+  class ImageConverter
+    def self.svg_to_jpeg(svg_content)
+      # Create a temporary file to store the SVG
+      temp_svg = Tempfile.new(['avatar', '.svg'])
+      begin
+        temp_svg.write(svg_content)
+        temp_svg.close
+        # Load the SVG using vips and convert to JPEG
+        image = Vips::Image.new_from_file(temp_svg.path)
+        # Convert to sRGB color space and save as JPEG to memory
+        image = image.colourspace('srgb')
+        image.jpegsave_buffer(Q: 90)
+      ensure
+        # Clean up temporary file
+        temp_svg.unlink
+      end
+    end
+  end
+end

data/lib/default_avatar_generator/layer.rb ADDED Viewed

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+require 'nokogiri'
+module DefaultAvatarGenerator
+  # The Layer class is responsible for rendering SVG templates with given parameters.
+  class Layer
+    attr_reader :template_name, :params
+    def initialize(template_name, params = {})
+      @template_name = template_name
+      @params = params
+    end
+    def render
+      template = load_template
+      process_template(template)
+    end
+    private
+    def load_template
+      # Load the SVG template file
+      File.read(template_path)
+    end
+    def template_path
+      # Implement in subclasses to define where templates are stored
+      raise NotImplementedError, "#{self.class} must implement #template_path"
+    end
+    def process_template(template)
+      # Replace only the parameters that exist in params
+      parsed = template.gsub(/\{\{(\w+)\}\}/) do |match|
+        param_name = ::Regexp.last_match(1)
+        params.key?(param_name.to_sym) ? params[param_name.to_sym].to_s : match
+      end
+      # Parse the XML and extract just the first child element inside the svg tag
+      doc = Nokogiri::XML(parsed)
+      doc.at('svg > *').to_s
+    end
+  end
+end

data/lib/default_avatar_generator/svg_utils.rb ADDED Viewed

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+module DefaultAvatarGenerator
+  # Utility methods for SVG manipulation
+  module SvgUtils
+    module_function
+    def minify(svg)
+      svg.gsub(/>\s+</, '><').gsub(/\s+/, ' ').strip
+    end
+  end
+end

data/lib/default_avatar_generator/text_layer.rb ADDED Viewed

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+module DefaultAvatarGenerator
+  # Text SVG layer
+  class TextLayer < Layer
+    private
+    def template_path
+      File.join(__dir__, '..', 'assets', 'text', "#{template_name}.svg")
+    end
+  end
+end

data/lib/default_avatar_generator/version.rb ADDED Viewed

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+module DefaultAvatarGenerator
+  VERSION = '0.1.0'
+end

data/lib/default_avatar_generator.rb ADDED Viewed

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+require 'vips'
+require_relative 'default_avatar_generator/version'
+require_relative 'default_avatar_generator/colors'
+require_relative 'default_avatar_generator/layer'
+require_relative 'default_avatar_generator/background_layer'
+require_relative 'default_avatar_generator/foreground_layer'
+require_relative 'default_avatar_generator/text_layer'
+require_relative 'default_avatar_generator/svg_utils'
+require_relative 'default_avatar_generator/composer'
+require_relative 'default_avatar_generator/generator'
+require_relative 'default_avatar_generator/image_converter'
+module DefaultAvatarGenerator
+  class Error < StandardError; end
+end

metadata ADDED Viewed

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification
+name: default-avatar-generator
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Peter Sankauskas
+bindir: bin
+cert_chain: []
+date: 2025-04-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.18'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.18'
+- !ruby/object:Gem::Dependency
+  name: ruby-vips
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+description: Generates beautiful and unique default avatars for user accounts
+email:
+- peter+avatar@pas.ventures
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- README.md
+- lib/assets/backgrounds/gradient-2h.svg
+- lib/assets/backgrounds/gradient-3h.svg
+- lib/assets/backgrounds/gradient-backslash.svg
+- lib/assets/backgrounds/gradient-lr.svg
+- lib/assets/backgrounds/gradient-slash.svg
+- lib/assets/backgrounds/gradient-tb.svg
+- lib/assets/backgrounds/solid.svg
+- lib/assets/foregrounds/head1-hollow.svg
+- lib/assets/foregrounds/head1-solid.svg
+- lib/assets/foregrounds/head2.svg
+- lib/assets/foregrounds/head3.svg
+- lib/assets/text/base.svg
+- lib/assets/text/hack.svg
+- lib/default_avatar_generator.rb
+- lib/default_avatar_generator/background_layer.rb
+- lib/default_avatar_generator/colors.rb
+- lib/default_avatar_generator/composer.rb
+- lib/default_avatar_generator/foreground_layer.rb
+- lib/default_avatar_generator/generator.rb
+- lib/default_avatar_generator/image_converter.rb
+- lib/default_avatar_generator/layer.rb
+- lib/default_avatar_generator/svg_utils.rb
+- lib/default_avatar_generator/text_layer.rb
+- lib/default_avatar_generator/version.rb
+homepage: https://github.com/pas256/default-avatar-generator
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/pas256/default-avatar-generator
+  source_code_uri: https://github.com/pas256/default-avatar-generator
+  changelog_uri: https://github.com/pas256/default-avatar-generator/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: Generate unique, default avatars for user accounts
+test_files: []