semantic_range 2.1.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: ec95fe31851133a57a3c90992bb3124739ce82c0
-  data.tar.gz: 3a137c6d5e47ab85b4845bb4162d8c5f9253a180
+SHA256:
+  metadata.gz: 67ae11bb60e5aa3341d7d83eae4e7f100262878f2ef6612391b4e18ce3ee5801
+  data.tar.gz: d25d1b605ddf68eed7979808d0ce1bebbaac5e7025e47ac9d81564dbabb21ca6
 SHA512:
-  metadata.gz: f50a2b6cdd8dafbc675b0e43b7f6dd74cbdb6f70b88d51350b9c2e1977ca9c6192533863a7c48170ef0f4db580afa9d1de3c7d2810b855d97d497ecc41c44f3a
-  data.tar.gz: '07929eadc26321cdb53da674de931e7449dba9a264e9b8ba007ed47a1cd1469755c4b39ecab0fce43edf61aaf6c28c15c3ab93f9d343904c1797518dcde37bca'
+  metadata.gz: 873719a7f9a4af750cd6deda9a59a7953566d87558f3c7b9825cb3001f188d6453dfca58ce429fb013ffe664ea1806ebefbd081c4c2eadfee734e87dc1d167cf
+  data.tar.gz: dff74a1adac2232a3425e6e6d9b7de0412dadd574a3dee8a114d008b9a003c9070db6a69444142980e16e7c7586f7d50f409769e616b18c298b47fb8ce25877d

data/README.md

@@ -2,6 +2,11 @@
 
 [node-semver](https://github.com/npm/node-semver) written in Ruby for comparison and inclusion of semantic versions and ranges.
 
+**NOTE: current `master` and releases `>= 3` use keyword arguments instead of positional arguments to pass options.
+If you used `SemanticRange.compare(a, b, true)` in SemanticRange 2, in SemanticRange 3 use `SemanticRange.compare(a, b, loose: true)`**
+
+
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -24,11 +29,20 @@ Or install it yourself as:
 SemanticRange.valid('1.2.3') # '1.2.3'
 SemanticRange.valid('a.b.c') # nil
 SemanticRange.clean('  =v1.2.3   ') # '1.2.3'
-SemanticRange.satisfies('1.2.3', '1.x || >=2.5.0 || 5.0.0 - 7.2.3') # true
-SemanticRange.gt('1.2.3', '9.8.7') # false
-SemanticRange.lt('1.2.3', '9.8.7') # true
+SemanticRange.filter(['0.9.0', '1.3.0', '1.5.0', '2.0.5'], '1.3.0 || <1.0.0 || >2.0.0') # ['0.9.0', '1.3.0', '2.0.5']
+SemanticRange.satisfies?('1.2.3', '1.x || >=2.5.0 || 5.0.0 - 7.2.3') # true
+SemanticRange.gt?('1.2.3', '9.8.7') # false
+SemanticRange.lt?('1.2.3', '9.8.7') # true
 ```
 
+### Options
+All functions support optional keyword arguments that modify default behavior. The options supported are:
+* `loose` Be more forgiving about not-quite-valid semver strings. Any resulting output will always be 100% strict compliant. `false` by default.
+
+Some functions support `platform` option:
+* `platform` Changes behavior for `'Rubygems'` and `'Packagist'`. `nil` by default. See https://github.com/librariesio/semantic_range/issues/59
+
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
@@ -37,7 +51,7 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/librariesio/semantic_range. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](contributor-covenant.org) code of conduct.
+Bug reports and pull requests are welcome on GitHub at https://github.com/librariesio/semantic_range. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](https://www.contributor-covenant.org/) code of conduct.
 
 
 ## License

data/lib/semantic_range.rb

@@ -50,15 +50,15 @@ module SemanticRange
   class InvalidComparator < StandardError; end
   class InvalidRange < StandardError; end
 
-  def self.ltr(version, range, loose = false, platform = nil)
-    outside(version, range, '<', loose, platform)
+  def self.ltr?(version, range, loose: false, platform: nil)
+    outside?(version, range, '<', loose: loose, platform: platform)
   end
 
-  def self.gtr(version, range, loose = false, platform = nil)
-    outside(version, range, '>', loose, platform)
+  def self.gtr?(version, range, loose: false, platform: nil)
+    outside?(version, range, '>', loose: loose, platform: platform)
   end
 
-  def self.cmp(a, op, b, loose = false)
+  def self.cmp(a, op, b, loose: false)
     case op
     when '==='
       a = a.version if !a.is_a?(String)
@@ -69,27 +69,27 @@ module SemanticRange
       b = b.version if !b.is_a?(String)
       a != b
     when '', '=', '=='
-      eq(a, b, loose)
+      eq?(a, b, loose: loose)
     when '!='
-      neq(a, b, loose)
+      neq?(a, b, loose: loose)
     when '>'
-      gt(a, b, loose)
+      gt?(a, b, loose: loose)
     when '>='
-      gte(a, b, loose)
+      gte?(a, b, loose: loose)
     when '<'
-      lt(a, b, loose)
+      lt?(a, b, loose: loose)
     when '<='
-      lte(a, b, loose)
+      lte?(a, b, loose: loose)
     else
       raise 'Invalid operator: ' + op
     end
   end
 
-  def self.outside(version, range, hilo, loose = false, platform = nil)
-    version = Version.new(version, loose)
-    range = Range.new(range, loose, platform)
+  def self.outside?(version, range, hilo, loose: false, platform: nil)
+    version = Version.new(version, loose: loose)
+    range = Range.new(range, loose: loose, platform: platform)
 
-    return false if satisfies(version, range, loose, platform)
+    return false if satisfies?(version, range, loose: loose, platform: platform)
 
     case hilo
     when '>'
@@ -114,15 +114,15 @@ module SemanticRange
 
         case hilo
         when '>'
-          if gt(comparator.semver, high.semver, loose)
+          if gt?(comparator.semver, high.semver, loose: loose)
             high = comparator
-          elsif lt(comparator.semver, low.semver, loose)
+          elsif lt?(comparator.semver, low.semver, loose: loose)
             low = comparator
           end
         when '<'
-          if lt(comparator.semver, high.semver, loose)
+          if lt?(comparator.semver, high.semver, loose: loose)
             high = comparator
-          elsif gt(comparator.semver, low.semver, loose)
+          elsif gt?(comparator.semver, low.semver, loose: loose)
             low = comparator
           end
         end
@@ -132,15 +132,15 @@ module SemanticRange
 
       case hilo
       when '>'
-        if (low.operator.empty? || low.operator == comp) && lte(version, low.semver, loose)
+        if (low.operator.empty? || low.operator == comp) && lte?(version, low.semver, loose: loose)
           return false;
-        elsif (low.operator == ecomp && lt(version, low.semver, loose))
+        elsif (low.operator == ecomp && lt?(version, low.semver, loose: loose))
           return false;
         end
       when '<'
-        if (low.operator.empty? || low.operator == comp) && gte(version, low.semver, loose)
+        if (low.operator.empty? || low.operator == comp) && gte?(version, low.semver, loose: loose)
           return false;
-        elsif low.operator == ecomp && gt(version, low.semver, loose)
+        elsif low.operator == ecomp && gt?(version, low.semver, loose: loose)
           return false;
         end
       end
@@ -148,22 +148,28 @@ module SemanticRange
     true
   end
 
-  def self.satisfies(version, range, loose = false, platform = nil)
-    return false if !valid_range(range, loose, platform)
-    Range.new(range, loose, platform).test(version)
+  def self.satisfies?(version, range, loose: false, platform: nil)
+    return false if !valid_range(range, loose: loose, platform: platform)
+    Range.new(range, loose: loose, platform: platform).test(version)
   end
 
-  def self.max_satisfying(versions, range, loose = false, platform = nil)
+  def self.filter(versions, range, loose: false, platform: nil)
+    return [] if !valid_range(range, loose: loose, platform: platform)
+
+    versions.filter { |v| SemanticRange.satisfies?(v, range, loose: loose, platform: platform) }
+  end
+
+  def self.max_satisfying(versions, range, loose: false, platform: nil)
     versions.select { |version|
-      satisfies(version, range, loose, platform)
+      satisfies?(version, range, loose: loose, platform: platform)
     }.sort { |a, b|
-      rcompare(a, b, loose)
+      rcompare(a, b, loose: loose)
     }[0] || nil
   end
 
-  def self.valid_range(range, loose = false, platform = nil)
+  def self.valid_range(range, loose: false, platform: nil)
     begin
-      r = Range.new(range, loose, platform).range
+      r = Range.new(range, loose: loose, platform: platform).range
       r = '*' if r.nil? || r.empty?
       r
     rescue
@@ -171,89 +177,84 @@ module SemanticRange
     end
   end
 
-  def self.compare(a, b, loose = false)
-    Version.new(a, loose).compare(b)
+  def self.compare(a, b, loose: false)
+    Version.new(a, loose: loose).compare(b)
   end
 
   def self.compare_loose(a, b)
-    compare(a, b, true)
+    compare(a, b, loose: true)
   end
 
-  def self.rcompare(a, b, loose = false)
-    compare(b, a, true)
+  def self.rcompare(a, b, loose: false)
+    compare(b, a, loose: true)
   end
 
-  def self.sort(list, loose = false)
+  def self.sort(list, loose: false)
     # TODO
   end
 
-  def self.rsort(list, loose = false)
+  def self.rsort(list, loose: false)
     # TODO
   end
 
-  def self.lt(a, b, loose = false)
-    compare(a, b, loose) < 0
+  def self.lt?(a, b, loose: false)
+    compare(a, b, loose: loose) < 0
   end
 
-  def self.gt(a, b, loose = false)
-    compare(a, b, loose) > 0
+  def self.gt?(a, b, loose: false)
+    compare(a, b, loose: loose) > 0
   end
 
-  def self.eq(a, b, loose = false)
-    compare(a, b, loose) == 0
+  def self.eq?(a, b, loose: false)
+    compare(a, b, loose: loose) == 0
   end
 
-  def self.neq(a, b, loose = false)
-    compare(a, b, loose) != 0
+  def self.neq?(a, b, loose: false)
+    compare(a, b, loose: loose) != 0
   end
 
-  def self.gte(a, b, loose = false)
-    compare(a, b, loose) >= 0
+  def self.gte?(a, b, loose: false)
+    compare(a, b, loose: loose) >= 0
   end
 
-  def self.lte(a, b, loose = false)
-    compare(a, b, loose) <= 0
+  def self.lte?(a, b, loose: false)
+    compare(a, b, loose: loose) <= 0
   end
 
-  def self.valid(version, loose = false)
-    v = parse(version, loose)
+  def self.valid(version, loose: false)
+    v = parse(version, loose: loose)
     return v ? v.version : nil
   end
 
-  def self.clean(version, loose = false)
-    s = parse(version.strip.gsub(/^[=v]+/, ''), loose)
+  def self.clean(version, loose: false)
+    s = parse(version.strip.gsub(/^[=v]+/, ''), loose: loose)
     return s ? s.version : nil
   end
 
-  def self.parse(version, loose = false)
+  def self.parse(version, loose: false)
     return version if version.is_a?(Version)
 
     return nil unless version.is_a?(String)
 
-    version.strip!
+    stripped_version = version.strip
 
-    return nil if version.length > MAX_LENGTH
+    return nil if stripped_version.length > MAX_LENGTH
 
     rxp = loose ? LOOSE : FULL
-    return nil if !rxp.match(version)
+    return nil if !rxp.match(stripped_version)
 
-    Version.new(version, loose)
+    Version.new(stripped_version, loose: loose)
   end
 
-  def self.increment!(version, release, loose, identifier)
-    if loose.is_a? String
-      identifier = loose
-      loose = false
-    end
-
-    Version.new(version, loose).increment!(release, identifier).version
+  def self.increment!(version, release, identifier, loose: false)
+    Version.new(version, loose: loose).increment!(release, identifier).version
   rescue InvalidIncrement, InvalidVersion
     nil
   end
 
   def self.diff(a, b)
-    a = Version.new(a, false) unless a.kind_of?(Version)
-    b = Version.new(b, false) unless b.kind_of?(Version)
+    a = Version.new(a, loose: false) unless a.kind_of?(Version)
+    b = Version.new(b, loose: false) unless b.kind_of?(Version)
     pre_diff = a.prerelease.to_s != b.prerelease.to_s
     pre = pre_diff ? 'pre' : ''
     return "#{pre}major" if a.major != b.major
@@ -262,9 +263,23 @@ module SemanticRange
     return "prerelease"  if pre_diff
   end
 
-  def self.to_comparators(range, loose = false, platform = nil)
-    Range.new(range, loose, platform).set.map do |comp|
+  def self.to_comparators(range, loose: false, platform: nil)
+    Range.new(range, loose: loose, platform: platform).set.map do |comp|
       comp.map(&:to_s)
     end
   end
+
+  class << self
+    # Support for older non-inquisitive method versions
+    alias_method :gt, :gt?
+    alias_method :gtr, :gtr?
+    alias_method :gte, :gte?
+    alias_method :lt, :lt?
+    alias_method :ltr, :ltr?
+    alias_method :lte, :lte?
+    alias_method :eq, :eq?
+    alias_method :neq, :neq?
+    alias_method :outside, :outside?
+    alias_method :satisfies, :satisfies?
+  end
 end

data/lib/semantic_range/comparator.rb

@@ -17,7 +17,7 @@ module SemanticRange
     def test(version)
       return true if @semver == ANY
       version = Version.new(version, @loose) if version.is_a?(String)
-      SemanticRange.cmp(version, @operator, @semver, @loose)
+      SemanticRange.cmp(version, @operator, @semver, loose: @loose)
     end
 
     def parse(comp)
@@ -27,26 +27,26 @@ module SemanticRange
       @operator = m[1]
       @operator = '' if @operator == '='
 
-      @semver = !m[2] ? ANY : Version.new(m[2], @loose)
+      @semver = !m[2] ? ANY : Version.new(m[2], loose: @loose)
     end
 
-    def intersects(comp, loose = false, platform = nil)
+    def intersects?(comp, loose: false, platform: nil)
       comp = Comparator.new(comp, loose)
 
       if @operator == ''
-        range_b = Range.new(comp.value, loose, platform)
-        SemanticRange.satisfies(@value, range_b, loose, platform)
+        range_b = Range.new(comp.value, loose: loose, platform: platform)
+        SemanticRange.satisfies?(@value, range_b, loose: loose, platform: platform)
       elsif comp.operator == ''
-        range_a = Range.new(@value, loose, platform)
-        SemanticRange.satisfies(comp.semver, range_a, loose, platform)
+        range_a = Range.new(@value, loose: loose, platform: platform)
+        SemanticRange.satisfies?(comp.semver, range_a, loose: loose, platform: platform)
       else
         same_direction_increasing      = (@operator == '>=' || @operator == '>') && (comp.operator == '>=' || comp.operator == '>')
         same_direction_decreasing      = (@operator == '<=' || @operator == '<') && (comp.operator == '<=' || comp.operator == '<')
         same_version                   = @semver.raw == comp.semver.raw
         different_directions_inclusive = (@operator == '>=' || @operator == '<=') && (comp.operator == '>=' || comp.operator == '<=')
-        opposite_directions_lte        = SemanticRange.cmp(@semver, '<', comp.semver, loose) &&
+        opposite_directions_lte        = SemanticRange.cmp(@semver, '<', comp.semver, loose: loose) &&
             ((@operator == '>=' || @operator == '>') && (comp.operator == '<=' || comp.operator == '<'))
-        opposite_directions_gte        = SemanticRange.cmp(@semver, '>', comp.semver, loose) &&
+        opposite_directions_gte        = SemanticRange.cmp(@semver, '>', comp.semver, loose: loose) &&
             ((@operator == '<=' || @operator == '<') && (comp.operator == '>=' || comp.operator == '>'))
 
         same_direction_increasing || same_direction_decreasing || (same_version && different_directions_inclusive) ||
@@ -54,14 +54,18 @@ module SemanticRange
       end
     end
 
-    def satisfies_range(range, loose = false, platform = nil)
-      range = Range.new(range, loose, platform)
+    def satisfies_range?(range, loose: false, platform: nil)
+      range = Range.new(range, loose: loose, platform: platform)
 
       range.set.any? do |comparators|
         comparators.all? do |comparator|
-          intersects(comparator, loose, platform)
+          intersects?(comparator, loose: loose, platform: platform)
         end
       end
     end
+
+    # Support for older non-inquisitive method versions
+    alias_method :intersects, :intersects?
+    alias_method :satisfies_range, :satisfies_range?
   end
 end

data/lib/semantic_range/range.rb

@@ -2,7 +2,7 @@ module SemanticRange
   class Range
     attr_reader :loose, :raw, :range, :set, :platform
 
-    def initialize(range, loose = false, platform = nil)
+    def initialize(range, loose: false, platform: nil)
       range = range.raw if range.is_a?(Range)
       @platform = platform
       @raw = range
@@ -31,7 +31,7 @@ module SemanticRange
 
     def test(version)
       return false if !version
-      version = Version.new(version, @loose) if version.is_a?(String)
+      version = Version.new(version, loose: @loose) if version.is_a?(String)
       @set.any?{|s| test_set(s, version) }
     end
 
@@ -64,6 +64,9 @@ module SemanticRange
       # caret trim
       range = range.gsub(CARETTRIM, '\1^')
 
+      # comma trim
+      range = range.gsub(',', ' ')
+
       # normalise spaces
       range = range.split(/\s+/).join(' ')
 
@@ -280,12 +283,12 @@ module SemanticRange
       "#{from} #{to}".strip
     end
 
-    def intersects(range, loose = false, platform = nil)
-      range = Range.new(range, loose, platform)
+    def intersects(range, loose: false, platform: nil)
+      range = Range.new(range, loose: loose, platform: platform)
 
       @set.any? do |comparators|
         comparators.all? do |comparator|
-          comparator.satisfies_range(range, loose, platform)
+          comparator.satisfies_range(range, loose: loose, platform: platform)
         end
       end
     end

data/lib/semantic_range/version.rb

@@ -1,10 +1,10 @@
 module SemanticRange
-  VERSION = "2.1.0"
+  VERSION = "3.0.0"
 
   class Version
     attr_reader :major, :minor, :patch, :prerelease
 
-    def initialize(version, loose = false)
+    def initialize(version, loose: false)
       @raw = version
       @loose = loose
 
@@ -45,13 +45,13 @@ module SemanticRange
     end
 
     def compare(other)
-      other = Version.new(other, @loose) unless other.is_a?(Version)
+      other = Version.new(other, loose: @loose) unless other.is_a?(Version)
       res = truthy(compare_main(other)) || truthy(compare_pre(other))
       res.is_a?(FalseClass) ? 0 : res
     end
 
     def compare_main(other)
-      other = Version.new(other, @loose) unless other.is_a?(Version)
+      other = Version.new(other, loose: @loose) unless other.is_a?(Version)
       truthy(self.class.compare_identifiers(@major, other.major)) ||
       truthy(self.class.compare_identifiers(@minor, other.minor)) ||
       truthy(self.class.compare_identifiers(@patch, other.patch))

metadata

@@ -1,43 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: semantic_range
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 3.0.0
 platform: ruby
 authors:
 - Andrew Nesbitt
 autorequire: 
-bindir: exe
+bindir: bin
 cert_chain: []
-date: 2018-09-24 00:00:00.000000000 Z
+date: 2021-03-04 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.11'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.11'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '12.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '12.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -59,27 +31,13 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".github/CONTRIBUTING.md"
-- ".github/ISSUE_TEMPLATE.md"
-- ".github/PULL_REQUEST_TEMPLATE.md"
-- ".github/SUPPORT.md"
-- ".gitignore"
-- ".rspec"
-- ".travis.yml"
-- CODE_OF_CONDUCT.md
-- Gemfile
-- Guardfile
 - LICENSE.txt
 - README.md
-- Rakefile
-- bin/console
-- bin/setup
 - lib/semantic_range.rb
 - lib/semantic_range/comparator.rb
 - lib/semantic_range/pre_release.rb
 - lib/semantic_range/range.rb
 - lib/semantic_range/version.rb
-- semantic_range.gemspec
 homepage: https://libraries.io/github/librariesio/semantic_range
 licenses:
 - MIT
@@ -99,8 +57,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.13
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: node-semver rewritten in ruby, for comparison and inclusion of semantic versions

data/.github/CONTRIBUTING.md

@@ -1,195 +0,0 @@
-## Contributing to Libraries.io :heart:
-Thanks for considering contributing. These guidelines outline how to contribute to the [Libraries.io](http://github.com/librariesio) project.
-
-## Table of Contents
-[What is Libraries.io all about?](#whats-librariesio-about)
-
-[Who is Libraries.io for?](#who-is-librariesio-for)
-
-[What should I know Before I get started?](#what-should-i-know-before-i-get-started)
-* [Code of conduct](#code-of-conduct)
-* [Language](#language)
-* [Installation and setup](#setup)
-
-[How can I contribute?](#how-can-i-contribute)
-* [Reporting bugs](#reporting-bugs)
-* [Suggesting enhancements](#suggesting-enhancements)
-* [Suggesting a new feature](#suggesting-new-features)
-* [Your first contribution](#your-first-contribution)
-* [Tackling something meatier](#tackling-something-meatier)
-
-[How can I talk to other contributors?](#how-can-i-talk-to-other-contributors)
-* [Chat](#chat)
-* [Video](#video)
-* [Social media](#twitter)
-
-[Who Are Libraries.io's Users?](#who-are-librariesios-users)
-
-[Our workflow](#workflow)
-
-
-## What's Libraries.io About?
-_Our goal is to raise the quality of all software._
-
-By outlining our [mission and strategy](/strategy.md) we hope to give you more power to make decisions and determine how best to spend your time. Specifically we tackle three distinct problems:
-
-* Discovery: _Helping developers make faster, more informed decisions about the software that they use._
-* Maintainability: _Helping maintainers understand more about the software they depend upon and the consumers of their software._
-* Sustainability: _Supporting undervalued software by highlighting shortfalls in contribution and funneling support to them._
-
-The first of these problems is our foccus for Libraries.io. The other two we are trying to tackle at [Tidelift](https://tidelift.com).
-
-## Who is Libraries.io For?
-Libraries.io currently caters for the needs of three distinct user groups:
-
-* Google: _is hungry for your linked datas so she can serve you up search traffic_
-* Searcher: _is a developer with a problem, she is looking for something to help solve it._
-* Maintainer: _has a project that is used within and/or incorporates open dependencies. She needs to ensure her project(s) are working as expected for users._
-
-These groups have been expanded into [personas](/personas.md) for contributors to reference.
-
-## What Should I Know Before I Get Started?
-
-### Code of Conduct
-Libraries.io is an open and inclusive [community of people](https://github.com/orgs/librariesio/people) working together. We expect contributors to abide by our [contributor code of conduct](CODE_OF_CONDUCT.md) which basically say 'be excellent to each other'. Please report unacceptable behavior to conduct@libraries.io
-
-### Language
-We communicate predominately in English. Contributions to the project should be made with English as the first language. We are happy for members of the community to communicate in a language other than English in chat, email and video but be aware that this might be considered exclusive by other members of the community.
-
-### Documentation
-Documentation for the project as a whole is available at [docs.libraries.io](https://docs.libraries.io). These pages are generated from the [documentation](https://github.com/librariesio/documentation) repo. Documentation that needs to be in every repo is replicated in [required-files](https://github.com/librariesio/required-files) (currently limited to [GitHub templates](https://github.com/blog/2111-issue-and-pull-request-templates)). Otherwise documentation will be specific to that repo. For example the main [Libraries.io](https://github.com/librariesio/libraries.io) `README.md` contains information about installing and running the main rails application.
-
-### Setup
-If you wish to make contributions to Libraries.io then you'll need a local version of the site to test. You can find instructions to install the correct Ruby version, Postgres, and to set up the database in our [README](https://github.com/librariesio/libraries.io/blob/master/README.md#getting-started).
-
-## How Can I Contribute?
-
-### Reporting Bugs
-
-The simplest thing that you can do to help us is by filing good bug reports, so here we go:
-
-#### Before Submitting a Bug Report
-
-* Double-check that the bug is persistent. The site is still in it's infancy and sometimes artifacts may appear and disappear.
-* Double-check the bug hasn't already been reported [on our issue tracker](https://github.com/search?utf8=%E2%9C%93&q=is%3Aopen+is%3Aissue+org%3Alibrariesio), they *should* be labelled `bug` or `bugsnag`.
-
-If something hasn't been raised, you can go ahead and create a new issue using [the template](/issue_template.md). If you'd like to help investigate further or fix the bug just mention it in your issue and check out our [workflow](#workflow).
-
-### Suggesting Enhancements
-
-The next simplest thing you can do to help us is by telling us how we can improve the features we already support, here we go:
-
-#### Before Submitting an Enhancement
-
-* Check that the enhancement is not already [in our issue tracker](https://github.com/search?utf8=%E2%9C%93&q=is%3Aopen+is%3Aissue+org%3Alibrariesio), they should be labelled 'enhancement'.
-
-If there isn't already an issue for feature then go ahead and create a new issue for it using the [template](/issue_template.md). If you'd like to work on the enhancement then just mention it in a comment and check out our [workflow](#workflow).
-
-### Suggesting New Features
-
-If you're into this zone then you need to understand a little more about what we're trying to achieve:
-
-#### Before Suggesting a Feature
-
-* Check that it aligns with [our strategy](strategy.md) and is specifically not in line with something we have said we will not do (for the moment this is anything to do with ranking *people*).
-* Check that the feature is not already [in our issue tracker](https://github.com/search?utf8=%E2%9C%93&q=is%3Aopen+is%3Aissue+org%3Alibrariesio), they should be tagged 'feature'.
-
-If you're still thinking about that killer feature that no one else is thinking about then *please* create an issue for it using the [template](/issue_template.md).
-
-### Your First Contribution
-You're in luck! We label issues that are ideal for first time contributors with [`first-pr`](https://github.com/search?l=&q=is%3Aopen+is%3Aissue+org%3Alibrariesio+label%3Afirst-pr&ref=advsearch&type=Issues&utf8=%E2%9C%93). For someone who wants something a little more meaty you might find an issue that needs some assistance with [`help wanted`](https://github.com/search?utf8=%E2%9C%93&q=is%3Aopen+is%3Aissue+org%3Alibrariesio+label%3A%22help+wanted%22&type=Issues). Next you'll want to read our [workflow](#workflow).
-
-### Tackling Something Meatier
-
-Tickets are labeled by size, skills required and to indicate workflow. Details can be found in our [labelling policy](/labelling.md).
-
-To get you started you might want to check out issues concerning [documentation](https://github.com/librariesio/documentation/issues/), [user experience](https://github.com/librariesio/libraries.io/labels/ux), [visual design](https://github.com/librariesio/libraries.io/issues/labels/visual%20design) or perhaps something already [awaiting help](https://github.com/librariesio/libraries.io/labels/help%20wanted). You may find the following useful:
-
-* Our [strategy](/strategy.md) which outlines what our goals are, how we are going to achieve those goals and what we are specifically going to avoid.
-* An [overview](/overview.md) of the components that make up the Libraries.io project and run the [https://libraries.io](https://libraries.io) site.
-
-## How Can I Talk To Other Contributors?
-
-### Chat
-We use [Slack](http://slack.io) for chat. There's an open invitation available to anyone who wishes to join the conversation at [http://slack.libraries.io](http://slack.libraries.io).
-
-We try to use the following channels accordingly:
-
-* `#general` channel is used for general, water cooler-type conversation, contributor updates and issue discussion.
-* `#events` is used to share and discuss events that may be of interest to or attended by members of the community
-* `#activity` contains notifications from the various platforms that we use to keep the Libraries.io project turning. Including notifications from GitHub, Twitter and our servers.
-
-Members are encouraged to openly discuss their work, their lives, share views and ask for help using chat. It should be considered a *safe space* in which there is *no such thing as a stupid question*. Conversely no one contributor should ever be expected to have read something said in a chat. If someone should know something then it should be written down as an issue and/or documented in an obvious place for others to find.  
-
-### Video
-[Google Hangouts](http://hangouts.google.com) is our preferred tool for video chat. We operate an [open hangout](http://bit.ly/2kWtYak) for anyone to jump into at any time to discuss issues face to face.
-
-### Regular updates
-Contributors are encouraged to share what they're working on. We do this through daily or weekly updates in the `#general` channel on Slack. Updates should take the format 'currently working on X, expecting to move onto Y, blocked on Z' where x, y and z are issues in our [issue tracker](https://github.com/search?utf8=%E2%9C%93&q=is%3Aopen+is%3Aissue+org%3Alibrariesio).
-
-Additionally we host an [open hangout](http://bit.ly/2kWtYak) for any contributor to join at *5pm BST/GMT on a Tuesday* to discuss their work, the next week's priorities and to ask questions of other contributors regarding any aspect of the project. Again this is considered a *safe space* in which *there is no such thing as a stupid question*.
-
-### Mail
-The [core team](https://github.com/orgs/librariesio/teams/core) operate a mailing list for project updates. If you'd like to subscribe you'll find a form in the footer on [Libraries.io](http://libraries.io).
-
-### Twitter
-We have an account on Twitter at [@librariesio](http://twitter.com/librariesio). This is predominately used to retweet news, events and musings by contributors rather than as a direct method of communication. Contributors are encouraged to use @librariesio in a tweet when talking about the project, so that we may retweet if appropriate. The account is moderated and protected by the [core team](https://github.com/orgs/librariesio/teams/core).
-
-### Facebook
-We have a Facebook page at [@libraries.io](https://www.facebook.com/libraries.io). Again this is predominantly used to gather and reflect news, events and musings by contributors rather than as a direct method of communication. Contributors are encouraged to reference Libraries.io in a post when talking about the project, so that we may reflect this if appropriate. Again the account is moderated and protected by the [core team](https://github.com/orgs/librariesio/teams/core).
-
-### Medium
-We have a Medium account at [@librariesio](https://medium.com/@librariesio) and once again it is used to reflect news, events and musings by contributors rather than a direct method of communication. Contributors are encouraged to reference @librariesio in a post when talking about the project, so that we may recommend it if appropriate. Again the account is moderated and protected by the [core team](https://github.com/orgs/librariesio/teams/core).
-
-## Who Are Libraries.io's Users?
-Libraries.io focusses on the following personas:
-
-### Google
-_Is hungry for linked data so she can serve you up search traffic_
-
-### 'Searcher'
-_Is a developer with a problem, she is looking for something to help solve it._
-
-### 'Extender'
-_Has her own ideas. She wants access to the raw data so that she can mash up her own service and offer it to the world._
-
-## Workflow
-In general we use [GitHub](https://help.github.com/) and [Git](https://git-scm.com/docs/gittutorial) to support our workflow. If you are unfamiliar with those tools then you should check them out until you feel you have a basic understanding of GitHub and a working understanding of Git. Specifically you should understand how forking, branching, committing, PRing and merging works.
-
-#### Forking
-We prefer that contributors fork the project in order to contribute.
-
-#### Branching
-We *try* to use principles of [GitHub-flow](https://lucamezzalira.com/2014/03/10/git-flow-vs-github-flow/) in our branching model. That is the `master` branch will always be deployable to the live site, and that every branch from that will be used to add a feature, fix a bug, improve something or otherwise represent an atomic unit of work.
-
-#### Ticketing
-We *try* to create an issue for everything. That is any bug, feature or enhancement that is worth an open, focussed and documented discussion.
-
-#### Labelling
-We constrain labels as they are a key part of our workflow. Tickets will be labeled according to our [labelling policy](/labelling.md).
-
-#### Templates
-We use templates to guide contributors toward good practice in [filing bugs, requesting enhancements and features](/issue_template.md) and in [issuing pull-requests](/pull_request_template.md).
-
-#### Commenting
-If it is possible to comment your contribution — for instance if you are contributing code — then do so in a way that is simple, clear, concise and lowers the level of understanding necessary for others to comprehend what comes afterward. If you are contributing code it is very likely it will be rejected if it does not contain sufficient comments.
-
-#### Committing
-When committing to a branch be sure to use plain, simple language that describes the incremental changes made on the branch toward the overall goal. Avoid unnecessary complexity. Simplify whenever possible. Assume a reasonable but not comprehensive knowledge of the tools, techniques and context of your work.
-
-#### Testing
-When adding or fixing functionality, tests should be added to help reduce future regressions and breakage. All tests are ran automatically when new commits are pushed to a branch. Pull requests with broken/missing tests are not likely to be merged.
-
-#### Submitting for Review
-Once a piece of work (in a branch) is complete it should be readied for review. This is your last chance to ensure that your contribution is [properly tested](#testing). If you are contributing code it is likely your contribution will be rejected if it would lower the test-coverage. Once this is done you can submit a pull-request following the [template](/pull_request_template.md).
-
-It is likely that your contributions will need to be checked by at least one member of the [core team](https://github.com/orgs/librariesio/teams/core) prior to merging. It is also incredibly likely that your contribution may need some re-work in order to be accepted. Particularly if it lacks an appropriate level of comments, tests or it is difficult to understand your commits. Please do not take offense if this is the case. We understand that contributors give their time because they want to improve the project but please understand it is another's responsibility to ensure that the project is maintainable, and good practices like these are key to ensuring that is possible.
-
-#### Reviewing a PR
-We appreciate that it may be difficult to offer constructive criticism, but it is a necessary part of ensuring the project is maintainable and successful. If it is difficult to understand something, request it is better documented and/or commented. If you do not feel assured of the robustness of a contribution, request it is better tested. If it is unclear what the goal of the piece of work is and how it relates to the [strategy](/strategy.md), request a clarification in the corresponding issue. If a pull-request has no corresponding issue, decreases test coverage or otherwise decreases the quality of the project. Reject it. Otherwise, merge it.
-
-#### Merging
-As we keep the `master` branch in a permanent state of 'deployment ready' once-merged your contribution will be live on the next deployment.
-
-#### Deploying
-Any member of the [deployers](https://github.com/orgs/librariesio/teams/deployers) team are able to redeploy the site. If you require a deployment then you might find one of them in our `#general` [chat channel on Slack](slack.libraries.io).

data/.github/ISSUE_TEMPLATE.md

@@ -1,18 +0,0 @@
-Thanks for taking the time to raise an issue. This template should guide you through the process of submitting a bug, enhancement or feature request. Please erase any part of this template that is not relevant to your issue. 
-
-## Bugs
-Before submitting a bug report:
-
-- [ ] Double-check that the bug is persistent,
-- [ ] Double-check the bug hasn't already been reported [on our issue tracker](https://github.com/issues?utf8=%E2%9C%93&q=is%3Aopen+is%3Aissue+org%3Alibrariesio), they *should* be labelled `bug` or `bugsnag`.
-
-If you have completed those steps then please replace this section with a description of the steps taken to recreate the bug, the expected behavior and the observed behavior.
-
-## Enhancements and Features
-
-Before submitting an enhancement or feature request:
-
-- [ ] Check that the enhancement is not already [in our issue tracker](https://github.com/issues?utf8=%E2%9C%93&q=is%3Aopen+is%3Aissue+org%3Alibrariesio), they should be labelled 'enhancement'., 
-- [ ] For large feature requests, check that your request aligns with our strategy http://docs.libraries.io/strategy.
- 
-If you have complete the above step then please replace this section with a description of your proposed enhancement or feature, the motivation for it, an approach and any alternative approaches considered, and whether you are willing and able to create a pull request for it. Note that we may close this issue if it's not something we're planning on working on.

data/.github/PULL_REQUEST_TEMPLATE.md

@@ -1,10 +0,0 @@
-Thanks taking the time to contribute. This template should help guide you through the process of creating a pull request for review. Please erase any part of this template that is not relevant to your pull request:
-
-
-- [ ] Have you followed the guidelines for [contributors](http://docs.libraries.io/contributorshandbook)?
-- [ ] Have you checked to ensure there aren't other open pull requests on the repository for a similar change?
-- [ ] Is there a corresponding ticket for your pull request?
-- [ ] Have you written new tests for your changes?
-- [ ] Have you successfully run the project with your changes locally?
-
-If so then please replace this section with a link to the ticket(s) it addressed, an explanation of your change and why you think we should include it. Thanks again! 

data/.github/SUPPORT.md

@@ -1,10 +0,0 @@
-# Libraries.io Support
-
-If you're looking for support for Libraries.io there are a lot of options, check out:
-
-* Documentation — https://docs.libraries.io
-* Email — support@libraries.io
-* Twitter — https://twitter.com/librariesio
-* Chat — https://slack.libraries.io
-
-On Discuss and in the Libraries.io Slack team, there are a bunch of helpful community members that should be willing to point you in the right direction.

data/.gitignore

@@ -1,10 +0,0 @@
-/.bundle/
-/.yardoc
-/Gemfile.lock
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-.idea

data/.rspec

@@ -1,2 +0,0 @@
---format documentation
---color

data/.travis.yml

@@ -1,9 +0,0 @@
-language: ruby
-rvm:
-- 2.3.3
-before_install: gem install bundler -v 1.13.6
-cache: bundler
-sudo: false
-notifications:
-  slack:
-    secure: lT8nj3FTS1JncJ3+lBrztipeeUCT02AWDT+yqNRrYFcHni4nKpxjSMVuT7VJvWzyiCHo5bqqoHMZLrcoA71Qoe6uaO4Gcpe6Go6Rtg2HAh+F2gpEkGCCqKSrhckbgj6gtrBncm4JsbUHoyu0n75LNUTf7+CUZE88mr0cqNkaKUeD6tPvocAt14YN+w3HhtHsnldjv+I8WW2Uai+u3JOlB2Pvje7i8GGQMgjftmbFzcAGZKryKX+VUPqt0OgzeBXop6N+9X3U5Gf0kPSu5JMlsBXlb/bt+z95bw3BAkUdiTXl/HK/qcgLE0nA6e2NZ0H7SyiVl1XrANh/Gy2LrkSv38yqCpnGnAP3mr20DuBK1cytCc+1bHzGwnXz96QWbv2SUGIcWDbW+NLXVDqwQTNYVdjKLErPL08D1DWjSMHMbq7bf8QuNhtoCDs/1Peh1Ju7um5oADesbr+z5Wf5dxiA6RXbUfYGYuKxN2pkbZimHW+Tn2EMEJ4FvQxnpNF6d+l4VlTkhzUEr0b2GZ4hKTrfCMfRJjN2vjuLQjVv48V3FIMRBuYgoT6X9x3E/1oIfTvkZAXhCWPe8RbOKY7DWW1IugCaN2mUqOSl16buYOMzSl60B/iqv8TBnjXYzLeskrAE3Zj5jY6E+DZRNhhOJXczbwyqxWC7QSDh6YHr7QcCrpE=

data/CODE_OF_CONDUCT.md

@@ -1,74 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-In the interest of fostering an open and welcoming environment, we as
-contributors and maintainers pledge to making participation in our project and
-our community a harassment-free experience for everyone, regardless of age, body
-size, disability, ethnicity, gender identity and expression, level of experience,
-nationality, personal appearance, race, religion, or sexual identity and
-orientation.
-
-## Our Standards
-
-Examples of behavior that contributes to creating a positive environment
-include:
-
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
-
-Examples of unacceptable behavior by participants include:
-
-* The use of sexualized language or imagery and unwelcome sexual attention or
-advances
-* Trolling, insulting/derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or electronic
-  address, without explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
-  professional setting
-
-## Our Responsibilities
-
-Project maintainers are responsible for clarifying the standards of acceptable
-behavior and are expected to take appropriate and fair corrective action in
-response to any instances of unacceptable behavior.
-
-Project maintainers have the right and responsibility to remove, edit, or
-reject comments, commits, code, wiki edits, issues, and other contributions
-that are not aligned to this Code of Conduct, or to ban temporarily or
-permanently any contributor for other behaviors that they deem inappropriate,
-threatening, offensive, or harmful.
-
-## Scope
-
-This Code of Conduct applies both within project spaces and in public spaces
-when an individual is representing the project or its community. Examples of
-representing a project or community include using an official project e-mail
-address, posting via an official social media account, or acting as an appointed
-representative at an online or offline event. Representation of a project may be
-further defined and clarified by project maintainers.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at andrew@libraries.io. All
-complaints will be reviewed and investigated and will result in a response that
-is deemed necessary and appropriate to the circumstances. The project team is
-obligated to maintain confidentiality with regard to the reporter of an incident.
-Further details of specific enforcement policies may be posted separately.
-
-Project maintainers who do not follow or enforce the Code of Conduct in good
-faith may face temporary or permanent repercussions as determined by other
-members of the project's leadership.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
-available at [http://contributor-covenant.org/version/1/4][version]
-
-[homepage]: http://contributor-covenant.org
-[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -1,5 +0,0 @@
-source 'https://rubygems.org'
-
-# Specify your gem's dependencies in semantic_range.gemspec
-gemspec
-gem 'guard-rspec'

data/Guardfile

@@ -1,87 +0,0 @@
-# A sample Guardfile
-# More info at https://github.com/guard/guard#readme
-
-## Uncomment and set this to only include directories you want to watch
-# directories %w(app lib config test spec features) \
-#  .select{|d| Dir.exists?(d) ? d : UI.warning("Directory #{d} does not exist")}
-
-## Note: if you are using the `directories` clause above and you are not
-## watching the project directory ('.'), then you will want to move
-## the Guardfile to a watched dir and symlink it back, e.g.
-#
-#  $ mkdir config
-#  $ mv Guardfile config/
-#  $ ln -s config/Guardfile .
-#
-# and, you'll have to watch "config/Guardfile" instead of "Guardfile"
-
-guard :bundler do
-  require 'guard/bundler'
-  require 'guard/bundler/verify'
-  helper = Guard::Bundler::Verify.new
-
-  files = ['Gemfile']
-  files += Dir['*.gemspec'] if files.any? { |f| helper.uses_gemspec?(f) }
-
-  # Assume files are symlinked from somewhere
-  files.each { |file| watch(helper.real_path(file)) }
-end
-
-guard 'migrate' do
-  watch(%r{^db/migrate/(\d+).+\.rb})
-  watch('db/seeds.rb')
-end
-
-# Note: The cmd option is now required due to the increasing number of ways
-#       rspec may be run, below are examples of the most common uses.
-#  * bundler: 'bundle exec rspec'
-#  * bundler binstubs: 'bin/rspec'
-#  * spring: 'bin/rspec' (This will use spring if running and you have
-#                          installed the spring binstubs per the docs)
-#  * zeus: 'zeus rspec' (requires the server to be started separately)
-#  * 'just' rspec: 'rspec'
-
-guard :rspec, cmd: "bundle exec rspec" do
-  require "guard/rspec/dsl"
-  dsl = Guard::RSpec::Dsl.new(self)
-
-  # Feel free to open issues for suggestions and improvements
-
-  # RSpec files
-  rspec = dsl.rspec
-  watch(rspec.spec_helper) { rspec.spec_dir }
-  watch(rspec.spec_support) { rspec.spec_dir }
-  watch(rspec.spec_files)
-
-  # Ruby files
-  ruby = dsl.ruby
-  dsl.watch_spec_files_for(ruby.lib_files)
-
-  # Rails files
-  rails = dsl.rails(view_extensions: %w(erb haml slim))
-  dsl.watch_spec_files_for(rails.app_files)
-  dsl.watch_spec_files_for(rails.views)
-
-  watch(rails.controllers) do |m|
-    [
-      rspec.spec.("routing/#{m[1]}_routing"),
-      rspec.spec.("controllers/#{m[1]}_controller"),
-      rspec.spec.("acceptance/#{m[1]}")
-    ]
-  end
-
-  # Rails config changes
-  watch(rails.spec_helper)     { rspec.spec_dir }
-  watch(rails.routes)          { "#{rspec.spec_dir}/routing" }
-  watch(rails.app_controller)  { "#{rspec.spec_dir}/controllers" }
-
-  # Capybara features specs
-  watch(rails.view_dirs)     { |m| rspec.spec.("features/#{m[1]}") }
-  watch(rails.layouts)       { |m| rspec.spec.("features/#{m[1]}") }
-
-  # Turnip features and steps
-  watch(%r{^spec/acceptance/(.+)\.feature$})
-  watch(%r{^spec/acceptance/steps/(.+)_steps\.rb$}) do |m|
-    Dir[File.join("**/#{m[1]}.feature")][0] || "spec/acceptance"
-  end
-end

data/Rakefile

@@ -1,6 +0,0 @@
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
-
-RSpec::Core::RakeTask.new(:spec)
-
-task :default => :spec

data/bin/console

@@ -1,14 +0,0 @@
-#!/usr/bin/env ruby
-
-require "bundler/setup"
-require "semantic_range"
-
-# You can add fixtures and/or initialization code here to make experimenting
-# with your gem easier. You can also use a different console, if you like.
-
-# (If you use this, don't forget to add pry to your Gemfile!)
-# require "pry"
-# Pry.start
-
-require "irb"
-IRB.start

data/bin/setup

@@ -1,7 +0,0 @@
-#!/bin/bash
-set -euo pipefail
-IFS=$'\n\t'
-
-bundle install
-
-# Do any other automated setup that you need to do here

data/semantic_range.gemspec

@@ -1,24 +0,0 @@
-# coding: utf-8
-lib = File.expand_path('../lib', __FILE__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'semantic_range/version'
-
-Gem::Specification.new do |spec|
-  spec.name          = "semantic_range"
-  spec.version       = SemanticRange::VERSION
-  spec.authors       = ["Andrew Nesbitt"]
-  spec.email         = ["andrewnez@gmail.com"]
-
-  spec.summary       = %q{node-semver rewritten in ruby, for comparison and inclusion of semantic versions and ranges}
-  spec.homepage      = "https://libraries.io/github/librariesio/semantic_range"
-  spec.license       = "MIT"
-
-  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
-  spec.bindir        = "exe"
-  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-
-  spec.add_development_dependency "bundler", "~> 1.11"
-  spec.add_development_dependency "rake", "~> 12.0"
-  spec.add_development_dependency "rspec", "~> 3.4"
-end