win32-api 1.4.8 → 1.9.1

data/vendor/bundle/ruby/2.5.0/gems/rake-compiler-dock-0.7.2/README.md

@@ -0,0 +1,162 @@
+# rake-compiler-dock
+
+**Easy to use and reliable cross compiler environment for building Windows, Linux and JRuby binary gems.**
+
+It provides cross compilers and Ruby environments for 2.2 and newer versions of the [RubyInstaller](http://rubyinstaller.org/) and Linux runtime environments.
+They are prepared for use with [rake-compiler](https://github.com/rake-compiler/rake-compiler).
+It is used by [many gems with C or JRuby extentions](https://github.com/rake-compiler/rake-compiler-dock/wiki/Projects-using-rake-compiler-dock).
+
+This is kind of successor of [rake-compiler-dev-box](https://github.com/tjschuck/rake-compiler-dev-box).
+It is wrapped as a gem for easier setup, usage and integration and is based on lightweight Docker containers.
+It is also more reliable, since the underlying docker images are versioned and immutable.
+
+## Installation
+
+Install docker natively on Linux:
+
+    $ sudo apt-get install docker.io
+
+... or install [docker-toolbox for Windows and OSX](https://www.docker.com/docker-toolbox) or boot2docker on [Windows](https://github.com/boot2docker/windows-installer/releases) or [OS X](https://github.com/boot2docker/osx-installer/releases) .
+
+Install rake-compiler-dock as a gem. The docker image is downloaded later on demand:
+
+    $ gem install rake-compiler-dock
+
+... or build your own gem and docker image:
+
+    $ git clone https://github.com/rake-compiler/rake-compiler-dock
+    $ rake install
+
+
+## Usage
+
+Rake-compiler-dock provides the necessary tools to build Ruby extensions for Windows and Linux written in C and C++ and JRuby written in Java.
+It is intended to be used in conjunction with [rake-compiler's](https://github.com/rake-compiler/rake-compiler) cross build capability.
+Your Rakefile should enable cross compilation like so:
+
+    Rake::ExtensionTask.new('my_extension', my_gem_spec) do |ext|
+      ext.cross_compile = true
+      ext.cross_platform = %w[x86-mingw32 x64-mingw32 x86-linux x86_64-linux]
+    end
+
+It may also be used to build ffi based binary gems like [libusb](https://github.com/larskanis/libusb), but currently doesn't provide any additional build helpers for this use case, beyond docker invocation and cross compilers.
+
+### Interactive Usage
+
+Rake-compiler-dock offers the shell command `rake-compiler-dock` and a [ruby API](http://www.rubydoc.info/gems/rake-compiler-dock/RakeCompilerDock) for issuing commands within the docker image, described below.
+
+`rake-compiler-dock` without arguments starts an interactive shell session.
+This is best suited to try out and debug a build.
+It mounts the current working directory into the docker environment.
+All changes below the current working directory are shared with the host.
+But note, that all other changes to the file system of the container are dropped at the end of the session - the docker image is static for a given version.
+`rake-compiler-dock` can also take the build command(s) from STDIN or as command arguments.
+
+All commands are executed with the same user and group of the host.
+This is done by copying user account data into the container and sudo to it.
+
+To build x86 and x64 Windows and Linux binary gems interactively, it can be called like this:
+
+    user@host:$ cd your-gem-dir/
+    user@host:$ rake-compiler-dock   # this enters a container with an interactive shell
+    user@5b53794ada92:$ bundle
+    user@5b53794ada92:$ rake cross native gem
+    user@5b53794ada92:$ exit
+    user@host:$ ls pkg/*.gem
+    your-gem-1.0.0.gem  your-gem-1.0.0-x64-mingw32.gem  your-gem-1.0.0-x86-mingw32.gem
+    your-gem-1.0.0-x86_64-linux.gem  your-gem-1.0.0-x86-linux.gem
+
+Or non-interactive:
+
+    user@host:$ rake-compiler-dock bash -c "bundle && rake cross native gem"
+
+The environment variable `RUBY_CC_VERSION` is predefined as described [below](#environment-variables).
+
+If necessary, additional software from the Ubuntu repositories can be installed, prior to the build command.
+This is local to the running session, only:
+
+    sudo apt-get update && sudo apt-get install your-package
+
+You can also choose between different executable ruby versions by `rvm use <version>` .
+The current default is 2.5.
+
+### JRuby support
+
+Rake-compiler-dock offers a dedicated docker image for JRuby.
+JRuby doesn't need a complicated cross build environment like C-ruby, but using Rake-compiler-dock for JRuby makes building binary gems more consistent.
+
+To build java binary gems interactively, it can be called like this:
+
+    user@host:$ cd your-gem-dir/
+    user@host:$ RCD_RUBYVM=jruby rake-compiler-dock   # this enters a container with an interactive shell
+    user@5b53794ada92:$ ruby -v
+    jruby 9.2.5.0 (2.5.0) 2018-12-06 6d5a228 OpenJDK 64-Bit Server VM 10.0.2+13-Ubuntu-1ubuntu0.18.04.4 on 10.0.2+13-Ubuntu-1ubuntu0.18.04.4 +jit [linux-x86_64]
+    user@5b53794ada92:$ bundle
+    user@5b53794ada92:$ rake java gem
+    user@5b53794ada92:$ exit
+    user@host:$ ls pkg/*.gem
+    your-gem-1.0.0.gem  your-gem-1.0.0-java.gem
+
+### Add to your Rakefile
+
+To make the build process reproducible for other parties, it is recommended to add rake-compiler-dock to your Rakefile.
+This can be done like this:
+
+    task 'gem:native' do
+      require 'rake_compiler_dock'
+      sh "bundle package"   # Avoid repeated downloads of gems by using gem files from the host.
+      RakeCompilerDock.sh "bundle --local && rake cross native gem"
+      RakeCompilerDock.sh "bundle --local && rake java gem", rubyvm: :jruby
+    end
+
+Rake-compiler-dock uses [semantic versioning](http://semver.org/), so you should add it into your Gemfile, to make sure, that future changes will not break your build.
+
+    gem 'rake-compiler-dock', '~> 0.7.0'
+
+See [the wiki](https://github.com/rake-compiler/rake-compiler-dock/wiki/Projects-using-rake-compiler-dock) for projects which make use of rake-compiler-dock.
+
+
+## Environment Variables
+
+Rake-compiler-dock makes use of several environment variables.
+
+The following variables are recognized by rake-compiler-dock:
+
+* `RCD_RUBYVM` - The flavour of docker image to be used.
+    Must be one of `mri`, `jruby`.
+* `RCD_IMAGE` - The docker image that is downloaded and started.
+    Defaults to "larskanis/rake-compiler-dock:IMAGE_VERSION" with an image version that is determined by the gem version.
+
+The following variables are passed through to the docker container without modification:
+
+* `http_proxy`, `https_proxy`, `ftp_proxy` - See [Frequently asked questions](https://github.com/rake-compiler/rake-compiler-dock/wiki/FAQ) for more details.
+
+The following variables are provided to the running docker container:
+
+* `RCD_IMAGE` - The full docker image name the container is running on.
+* `RCD_HOST_RUBY_PLATFORM` - The `RUBY_PLATFORM` of the host ruby.
+* `RCD_HOST_RUBY_VERSION` - The `RUBY_VERSION` of the host ruby.
+* `RUBY_CC_VERSION` - The target ruby versions for rake-compiler.
+    The default is defined in the [Dockerfile](https://github.com/rake-compiler/rake-compiler-dock/blob/master/Dockerfile), but can be changed as a parameter to rake.
+* `RCD_MOUNTDIR` - The directory which is mounted into the docker container.
+    Defaults to pwd.
+* `RCD_WORKDIR` - The working directory within the docker container.
+    Defaults to pwd.
+
+Other environment variables can be set or passed through to the container like this:
+
+    RakeCompilerDock.sh "rake cross native gem OPENSSL_VERSION=#{ENV['OPENSSL_VERSION']}"
+
+
+## More information
+
+See [Frequently asked questions](https://github.com/rake-compiler/rake-compiler-dock/wiki/FAQ) and [![Join the chat at https://gitter.im/larskanis/rake-compiler-dock](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/larskanis/rake-compiler-dock?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+
+
+## Contributing
+
+1. Fork it ( https://github.com/rake-compiler/rake-compiler-dock/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 a new Pull Request

data/vendor/bundle/ruby/2.5.0/gems/rake-compiler-dock-0.7.2/Rakefile

@@ -0,0 +1,36 @@
+require "rake_compiler_dock"
+require "rake_compiler_dock/gem_helper"
+
+RakeCompilerDock::GemHelper.install_tasks
+
+task :build do
+  sh "docker build -t larskanis/rake-compiler-dock-mri:#{RakeCompilerDock::IMAGE_VERSION} -f Dockerfile.mri ."
+  sh "docker build -t larskanis/rake-compiler-dock-jruby:#{RakeCompilerDock::IMAGE_VERSION} -f Dockerfile.jruby ."
+end
+
+desc "Run tests"
+task :test do
+  sh "ruby -w -W2 -I. -Ilib -e \"#{Dir["test/test_*.rb"].map{|f| "require '#{f}';"}.join}\" -- -v"
+end
+
+desc "Update predefined_user_group.rb"
+task :update_lists do
+
+  users = `rake-compiler-dock bash -c "getent passwd"`.each_line.map do |line|
+    line.chomp.split(":")[0]
+  end.compact.reject(&:empty?) - [RakeCompilerDock::Starter.make_valid_user_name(`id -nu`.chomp)]
+
+  groups = `rake-compiler-dock bash -c "getent group"`.each_line.map do |line|
+    line.chomp.split(":")[0]
+  end.compact.reject(&:empty?) - [RakeCompilerDock::Starter.make_valid_group_name(`id -ng`.chomp)]
+
+  File.open("lib/rake_compiler_dock/predefined_user_group.rb", "w") do |fd|
+    fd.puts <<-EOT
+      # DO NOT EDIT - This file is generated per 'rake update_lists'
+      module RakeCompilerDock
+        PredefinedUsers = #{users.inspect}
+        PredefinedGroups = #{groups.inspect}
+      end
+    EOT
+  end
+end

data/vendor/bundle/ruby/2.5.0/gems/rake-compiler-dock-0.7.2/bin/rake-compiler-dock

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+
+require 'rake_compiler_dock'
+
+args = ARGV.empty? ? ['bash'] : ARGV.dup
+
+if $stdin.tty?
+  # An interactive session should not leave the container on Ctrl-C
+  args << {:sigfw => false}
+end
+
+begin
+  RakeCompilerDock.exec(*args) do |ok, res|
+    exit(res.exitstatus)
+  end
+rescue RakeCompilerDock::DockerIsNotAvailable
+  exit(-1)
+end

data/vendor/bundle/ruby/2.5.0/gems/rake-compiler-dock-0.7.2/build/mk_i686.rb

@@ -0,0 +1,16 @@
+require "fileutils"
+
+Dir["/usr/bin/x86_64-linux-gnu-*"].each do |file|
+  case File.basename(file)
+  when /^x86_64-linux-gnu-(gcc|g\+\+|ld)$/
+    e = $1
+    puts "create /usr/bin/i686-linux-gnu-#{e}"
+    File.write("/usr/bin/i686-linux-gnu-#{e}", <<-EOT)
+#!/bin/sh
+x86_64-linux-gnu-#{e} -m32 "$@"
+    EOT
+    File.chmod(0755, "/usr/bin/i686-linux-gnu-#{e}")
+  when /^x86_64-linux-gnu-([a-z+\.]+)$/
+    FileUtils.ln_s(file, "/usr/bin/i686-linux-gnu-#{$1}", verbose: true)
+  end
+end

data/vendor/bundle/ruby/2.5.0/gems/rake-compiler-dock-0.7.2/build/patches/rake-compiler-1.0.7/enable-static.diff

@@ -0,0 +1,13 @@
+diff --git a/tasks/bin/cross-ruby.rake b/tasks/bin/cross-ruby.rake
+index 6230799..3a69f13 100644
+--- a/tasks/bin/cross-ruby.rake
++++ b/tasks/bin/cross-ruby.rake
+@@ -134,6 +134,8 @@ file "#{USER_HOME}/builds/#{MINGW_HOST}/#{RUBY_CC_VERSION}/Makefile" => ["#{USER
+     "--target=#{MINGW_TARGET}",
+     "--build=#{RUBY_BUILD}",
+     '--enable-shared',
++    '--enable-static',
++    '--enable-install-static-library',
+     '--disable-install-doc',
+     '--with-ext='
+   ]

data/vendor/bundle/ruby/2.5.0/gems/rake-compiler-dock-0.7.2/build/patches/ruby-2.5.3/no_sendfile.patch

@@ -0,0 +1,24 @@
+diff --git a/configure b/configure
+index ebe3d8c..a336b73 100755
+--- a/configure
++++ b/configure
+@@ -18943,7 +18943,6 @@ do :
+   ac_fn_c_check_func "$LINENO" "sendfile" "ac_cv_func_sendfile"
+ if test "x$ac_cv_func_sendfile" = xyes; then :
+   cat >>confdefs.h <<_ACEOF
+-#define HAVE_SENDFILE 1
+ _ACEOF
+
+ fi
+diff --git a/io.c b/io.c
+index 82c5940538..a8d3661ec8 100644
+--- a/io.c
++++ b/io.c
+@@ -10721,7 +10721,6 @@ nogvl_copy_stream_wait_write(struct copy_stream_struct *stp)
+ }
+
+ #if defined __linux__ && defined __NR_copy_file_range
+-#  define USE_COPY_FILE_RANGE
+ #endif
+
+ #ifdef USE_COPY_FILE_RANGE

data/vendor/bundle/ruby/2.5.0/gems/rake-compiler-dock-0.7.2/build/runas

@@ -0,0 +1,12 @@
+#!/bin/bash
+
+groupadd -o -g "$GID" "$GROUP"
+mkdir -p /tmp/home
+useradd -o -g "$GID" -u "$UID" -G rvm,sudo -p "" -b /tmp/home -m "$USER"
+
+HOME=$(bash <<< "echo ~$USER")
+ln -s /usr/local/rake-compiler "$HOME"/.rake-compiler
+
+sudo -u "$USER" --set-home \
+    BASH_ENV=/etc/rubybashrc \
+    -- "$@"

data/vendor/bundle/ruby/2.5.0/gems/rake-compiler-dock-0.7.2/build/sigfw.c

@@ -0,0 +1,45 @@
+/*
+ * This program handles SIGINT and forwards it to another process.
+ * It is intended to be run as PID 1.
+ *
+ * Docker starts processes with "docker run" as PID 1.
+ * On Linux, the default signal handler for PID 1 ignores any signals.
+ * Therefore Ctrl-C aka SIGINT is ignored per default.
+ */
+
+#include <unistd.h>
+#include <stdio.h>
+#include <signal.h>
+#include <sys/types.h>
+#include <sys/wait.h>
+
+int pid = 0;
+
+void
+handle_sigint (int signum)
+{
+  if(pid)
+    kill(pid, SIGINT);
+}
+
+int main(int argc, char *argv[]){
+  struct sigaction new_action;
+  int status = -1;
+
+  /* Set up the structure to specify the new action. */
+  new_action.sa_handler = handle_sigint;
+  sigemptyset (&new_action.sa_mask);
+  new_action.sa_flags = 0;
+
+  sigaction (SIGINT, &new_action, (void*)0);
+
+  pid = fork();
+  if(pid){
+    wait(&status);
+    return WEXITSTATUS(status);
+  }else{
+    status = execvp(argv[1], &argv[1]);
+    perror("exec");
+    return status;
+  }
+}

data/vendor/bundle/ruby/2.5.0/gems/rake-compiler-dock-0.7.2/build/strip_wrapper

@@ -0,0 +1,30 @@
+#!/usr/bin/env ruby
+
+# Strip file on local folder instead of a Virtualbox shared folder
+# to work around this bug: https://www.virtualbox.org/ticket/8463
+
+require 'tempfile'
+require 'fileutils'
+
+strip = "#{File.basename($0)}.bin"
+
+files = ARGV.reject{|f| f=~/^-/ }.map do |arg|
+  tmp = Tempfile.new 'strip'
+  tmp.close
+  FileUtils.cp arg, tmp.path
+  [tmp, arg]
+end
+
+options = ARGV.select{|f| f=~/^-/ } + files.map{|t,o| t.path }
+
+unless system( strip, *options )
+  exit 127
+end
+code = $?.exitstatus
+
+files.each do |tmp, orig|
+  FileUtils.rm orig
+  FileUtils.cp tmp.path, orig
+end
+
+exit code

data/vendor/bundle/ruby/2.5.0/gems/rake-compiler-dock-0.7.2/build/sudoers

@@ -0,0 +1 @@
+Defaults        env_keep += "http_proxy https_proxy ftp_proxy RCD_HOST_RUBY_PLATFORM RCD_HOST_RUBY_VERSION RCD_IMAGE RUBY_CC_VERSION"

data/vendor/bundle/ruby/2.5.0/gems/rake-compiler-dock-0.7.2/lib/rake_compiler_dock.rb

@@ -0,0 +1,66 @@
+
+# We do ruby version check at runtime, so this file should be kept ruby-1.8 compatible.
+if (m=RUBY_VERSION.match(/^(\d+)\.(\d+)\.(\d+)/)) &&
+    m.captures.map(&:to_i).pack("N*") < [1,9,2].pack("N*")
+  raise "rake-compiler-dock requires at least RUBY_VERSION >= 1.9.2"
+end
+
+require "rake_compiler_dock/colors"
+require "rake_compiler_dock/docker_check"
+require "rake_compiler_dock/starter"
+require "rake_compiler_dock/version"
+require "rake_compiler_dock/predefined_user_group"
+
+module RakeCompilerDock
+
+  # Run the command cmd within a fresh rake-compiler-dock container and within a shell.
+  #
+  # If a block is given, upon command completion the block is called with an OK flag (true on a zero exit status) and a Process::Status object.
+  # Without a block a RuntimeError is raised when the command exits non-zero.
+  #
+  # Option +:verbose+ can be set to enable printing of the command line.
+  # If not set, rake's verbose flag is used.
+  #
+  # Examples:
+  #
+  #   RakeCompilerDock.sh 'bundle && rake cross native gem'
+  #
+  # Check exit status after command runs:
+  #
+  #   sh %{bundle && rake cross native gem}, verbose: false do |ok, res|
+  #     if ! ok
+  #       puts "windows cross build failed (status = #{res.exitstatus})"
+  #     end
+  #   end
+  def sh(cmd, options={}, &block)
+    Starter.sh(cmd, options, &block)
+  end
+
+  def image_name
+    Starter.image_name
+  end
+
+  # Run the command cmd within a fresh rake-compiler-dock container.
+  # The command is run directly, without the shell.
+  #
+  # If a block is given, upon command completion the block is called with an OK flag (true on a zero exit status) and a Process::Status object.
+  # Without a block a RuntimeError is raised when the command exits non-zero.
+  #
+  # * Option +:verbose+ can be set to enable printing of the command line.
+  #   If not set, rake's verbose flag is used.
+  # * Option +:check_docker+ can be set to false to disable the docker check.
+  # * Option +:sigfw+ can be set to false to not stop the container on Ctrl-C.
+  # * Option +:runas+ can be set to false to execute the command as user root.
+  # * Option +:options+ can be an Array of additional options to the 'docker run' command.
+  # * Option +:username+ can be used to overwrite the user name in the container
+  # * Option +:groupname+ can be used to overwrite the group name in the container
+  #
+  # Examples:
+  #
+  #   RakeCompilerDock.exec 'bash', '-c', 'echo $RUBY_CC_VERSION'
+  def exec(*args, &block)
+    Starter.exec(*args, &block)
+  end
+
+  module_function :exec, :sh, :image_name
+end

data/vendor/bundle/ruby/2.5.0/gems/rake-compiler-dock-0.7.2/lib/rake_compiler_dock/colors.rb

@@ -0,0 +1,43 @@
+module RakeCompilerDock
+  module Colors
+    # Start an escape sequence
+    ESC = "\e["
+
+    # End the escape sequence
+    NND = "#{ESC}0m"
+
+    ColorMap = {
+      black: 0,
+      red: 1,
+      green: 2,
+      yellow: 3,
+      blue: 4,
+      magenta: 5,
+      cyan: 6,
+      white: 7,
+    }
+
+    ColorMap.each do |color, code|
+      define_method(color) do |string|
+        colored(code, string)
+      end
+    end
+
+    def colored(color, string)
+      if @colors_on
+        c = ColorMap[color] || color
+        "#{ESC}#{30+c}m#{string}#{NND}"
+      else
+        string.dup
+      end
+    end
+
+    def enable_colors
+      @colors_on = true
+    end
+
+    def disable_colors
+      @colors_on = false
+    end
+  end
+end