persistent-dmnd 1.0.2 → 2.0.2

checksums.yaml

@@ -1,15 +1,7 @@
 ---
-!binary "U0hBMQ==":
-  metadata.gz: !binary |-
-    MDY5YzgyMTE1YWE0N2E3NzNiMmIzYWM5ZTNjZGRjZmY2NGEzMWZhMA==
-  data.tar.gz: !binary |-
-    YjE0OWVlYTkyZDg5ZDg2MTk2OGE5ODNlYzVjODIwMTk3NDE2OWE0NQ==
+SHA256:
+  metadata.gz: 8b879b9c77d3a45c968c749d87e6c55122a80a79ed5663e6654395459288ca91
+  data.tar.gz: d2a79f2aeb43dffaddff8b984e1ebb020375b76f6a626206e8625543ea5c2ba3
 SHA512:
-  metadata.gz: !binary |-
-    ZDY0NzhiNjY2YWIwODExZjI3OGRkOGY0OGViZGMyZTNmMWFkMzY4Y2VhYzYz
-    OThmMDNmNjNiOGY0NzNiNGVmNzU1ZWNkM2Q2NzAyY2Y4YzJmMzM0MjQ3NWE0
-    NThlZjRmNDJjZjliNDgwOGMzYmExOWUzNWRlZTkzMjk4NDUyYTk=
-  data.tar.gz: !binary |-
-    NmU5YzY0NDcxMjlmMzA5OTI4MmI0ZjRlMDk1OTIwN2UzOTQxOWIyYmI1Y2I1
-    MGRhYTYxMzhiNDQ2ODBiZDYxNGVhNTU2NDVmMmI0MGVlOTk3MmIxYmMwMzAz
-    ZDljMGExYzlkOGJjNDRiYjc1YTQxN2NlMzA5YmMwZjY3ZTFiNjY=
+  metadata.gz: d3f3ff75d7339f563f33f3e532bdf21e7ec126f8bf6024a62b99c1743ae7710187293a82b560cbf6cd34ae26181312d31a36214fa65ce24049bb31bdee4f758d
+  data.tar.gz: 6f136975f55d67f33662363931c000e0cb30f6e28da2cd5956eb6bf641d8b6bc9e53ea3d22bcc1fa20627499cc90ec1e8663e19beb615c788b7dc5723c8ca008

data/.gitlab-ci.yml

@@ -0,0 +1,414 @@
+# MRI Ruby version list:
+# https://hub.docker.com/r/library/ruby/tags/
+
+testruby_1_9_3:
+  image: "ruby:1.9.3"
+
+  # Cache gems in between builds
+  cache:
+    paths:
+      - vendor/ruby
+
+  before_script:
+    - printf "deb http://archive.debian.org/debian/ jessie main\ndeb-src http://archive.debian.org/debian/ jessie main\ndeb http://security.debian.org jessie/updates main\ndeb-src http://security.debian.org jessie/updates main" > /etc/apt/sources.list
+    - apt-get update >/dev/null                 # Add UTF-8 support
+    - apt-get install -y locales >/dev/null     # |
+    - echo "en_US UTF-8" > /etc/locale.gen      # |
+    - locale-gen en_US.UTF-8                    # |
+    - export LANG=en_US.UTF-8                   # |
+    - export LANGUAGE=en_US:en                  # |
+    - export LC_ALL=en_US.UTF-8                 # v
+    - ruby -v                                   # Print out ruby version for debugging
+    - gem install bundler -v '< 2'              # Bundler is not installed with the image
+    - bundle install -j $(nproc) --path vendor  # Install dependencies into ./vendor/ruby
+
+  script:
+    - bin/rspec
+
+testruby_2_0:
+  image: "ruby:2.0"
+
+  # Cache gems in between builds
+  cache:
+    paths:
+      - vendor/ruby
+
+  before_script:
+    - printf "deb http://archive.debian.org/debian/ jessie main\ndeb-src http://archive.debian.org/debian/ jessie main\ndeb http://security.debian.org jessie/updates main\ndeb-src http://security.debian.org jessie/updates main" > /etc/apt/sources.list
+    - apt-get update >/dev/null                 # Add UTF-8 support
+    - apt-get install -y locales >/dev/null     # |
+    - echo "en_US UTF-8" > /etc/locale.gen      # |
+    - locale-gen en_US.UTF-8                    # |
+    - export LANG=en_US.UTF-8                   # |
+    - export LANGUAGE=en_US:en                  # |
+    - export LC_ALL=en_US.UTF-8                 # v
+    - ruby -v                                   # Print out ruby version for debugging
+    - gem install bundler:'< 2'                 # Bundler is not installed with the image
+    - bundle install -j $(nproc) --path vendor  # Install dependencies into ./vendor/ruby
+
+  script:
+    - bin/rspec
+
+testruby_2_1:
+  image: "ruby:2.1"
+
+  # Cache gems in between builds
+  cache:
+    paths:
+      - vendor/ruby
+
+  before_script:
+    - printf "deb http://archive.debian.org/debian/ jessie main\ndeb-src http://archive.debian.org/debian/ jessie main\ndeb http://security.debian.org jessie/updates main\ndeb-src http://security.debian.org jessie/updates main" > /etc/apt/sources.list
+    - apt-get update >/dev/null                 # Add UTF-8 support
+    - apt-get install -y locales >/dev/null     # |
+    - echo "en_US UTF-8" > /etc/locale.gen      # |
+    - locale-gen en_US.UTF-8                    # |
+    - export LANG=en_US.UTF-8                   # |
+    - export LANGUAGE=en_US:en                  # |
+    - export LC_ALL=en_US.UTF-8                 # v
+    - ruby -v                                   # Print out ruby version for debugging
+    - gem install bundler:'< 2'                 # Bundler is not installed with the image
+    - bundle install -j $(nproc) --path vendor  # Install dependencies into ./vendor/ruby
+
+  script:
+    - bin/rspec
+
+testruby_2_2:
+  image: "ruby:2.2"
+
+  # Cache gems in between builds
+  cache:
+    paths:
+      - vendor/ruby
+
+  before_script:
+    - printf "deb http://archive.debian.org/debian/ jessie main\ndeb-src http://archive.debian.org/debian/ jessie main\ndeb http://security.debian.org jessie/updates main\ndeb-src http://security.debian.org jessie/updates main" > /etc/apt/sources.list
+    - apt-get update >/dev/null                 # Add UTF-8 support
+    - apt-get install -y locales >/dev/null     # |
+    - echo "en_US UTF-8" > /etc/locale.gen      # |
+    - locale-gen en_US.UTF-8                    # |
+    - export LANG=en_US.UTF-8                   # |
+    - export LANGUAGE=en_US:en                  # |
+    - export LC_ALL=en_US.UTF-8                 # v
+    - ruby -v                                   # Print out ruby version for debugging
+    - gem install bundler:'< 2'                 # Bundler is not installed with the image
+    - bundle install -j $(nproc) --path vendor  # Install dependencies into ./vendor/ruby
+
+  script:
+    - bin/rspec
+
+testruby_2_3:
+  image: "ruby:2.3"
+
+  # Cache gems in between builds
+  cache:
+    paths:
+      - vendor/ruby
+
+  before_script:
+    - apt-get update >/dev/null                 # Add UTF-8 support
+    - apt-get install -y locales >/dev/null     # |
+    - echo "en_US UTF-8" > /etc/locale.gen      # |
+    - locale-gen en_US.UTF-8                    # |
+    - export LANG=en_US.UTF-8                   # |
+    - export LANGUAGE=en_US:en                  # |
+    - export LC_ALL=en_US.UTF-8                 # v
+    - ruby -v                                   # Print out ruby version for debugging
+    - gem install bundler:'< 2'                 # Bundler is not installed with the image
+    - bundle install -j $(nproc) --path vendor  # Install dependencies into ./vendor/ruby
+
+  script:
+    - bin/rspec
+
+testruby_2_4:
+  image: "ruby:2.4"
+
+  # Cache gems in between builds
+  cache:
+    paths:
+      - vendor/ruby
+
+  before_script:
+    - apt-get update >/dev/null                 # Add UTF-8 support
+    - apt-get install -y locales >/dev/null     # |
+    - echo "en_US UTF-8" > /etc/locale.gen      # |
+    - locale-gen en_US.UTF-8                    # |
+    - export LANG=en_US.UTF-8                   # |
+    - export LANGUAGE=en_US:en                  # |
+    - export LC_ALL=en_US.UTF-8                 # v
+    - ruby -v                                   # Print out ruby version for debugging
+    - gem install bundler:'< 2'                 # Bundler is not installed with the image
+    - bundle install -j $(nproc) --path vendor  # Install dependencies into ./vendor/ruby
+
+  script:
+    - bin/rspec
+
+testruby_2_5:
+  image: "ruby:2.5"
+
+  # Cache gems in between builds
+  cache:
+    paths:
+      - vendor/ruby
+
+  before_script:
+    - apt-get update >/dev/null                 # Add UTF-8 support
+    - apt-get install -y locales >/dev/null     # |
+    - echo "en_US UTF-8" > /etc/locale.gen      # |
+    - locale-gen en_US.UTF-8                    # |
+    - export LANG=en_US.UTF-8                   # |
+    - export LANGUAGE=en_US:en                  # |
+    - export LC_ALL=en_US.UTF-8                 # v
+    - ruby -v                                   # Print out ruby version for debugging
+    - gem install bundler:'< 2'                 # Bundler is not installed with the image
+    - bundle install -j $(nproc) --path vendor  # Install dependencies into ./vendor/ruby
+
+  script:
+    - bin/rspec
+
+testruby_2_6:
+  image: "ruby:2.6"
+
+  # Cache gems in between builds
+  cache:
+    paths:
+      - vendor/ruby
+
+  before_script:
+    - apt-get update >/dev/null                 # Add UTF-8 support
+    - apt-get install -y locales >/dev/null     # |
+    - echo "en_US UTF-8" > /etc/locale.gen      # |
+    - locale-gen en_US.UTF-8                    # |
+    - export LANG=en_US.UTF-8                   # |
+    - export LANGUAGE=en_US:en                  # |
+    - export LC_ALL=en_US.UTF-8                 # v
+    - ruby -v                                   # Print out ruby version for debugging
+    - gem install bundler:'< 2'                 # Bundler is not installed with the image
+    - bundle install -j $(nproc) --path vendor  # Install dependencies into ./vendor/ruby
+
+  script:
+    - bin/rspec
+
+testruby_2_7:
+  image: "ruby:2.7"
+
+  # Cache gems in between builds
+  cache:
+    paths:
+      - vendor/ruby
+
+  before_script:
+    - apt-get update >/dev/null                 # Add UTF-8 support
+    - apt-get install -y locales >/dev/null     # |
+    - echo "en_US UTF-8" > /etc/locale.gen      # |
+    - locale-gen en_US.UTF-8                    # |
+    - export LANG=en_US.UTF-8                   # |
+    - export LANGUAGE=en_US:en                  # |
+    - export LC_ALL=en_US.UTF-8                 # v
+    - ruby -v                                   # Print out ruby version for debugging
+    - bundle install -j $(nproc) --path vendor  # Install dependencies into ./vendor/ruby
+
+  script:
+    - bin/rspec
+
+testruby_3_0:
+  image: "ruby:3.0.0"
+
+  # Cache gems in between builds
+  cache:
+    paths:
+      - vendor/ruby
+
+  before_script:
+    - apt-get update >/dev/null                 # Add UTF-8 support
+    - apt-get install -y locales >/dev/null     # |
+    - echo "en_US UTF-8" > /etc/locale.gen      # |
+    - locale-gen en_US.UTF-8                    # |
+    - export LANG=en_US.UTF-8                   # |
+    - export LANGUAGE=en_US:en                  # |
+    - export LC_ALL=en_US.UTF-8                 # v
+    - ruby -v                                   # Print out ruby version for debugging
+    - bundle install -j $(nproc) --path vendor  # Install dependencies into ./vendor/ruby
+
+  script:
+    - bin/rspec
+
+testjruby_1_7:
+  image: "jruby:1.7"
+
+  # Cache gems in between builds
+  cache:
+    paths:
+      - vendor/ruby
+
+  before_script:
+    - apt-get update >/dev/null                 # Add UTF-8 support
+    - apt-get install -y locales >/dev/null     # |
+    - echo "en_US UTF-8" > /etc/locale.gen      # |
+    - locale-gen en_US.UTF-8                    # |
+    - export LANG=en_US.UTF-8                   # |
+    - export LANGUAGE=en_US:en                  # |
+    - export LC_ALL=en_US.UTF-8                 # v
+    - apt-get install -y git >/dev/null         # Add git binary
+    - export JRUBY_OPTS=--dev                   # Faster test runs
+    - ruby -v                                   # Print out ruby version for debugging
+    - gem install bundler:'< 2'                 # Bundler is not installed with the image
+    - bundle install -j $(nproc) --path vendor  # Install dependencies into ./vendor/ruby
+
+  script:
+    - bin/rspec
+
+testjruby_9_0:
+  image: "jruby:9.0"
+
+  # Cache gems in between builds
+  cache:
+    paths:
+      - vendor/ruby
+
+  before_script:
+    - rm /etc/apt/sources.list.d/jessie-backports.list
+    - apt-get update                            # Add UTF-8 support
+    - apt-get install -y locales >/dev/null     # |
+    - echo "en_US UTF-8" > /etc/locale.gen      # |
+    - locale-gen en_US.UTF-8                    # |
+    - export LANG=en_US.UTF-8                   # |
+    - export LANGUAGE=en_US:en                  # |
+    - export LC_ALL=en_US.UTF-8                 # v
+    - apt-get install -y git >/dev/null         # Add git binary
+    - export JRUBY_OPTS=--dev                   # Faster test runs
+    - ruby -v                                   # Print out ruby version for debugging
+    - wget https://rubygems.org/downloads/jruby-openssl-0.9.21-java.gem # Needed to support newer ciphers when connecting to rubygems.org (otherwise gem downloads fail)
+    - gem install jruby-openssl-0.9.21-java.gem                         # Install the newer gem
+    - gem uninstall -x -i /opt/jruby/lib/ruby/gems/shared bundler # Remove any pre-existing bundler
+    - gem install bundler:'< 2'                 # Install latest bundler 1.x
+    - bundle install -j $(nproc) --path vendor  # Install dependencies into ./vendor/ruby
+
+  script:
+    - bin/rspec
+
+testjruby_9_1:
+  image: "jruby:9.1"
+
+  # Cache gems in between builds
+  cache:
+    paths:
+      - vendor/ruby
+
+  before_script:
+    - apt-get update >/dev/null                 # Add UTF-8 support
+    - apt-get install -y locales >/dev/null     # |
+    - echo "en_US UTF-8" > /etc/locale.gen      # |
+    - locale-gen en_US.UTF-8                    # |
+    - export LANG=en_US.UTF-8                   # |
+    - export LANGUAGE=en_US:en                  # |
+    - export LC_ALL=en_US.UTF-8                 # v
+    - apt-get install -y git >/dev/null         # Add git binary
+    - export JRUBY_OPTS=--dev                   # Faster test runs
+    - ruby -v                                   # Print out ruby version for debugging
+    - gem uninstall -x -i /opt/jruby/lib/ruby/gems/shared bundler # Remove any pre-existing bundler
+    - gem install bundler:'< 2'                 # Bundler is not installed with the image
+    - bundle install -j $(nproc) --path vendor  # Install dependencies into ./vendor/ruby
+
+  script:
+    - bin/rspec
+
+testjruby_9_1:
+  image: "jruby:9.1"
+
+  # Cache gems in between builds
+  cache:
+    paths:
+      - vendor/ruby
+
+  before_script:
+    - apt-get update >/dev/null                 # Add UTF-8 support
+    - apt-get install -y locales >/dev/null     # |
+    - echo "en_US UTF-8" > /etc/locale.gen      # |
+    - locale-gen en_US.UTF-8                    # |
+    - export LANG=en_US.UTF-8                   # |
+    - export LANGUAGE=en_US:en                  # |
+    - export LC_ALL=en_US.UTF-8                 # v
+    - apt-get install -y git >/dev/null         # Add git binary
+    - export JRUBY_OPTS=--dev                   # Faster test runs
+    - ruby -v                                   # Print out ruby version for debugging
+    - gem uninstall -x -i /opt/jruby/lib/ruby/gems/shared bundler # Remove any pre-existing bundler
+    - gem install bundler:'< 2'                 # Bundler is not installed with the image
+    - bundle install -j $(nproc) --path vendor  # Install dependencies into ./vendor/ruby
+
+  script:
+    - bin/rspec
+
+# This is not repeated from the 9.2 below! 9.2.0.0 is a very specific version with a bug in the Set interoperability so
+# we'll want to check that our workaround is working with this one even after the 9.2 branch moves on.
+testjruby9_2_0_0:
+  image: "jruby:9.2.0.0"
+
+  # Cache gems in between builds
+  cache:
+    paths:
+      - vendor/ruby
+
+  before_script:
+    - apt-get update >/dev/null                 # Add UTF-8 support
+    - apt-get install -y locales >/dev/null     # |
+    - echo "en_US UTF-8" > /etc/locale.gen      # |
+    - locale-gen en_US.UTF-8                    # |
+    - export LANG=en_US.UTF-8                   # |
+    - export LANGUAGE=en_US:en                  # |
+    - export LC_ALL=en_US.UTF-8                 # v
+    - apt-get install -y git >/dev/null         # Add git binary
+    - export JRUBY_OPTS=--dev                   # Faster test runs
+    - ruby -v                                   # Print out ruby version for debugging
+    - gem install bundler:'< 2'                 # Bundler is not installed with the image
+    - bundle install -j $(nproc) --path vendor  # Install dependencies into ./vendor/ruby
+
+  script:
+    - bin/rspec
+
+testjruby_9_2:
+  image: "jruby:9.2"
+
+  # Cache gems in between builds
+  cache:
+    paths:
+      - vendor/ruby
+
+  before_script:
+    - apt-get update >/dev/null                 # Add UTF-8 support
+    - apt-get install -y locales >/dev/null     # |
+    - echo "en_US UTF-8" > /etc/locale.gen      # |
+    - locale-gen en_US.UTF-8                    # |
+    - export LANG=en_US.UTF-8                   # |
+    - export LANGUAGE=en_US:en                  # |
+    - export LC_ALL=en_US.UTF-8                 # v
+    - apt-get install -y git >/dev/null         # Add git binary
+    - export JRUBY_OPTS=--dev                   # Faster test runs
+    - ruby -v                                   # Print out ruby version for debugging
+    - gem uninstall -a -x -i /opt/jruby/lib/ruby/gems/shared bundler # Remove any pre-existing bundler
+    - gem install bundler:'< 2'                 # Bundler is not installed with the image
+    - bundle install -j $(nproc) --path vendor  # Install dependencies into ./vendor/ruby
+
+  script:
+    - bin/rspec
+
+testtruffleruby:
+  image: "danny02/graalvm"
+
+  before_script:
+    - gu install -c org.graalvm.ruby            # Install TruffleRuby
+    - apt-get update >/dev/null                 # Add UTF-8 support
+    - apt-get install -y locales >/dev/null     # |
+    - echo "en_US UTF-8" > /etc/locale.gen      # |
+    - locale-gen en_US.UTF-8                    # |
+    - export LANG=en_US.UTF-8                   # |
+    - export LANGUAGE=en_US:en                  # |
+    - export LC_ALL=en_US.UTF-8                 # v
+    - apt-get install -y git libssl-dev libssl1.1 clang llvm make >/dev/null # Add git binary + truffleruby dependencies
+    - /graalvm*/jre/languages/ruby/lib/truffle/post_install_hook.sh # Rebuild openssl extension, as suggested by install
+                                                                    # notes
+    - ruby -v                                   # Print out ruby version for debugging
+    - bundle install -j $(nproc)                # Install dependencies
+
+  script:
+    - bin/rspec

data/.ruby-version

@@ -1 +1 @@
-ruby-2.5.1
+ruby-3.0.0

data/README.adoc

@@ -4,7 +4,7 @@
 :toclevels: 4
 :toc-title:
 
-// image:https://travis-ci.org/ivoanjo/persistent-dmnd.svg?branch=master["Build Status", link="https://travis-ci.org/ivoanjo/persistent-dmnd"]
+image:https://badge.fury.io/rb/persistent-dmnd.svg["Gem Version", link="https://badge.fury.io/rb/persistent-dmnd"]
 
 Are you tired of calling `.freeze` on your data structures (or your colleagues forgetting to do so)? +
 Do you wish Ruby had a literal for creating immutable arrays?
@@ -97,7 +97,9 @@ It also (_optionally!_) interoperates with the https://github.com/ruby-concurren
 Underneath the covers, persistent-💎 mostly builds atop the awesome https://github.com/hamstergem/hamster[hamster gem].
 Big thanks to its equally-awesome authors!
 
-Persistent-💎 is fully supported and tested on Ruby versions 1.9.3 to 2.6.0-preview2, and JRuby 1.7 to to 9.2. If we don't support your Ruby, it's probably a Python binary. Keep calm and 💎 away!
+Persistent-💎 is fully supported and tested on Ruby versions 1.9.3 to 3.0.0, JRuby 1.7 to 9.2, and TruffleRuby 1.0+ 🎉.
+If we don't support your Ruby, it's probably a Python binary instead (or a potato?).
+Keep calm and 💎 away!
 
 [discrete]
 == Contents
@@ -372,6 +374,8 @@ When you need to go from thread-safe immutable data structures to thread-safe mu
 
 You'll need to install concurrent-ruby first, see https://github.com/ruby-concurrency/concurrent-ruby#installation for instructions.
 
+NOTE: If you're using TruffleRuby, you'll need to use concurrent-ruby >= 1.1.0, as older versions did not work correctly on TruffleRuby.
+
 After that, you'll be able to:
 
 ==== Array
@@ -443,9 +447,9 @@ Every printable ascii character is already in use by Ruby, but I didn't want per
 
 Thus, I kept my Ruby beautiful. With two very clear characters you can create an immutable data structure. No more awkward typing of namespaces. No more `.freeze` everywhere. No-one will ever mistake the use of  `💎` for another operation.
 
-Now you can avoid having `💎` on your codebase altogether: just use `dmnd`, as <<usage,suggested above>>.
+Alas, you may not agree with me! The good news is that you can avoid having `💎` on your codebase altogether: just use `dmnd` as a replacement, as <<usage,documented above>>.
 
-If you're having a hard time typing the emoji, I recommend just adding a quick snippet to your editor or a quick command to search-and-replace `aDmnd`/`hDmnd`/`sDmnd`/`dmndify` for `a💎`/`h💎`/`s💎`/`💎ify`. That way you get best of both worlds: easy to type, and easy to read!
+If you're having a hard time typing the emoji, I recommend just adding a quick snippet to your editor or a quick command to search-and-replace `aDmnd`/`hDmnd`/`sDmnd`/`dmndify` for `a💎`/`h💎`/`s💎`/`💎ify`. That way you get best of both worlds: easy to type, and beautiful to read!
 
 == Usage on Ruby 1.9