starlight_helpers 0.999

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8688281a73acbca107c30b410a34421c72b17082
+  data.tar.gz: 5cf7cda036a7709c06a1fa624ddd234388d0ff0c
+SHA512:
+  metadata.gz: 12ec82b224b7b0eda96486bc59a5aef3b4d6630b464a2652402900eeacdb148f8635fd360a29e3e52f6bcb3bdcfd076bae1897da673e3816381276e3bb1e4072
+  data.tar.gz: f6dbf1dafbd2865e693869beff5984253e7eaba74aa090a63f7bd934a4f186afabc4c6ee64257dabbcd11b7aa9df1b5f3031e0124b8dd98ef72a979cf26b89a3

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in starlight_helpers.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Ivan Stana
+
+MIT License
+
+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,39 @@
+# StarlightHelpers
+
+## Why
+
+I needed common used methods when I'm programming websites in one place, not in /lib directories across more projects and with different updates. And this time I've added unit tests. Finally the feeling, that my code is falling apart, is gone.
+
+And I'm sharing it with YOU! Enjoy.
+
+## Usage
+
+Read the source or tests. They are simple. Of course I add documentation later.
+
+## Roadmap
+
+- better rendering of the content (allow options for markdown), add textile, escape entities in plaintext
+- add stylistic filters to the content renderer - change of quotes, remove double spaces and such eye candy things
+
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'starlight_helpers'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install starlight_helpers
+
+## Contributing
+
+1. Fork it ( http://github.com/istana/starlight_helpers/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.test_files = FileList['test/*_test.rb']
+  t.verbose = true
+end

data/lib/starlight_helpers/all.rb

@@ -0,0 +1,6 @@
+module StarlightHelpers
+	require_relative './content'
+	require_relative './flash'
+	require_relative './locale'
+	require_relative './model'
+end 

data/lib/starlight_helpers/content.rb

@@ -0,0 +1,28 @@
+require 'redcarpet'
+require 'action_view'
+
+module StarlightHelpers
+	module Content
+
+		def link_to_selected(selected = false, name = nil, options = nil, html_options = {}, &block)
+			if selected
+				html_options.merge!(class: 'selected')
+			end
+			link_to(name, options, html_options, &block)
+		end
+
+		def convert_content(content, markup)
+			if markup == 'plain'
+				content.gsub("\n", '<br>')
+			elsif markup == 'markdown'
+				markdown = ::Redcarpet::Markdown.new(::Redcarpet::Render::HTML)
+				markdown.render(content)
+			elsif markup == 'html'
+				# nothing
+				content
+			end
+		end
+
+	end
+end
+

data/lib/starlight_helpers/flash.rb

@@ -0,0 +1,48 @@
+require 'rack'
+require 'action_dispatch/middleware/flash'
+
+module StarlightHelpers
+	module Flash
+	
+		def flash_alert(message)
+			flash_something(:alert, message)
+		end
+		
+		def flash_notice(message)
+			flash_something(:notice, message)
+		end
+
+		def flash_something(what, message)
+			type = what.to_sym
+			if flash[type].is_a?(String)
+				flash[type] = [flash[type], message]
+			else
+				flash[type] ||= []
+				flash[type] << message
+			end
+		end
+		
+		def display_flash(what, &code)
+		  type = what.to_sym
+		  # something like Devise has overwritten flash
+		  if flash[type].is_a?(String)
+		    flash[type] = [flash[type]]
+		  end
+
+      if flash[type]
+		    result = flash[type].inject([]) do |res, msg|
+		      res << (block_given? ? code.call(msg) : msg)
+		    end
+		  end
+
+		  # sometimes flash isn't cleared after action
+			# "Please create or set 'default_locale'" is shown
+			# multiple times
+		  # better clear flash, it was already shown anyway
+		  flash.delete(type)
+		  result ? result.join(" "): nil
+    end
+
+	end
+end
+

data/lib/starlight_helpers/locale.rb

@@ -0,0 +1,58 @@
+module StarlightHelpers
+	module Locale
+	  # en_US
+	  # the first segment is language, the second the country
+	  # isocode has only "-", allow "_" too like in gettext 
+		def format_inline
+		  /([a-zA-Z]{2})(?:([-_])([a-zA-Z]{2}))?/
+		end
+		
+		def format
+		  Regexp.new("\\A#{format_inline}\\z")
+		end
+
+    # function parses user agent string from web browser (Accept-Language)
+    # and returns sorted array of {quality => code} segments
+		def parse_accept_language(ualangs)
+			# quality? format
+			qf = "q=(1|0\.[1-9])"
+			lang_format = "#{format_inline}(; ?#{qf})?"
+			langs_format = /\A(#{lang_format}(,#{lang_format}){0,7})\z/
+
+			if ualangs =~ langs_format
+				langs = ualangs.split(',').map(&:strip)
+				langs = langs.inject({}) do |result, language|
+					segment = language.split(';').map(&:strip)
+					# add q=1 for language if not defined
+					if segment.size == 1
+						segment << 1
+				  elsif segment.size == 2
+				    segment[1] = segment[1].gsub('q=', '').to_f
+					end
+					result.merge!(segment[0] => segment[1])
+				end
+				Hash[langs.sort_by { |code, quality| -quality }]
+			else
+				{}
+			end
+		end
+
+		def valid_locale?(loc)
+			loc =~ format ? true : false
+		end
+
+		def language(loc)
+		  loc.match(format)[1]
+		end
+		
+		def country(loc)
+		  loc.match(format)[3]
+		end
+
+		def country?(loc)
+		  loc.match(format)[3] != nil
+		end
+		alias_method :full_locale?, :country?
+	end
+end
+

data/lib/starlight_helpers/model.rb

@@ -0,0 +1,12 @@
+require 'active_support/inflector'
+
+module StarlightHelpers
+	module Model
+	  # converts text to nice uri
+		def make_uri(string)
+			uri = ActiveSupport::Inflector.transliterate(string)
+			uri.parameterize
+		end
+	end
+end
+

data/lib/starlight_helpers/version.rb

@@ -0,0 +1,3 @@
+module StarlightHelpers
+  VERSION = "0.999"
+end

data/lib/starlight_helpers.rb

@@ -0,0 +1,4 @@
+require "starlight_helpers/version"
+
+module StarlightHelpers
+end

data/starlight_helpers.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'starlight_helpers/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "starlight_helpers"
+  spec.version       = StarlightHelpers::VERSION
+  spec.authors       = ["Ivan Stana"]
+  spec.email         = ["stiipa@centrum.sk"]
+  spec.summary       = %q{Helper modules for building websites. Flash, content, locale and model.}
+  spec.description   = %q{Helper modules for building websites. Relax and use often used methods in flash, content, locale and model areas. Used and tests available.}
+  spec.homepage      = "http://github.com/istana/starlight_helpers"
+  spec.license       = "MIT"
+  spec.post_install_message = "'Enjoy starlight helpers!' With love your Star..."
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "actionpack"
+  spec.add_dependency "redcarpet"
+  spec.add_dependency "rack"
+  spec.add_dependency "action_view"
+
+  spec.add_development_dependency "bundler", "~> 1.5"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "minitest"
+end

data/test/content_test.rb

@@ -0,0 +1,26 @@
+require_relative './test_helper'
+require 'action_view'
+
+class LesterHelper
+  extend ActionView::Helpers::TagHelper
+  extend ActionView::Helpers::UrlHelper
+  extend StarlightHelpers::Content
+end
+
+describe StarlightHelpers::Content do
+  it '#link_to_selected' do
+    assert_equal '<a class="selected" href="#">Ahoy</a>',    
+      LesterHelper.link_to_selected(true, 'Ahoy', '#')
+    assert_equal '<a href="#">Ahoy</a>',    
+      LesterHelper.link_to_selected(false, 'Ahoy', '#')
+  end
+  
+  it '#render_text' do
+    assert_equal 'Hello<br>world',
+      LesterHelper.convert_content("Hello\nworld", 'plain')
+    assert_equal "<p><em>Hello</em></p>\n",
+      LesterHelper.convert_content("*Hello*", 'markdown')
+    assert_equal '<font color="navy">Hello</font>',
+      LesterHelper.convert_content('<font color="navy">Hello</font>', 'html')
+  end
+end 

data/test/flash_test.rb

@@ -0,0 +1,72 @@
+require 'erb'
+require_relative './test_helper'
+
+class Lester
+  attr_accessor :flash
+  include StarlightHelpers::Flash
+
+  def initialize
+   @flash = ActionDispatch::Flash::FlashHash.new({})
+  end
+end
+
+describe StarlightHelpers::Flash do
+  before(:each) do
+    @lester = Lester.new
+  end
+
+  it "#flash_alert" do
+    @lester.flash_alert(":-O")
+    assert_equal [":-O"], @lester.flash[:alert]
+    assert_nil @lester.flash[:another]
+  end
+  
+  it "#flash_notice" do
+    @lester.flash_notice(";-)")
+    assert_equal [";-)"], @lester.flash[:notice]
+    assert_nil @lester.flash[:another]
+  end
+  
+  it "#flash_something" do
+    @lester.flash_something(:world, "I'm the best")
+    @lester.flash_something(:world, "Am I good or am I good?")
+    assert_equal ["I'm the best", "Am I good or am I good?"], @lester.flash[:world]
+    assert_nil @lester.flash[:another]
+  end
+  
+  it "#flash_something handles preexisting string" do
+    @lester.flash[:kayla] = "<3"
+    @lester.flash_something(:kayla, "^_^")
+    assert_equal ["<3", "^_^"], @lester.flash[:kayla]
+  end
+  
+  it "#display_flash without block" do
+    @lester.flash_notice(";-)")
+    @lester.flash_notice("8-)")
+    
+    result = ERB.new(<<-EOF
+<%= display_flash(:notice) %>
+    EOF
+    # this is weird, and public method or .send doesn't work
+    ).result(@lester.instance_eval { binding })
+    assert_equal ";-) 8-)\n", result
+    assert_nil @lester.flash[:notice]
+  end
+  
+  it "#display_flash with the block" do
+    @lester.flash_notice("hello")
+    @lester.flash_notice("world")
+    
+    # ERB is bit weird, cannot do "_#{msg}_", becase
+    # NameError: undefined local variable or method `msg'
+    # must be concatenated
+    template = <<-EOF
+<% display_flash(:notice) do |msg| %>
+<%= "_"+msg+"_" %>
+<% end %>
+    EOF
+    result_with_block = ERB.new(template, nil, '<>').result(@lester.instance_eval { binding })
+    assert_equal "_hello__world_", result_with_block
+    assert_nil @lester.flash[:notice]
+  end
+end

data/test/locale_test.rb

@@ -0,0 +1,46 @@
+require_relative './test_helper'
+
+class Lester
+  extend StarlightHelpers::Locale
+end
+
+describe StarlightHelpers::Locale do
+  it '#valid_locale?' do
+    assert Lester.valid_locale?('sk')
+    assert Lester.valid_locale?('sk_SK')
+    assert Lester.valid_locale?('sk-SK')
+    
+    assert !Lester.valid_locale?('sks')
+    assert !Lester.valid_locale?('sks_SK')
+    assert !Lester.valid_locale?('sk_SKs')
+    assert !Lester.valid_locale?('sks_SKs')
+    assert !Lester.valid_locale?('0a_SK')
+    assert !Lester.valid_locale?('0')
+    assert !Lester.valid_locale?('0_SK')    
+  end
+
+  it '#country?, #full_locale?' do
+    assert Lester.country?('sk_SK')
+    assert !Lester.country?('sk')
+    assert Lester.full_locale?('sk_SK')
+    assert !Lester.full_locale?('sk')
+  end
+
+  it '#country' do
+    assert_equal 'US', Lester.country('en_US')
+    assert_nil Lester.country('sk')
+  end
+  
+  it '#language' do
+    assert_equal 'en', Lester.language('en_US')
+    assert_equal 'sk', Lester.language('sk')
+  end
+  
+  it '#parse_accept_language' do
+    assert_equal({'sk' => 1, 'cs' => 0.8, 'en-US' => 0.5, 'en' => 0.3}, Lester.parse_accept_language("sk,cs;q=0.8,en-US;q=0.5,en;q=0.3"))
+    assert_equal({'sk' => 1, 'cs' => 0.8, 'en-US' => 0.5, 'en' => 0.3}, Lester.parse_accept_language("cs;q=0.8,en-US;q=0.5,sk,en;q=0.3"))
+    assert_equal({}, Lester.parse_accept_language("sk;q=9000"))
+    assert_equal({}, Lester.parse_accept_language("sk;q=0"))
+    assert_equal({}, Lester.parse_accept_language("I can has?"))
+  end
+end

data/test/model_test.rb

@@ -0,0 +1,13 @@
+require_relative './test_helper'
+
+class Lester
+  extend StarlightHelpers::Model
+end
+
+describe StarlightHelpers::Model do
+  it '#make_uri' do
+    assert "cucoriedky-nase-rastu-v-lese",
+      Lester.make_uri("Čučoriedky naše rastú v lese! \n")
+  end
+end
+ 

data/test/test_helper.rb

@@ -0,0 +1,5 @@
+#require 'bundler/setup'
+require_relative '../lib/starlight_helpers/all'
+require 'minitest/autorun'
+
+I18n.enforce_available_locales = false

metadata

@@ -0,0 +1,167 @@
+--- !ruby/object:Gem::Specification
+name: starlight_helpers
+version: !ruby/object:Gem::Version
+  version: '0.999'
+platform: ruby
+authors:
+- Ivan Stana
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-02-14 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'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  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'
+- !ruby/object:Gem::Dependency
+  name: rack
+  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'
+- !ruby/object:Gem::Dependency
+  name: action_view
+  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'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Helper modules for building websites. Relax and use often used methods
+  in flash, content, locale and model areas. Used and tests available.
+email:
+- stiipa@centrum.sk
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/starlight_helpers.rb
+- lib/starlight_helpers/all.rb
+- lib/starlight_helpers/content.rb
+- lib/starlight_helpers/flash.rb
+- lib/starlight_helpers/locale.rb
+- lib/starlight_helpers/model.rb
+- lib/starlight_helpers/version.rb
+- starlight_helpers.gemspec
+- test/content_test.rb
+- test/flash_test.rb
+- test/locale_test.rb
+- test/model_test.rb
+- test/test_helper.rb
+homepage: http://github.com/istana/starlight_helpers
+licenses:
+- MIT
+metadata: {}
+post_install_message: "'Enjoy starlight helpers!' With love your Star..."
+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: []
+rubyforge_project: 
+rubygems_version: 2.2.0
+signing_key: 
+specification_version: 4
+summary: Helper modules for building websites. Flash, content, locale and model.
+test_files:
+- test/content_test.rb
+- test/flash_test.rb
+- test/locale_test.rb
+- test/model_test.rb
+- test/test_helper.rb
+has_rdoc: