lavatar 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 489ab38d90bfb513ad3c28c82f2f3867e5b9d12ed9fa0c7303de04ed45655077
+  data.tar.gz: 2449685906a6078e44d86757d73075069cc4674fe7c3f63f1835d727f2ae9242
+SHA512:
+  metadata.gz: bb0f9fb0c500aa260b0fa5f0cdc172f7816819f405fa13df1352218da7cde46464bbe37cb3edcdce5100c236a1ca11933dd2f0a13c862088dd4da9ea252ecbb4
+  data.tar.gz: 28319310042107c3967eeb6e3e0fca898f02d099427b0844ec6f07878f4cbc8e33ef73ecb1c2e3ecd5bdb2c28421a97dd1713a0e4fb0b11f24c09bcbbc1141ce

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2019 Juraj Kostolansky
+
+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,60 @@
+# Lavatar
+
+Create letter avatars from user initials.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'lavatar'
+```
+
+And then execute:
+
+```bash
+$ bundle
+```
+
+Or install it yourself as:
+
+```bash
+$ gem install lavatar
+```
+
+## Configuration
+
+You can override default configuration, for example in `config/initializers/lavatar.rb`:
+
+```ruby
+Lavatar.configure do |config|
+  config.saturation  = 0.4 # from 0 to 1
+  config.lightness   = 0.5 # from 0 to 1
+  config.font_size   = 48  
+  config.font_weight = 700
+  config.font_color  = "#ffffff"  
+end
+```
+
+## Usage
+
+```ruby
+lavatar_tag("JK", 24, {  # (required) letters and size (width and height)
+  key:        123,       # user identifier to pick a color (ID, email, ...)  
+  color:      "#9e5555", # forced background color  
+  font_color: "#ffffff", # font color  
+  class:      "my-class" # SVG element classes
+)
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/jkostolansky/lavatar. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the Lavatar project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/jkostolansky/lavatar/blob/master/CODE_OF_CONDUCT.md).

data/lavatar.gemspec

@@ -0,0 +1,19 @@
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "lavatar/version"
+
+Gem::Specification.new do |spec|
+  spec.name         = "lavatar"
+  spec.version      = Lavatar::VERSION
+  spec.authors      = ["Juraj Kostolansky"]
+  spec.email        = ["juraj@kostolansky.sk"]
+
+  spec.summary      = "Generate letter avatars in Ruby on Rails"
+  spec.homepage     = "https://github.com/jkostolansky/lavatar"
+  spec.license      = "MIT"
+
+  spec.files        = Dir["README.md", "LICENSE.txt", "lavatar.gemspec", "lib/lavatar/*.rb"]
+  spec.require_path = "lib"
+
+  spec.add_dependency "actionpack"
+end

data/lib/lavatar/configuration.rb

@@ -0,0 +1,17 @@
+module Lavatar
+  class Configuration
+    attr_accessor :saturation
+    attr_accessor :lightness
+    attr_accessor :font_size
+    attr_accessor :font_weight
+    attr_accessor :font_color
+
+    def initialize
+      @saturation  = 0.4
+      @lightness   = 0.5
+      @font_size   = 48
+      @font_weight = 700
+      @font_color  = "#ffffff"
+    end
+  end
+end

data/lib/lavatar/helpers.rb

@@ -0,0 +1,73 @@
+module Lavatar
+  module Helpers
+    def lavatar_tag(letters, size, options = {})
+      key         = options[:key]         || letters
+      saturation  = options[:saturation]  || Lavatar.configuration.saturation
+      lightness   = options[:lightness]   || Lavatar.configuration.lightness
+      color       = options[:color]       || key_to_color(key, saturation, lightness)
+      font_color  = options[:font_color]  || Lavatar.configuration.font_color
+      font_size   = options[:font_size]   || Lavatar.configuration.font_size
+      font_weight = options[:font_weight] || Lavatar.configuration.font_weight
+      klass       = options[:class]
+
+      svg_attrs = {
+        width: size,
+        height: size,
+        class: klass,
+        viewBox: "0 0 100 100",
+      }
+
+      rect_attrs = {
+        x: "0",
+        y: "0",
+        width: "100",
+        height: "100",
+        fill: color,
+      }
+
+      text_attrs = {
+        x: "50%",
+        y: "50%",
+        fill: font_color,
+        "font-size": font_size,
+        "font-weight": font_weight,
+        "alignment-baseline": "central",
+        "text-anchor": "middle",
+      }
+
+      content_tag :svg, svg_attrs do
+        tag(:rect, rect_attrs) + content_tag(:text, letters, text_attrs)
+      end
+    end
+
+  private
+
+    def key_to_color(key, saturation, lightness)
+      hue = Digest::MD5.hexdigest(key)[0..5].to_i(16).to_f/0xFFFFFF
+      hsl_to_rgb(hue, saturation, lightness)
+    end
+
+    def hsl_to_rgb(h, s, l)
+      if s == 0 # achromatic
+        r, g, b = l, l, l
+      else
+        hue2rgb = lambda do |m1, m2, h|
+          h += 1 if h < 0
+          h -= 1 if h > 1
+          return m1 + (m2 - m1) * h * 6 if h * 6 < 1
+          return m2 if h * 2 < 1
+          return m1 + (m2 - m1) * (2.0/3 - h) * 6 if h * 3 < 2
+          return m1
+        end
+
+        m2 = l < 0.5 ? l * (s + 1) : l + s - l * s
+        m1 = l * 2 - m2
+        r = hue2rgb.call(m1, m2, h + 1.0/3)
+        g = hue2rgb.call(m1, m2, h)
+        b = hue2rgb.call(m1, m2, h - 1.0/3)
+      end
+
+      "#%02x%02x%02x" % [(r*255).to_i, (g*255).to_i, (b*255).to_i]
+    end
+  end
+end

data/lib/lavatar/version.rb

@@ -0,0 +1,3 @@
+module Lavatar
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification
+name: lavatar
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Juraj Kostolansky
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-02-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: actionpack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- juraj@kostolansky.sk
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- lavatar.gemspec
+- lib/lavatar/configuration.rb
+- lib/lavatar/helpers.rb
+- lib/lavatar/version.rb
+homepage: https://github.com/jkostolansky/lavatar
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.1
+signing_key: 
+specification_version: 4
+summary: Generate letter avatars in Ruby on Rails
+test_files: []