mini_portile 0.6.2 → 0.7.0.rc1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b8bb1f4555b185687edb331802be1e4783b39716
-  data.tar.gz: 4de819ec5c11062cb206751a0245380e503b37e1
+  metadata.gz: bdb0513b385a424c53b4671b7b4d2f05dd5ea3bf
+  data.tar.gz: 2af3bdbf45700b4c2285f7b486e2f88515095118
 SHA512:
-  metadata.gz: 8a1ed772f09c079a4bc2582507e92cc661703b6702c1da0e02da6ffc63664d39d06ee04635fc36c863d7e7b3c2fcc2c3afa26ffaf7b31bc6b4d2682185e71cc4
-  data.tar.gz: eda4c7c81eb1e275829a122ea7ce1f438df33a88dc490929aae0637064c809be625180c961f18aa8d4dc070354525f15dd36feb1335e92d57e5a4a3fe263f918
+  metadata.gz: 27dee570e1241cffc7c77c329b58ea2d6d4688fae10cb3692c92b4eaa0f9ffb62547209a1dba4a0e1f1ed7f3cd37e1cd708608ece3aabd9e8d87bc6e10b3135c
+  data.tar.gz: 07462c1c96fe025fdcf005cb50ca9e3fb829c4432a37657caee9f695671b1359ba0b50a92335d5600da622545ec75a7e124ddffcb968debd8bb54ccd3bd3855e

data/.gitignore

@@ -0,0 +1,3 @@
+pkg
+tmp
+Gemfile.lock

data/.travis.yml

@@ -0,0 +1,15 @@
+---
+language: ruby
+sudo: false
+rvm:
+  - 1.9.3
+  - 2.0
+  - 2.1
+  - 2.2
+  - ruby-head
+  - jruby-1.7.22
+  - jruby-9.0.0.0
+
+matrix:
+  allow_failures:
+    - rvm: jruby-9.0.0.0

data/{History.txt → CHANGELOG.md}

@@ -1,15 +1,37 @@
-=== 0.6.2 / 2014-12-30
+### 0.7.0.rc1 / 2015-08-24
+
+Many thanks to @larskanis, @knu, and @kirikak2, who all contributed
+code, ideas, or both to this release.
+
+#### Enhancements
+
+* In patch task, use git(1) or patch(1), whichever is available.
+* Append outputs to patch.log instead of clobbering it for every patch command.
+* Take `configure_options` literally without running a subshell.
+  This changes allows for embedded spaces in a path, among other things.
+  Please unescape `configure_options` where you have been doing it yourself.
+* Print last 20 lines of the given log file, for convenience.
+* Allow SHA1, SHA256 and MD5 hash verification of downloads
+
+
+#### Bugfixes
+
+* Fix issue when proxy username/password use escaped characters.
+* Fix use of https and ftp proxy.
+
+
+### 0.6.2 / 2014-12-30
 
 * Updated gemspec, license and README to reflect new maintainer.
 
 
-=== 0.6.1 / 2014-08-03
+### 0.6.1 / 2014-08-03
 
 * Enhancements:
   * Expand path to logfile to easier debugging on failures.
     Pull #33 [marvin2k]
 
-=== 0.6.0 / 2014-04-18
+### 0.6.0 / 2014-04-18
 
 * Enhancements:
   * Add default cert store and custom certs from `SSL_CERT_FILE` if present.
@@ -22,7 +44,7 @@
 * Internal:
   * Improve examples and use them as test harness.
 
-=== 0.5.3 / 2014-03-24
+### 0.5.3 / 2014-03-24
 
 * Bugfixes:
   * Shell escape paths in tar command. Pull #29. [quickshiftin]
@@ -30,7 +52,7 @@
     the compression type. Pull #27. Closes #21. [b-dean]
   * Try RbConfig's CC before fall back to 'gcc'. Ref #28.
 
-=== 0.5.2 / 2013-10-23
+### 0.5.2 / 2013-10-23
 
 * Bugfixes:
   * Change tar detection order to support NetBSD 'gtar'. Closes #24
@@ -39,27 +61,27 @@
   * Respect ENV's CC variable before fallback to 'gcc'.
   * Avoid non-ASCII output of GCC cause host detection issues. Closes #22
 
-=== 0.5.1 / 2013-07-07
+### 0.5.1 / 2013-07-07
 
 * Bugfixes:
   * Detect tar executable without shelling out. [jtimberman]
 
-=== 0.5.0 / 2012-11-17
+### 0.5.0 / 2012-11-17
 
 * Enhancements:
   * Allow patching extracted files using `git apply`. [metaskills]
 
-=== 0.4.1 / 2012-10-24
+### 0.4.1 / 2012-10-24
 
 * Bugfixes:
   * Syntax to process FTp binary chunks differs between Ruby 1.8.7 and 1.9.x
 
-=== 0.4.0 / 2012-10-24
+### 0.4.0 / 2012-10-24
 
 * Enhancements:
   * Allow fetching of FTP URLs along HTTP ones. [metaskills]
 
-=== 0.3.0 / 2012-03-23
+### 0.3.0 / 2012-03-23
 
 * Enhancements:
   * Use `gcc -v` to determine original host (platform) instead of Ruby one.
@@ -67,7 +89,7 @@
 * Deprecations:
   * Dropped support for Rubies older than 1.8.7
 
-=== 0.2.2 / 2011-04-11
+### 0.2.2 / 2011-04-11
 
 * Minor enhancements:
   * Use LDFLAGS when activating recipes for cross-compilation. Closes #6
@@ -75,12 +97,12 @@
 * Bugfixes:
   * Remove memoization of *_path helpers. Closes #7
 
-=== 0.2.1 / 2011-04-06
+### 0.2.1 / 2011-04-06
 
 * Minor enhancements:
   * Provide MiniPortile#path to obtain full path to installation directory. Closes GH-5
 
-=== 0.2.0 / 2011-04-05
+### 0.2.0 / 2011-04-05
 
 * Enhancements:
   * Improve tar detection
@@ -92,6 +114,6 @@
   * MiniPortile#target can be changed now. Closes GH-2
   * Always redirect tar output properly
 
-=== 0.1.0 / 2011-03-08
+### 0.1.0 / 2011-03-08
 
 * Initial release. Welcome to this world!

data/Gemfile

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

data/README.md

@@ -0,0 +1,185 @@
+# MiniPortile
+
+[![travis status](https://travis-ci.org/flavorjones/mini_portile.svg?branch=master)](https://travis-ci.org/flavorjones/mini_portile?branch=master)
+[![appveyor status](https://ci.appveyor.com/api/projects/status/rjji6y9uteaw4oua/branch/master?svg=true)](https://ci.appveyor.com/project/flavorjones/mini-portile/branch/master)
+
+* Documentation: http://www.rubydoc.info/github/flavorjones/mini_portile
+* Source Code: https://github.com/flavorjones/mini_portile
+* Bug Reports: https://github.com/flavorjones/mini_portile/issues
+
+This project is a minimalistic implementation of a port/recipe system
+**for developers**.
+
+Because _"Works on my machine"_ is unacceptable for a library maintainer.
+
+
+## Not Another Package Management System
+
+`mini_portile` is not a general package management system. It is not
+aimed to replace apt, macports or homebrew.
+
+It's intended primarily to make sure that you, as the developer of a
+library, can reproduce a user's dependencies and environment by
+specifying a specific version of an underlying dependency that you'd
+like to use.
+
+So, if a user says, "This bug happens on my system that uses libiconv
+1.13.1", `mini_portile` should make it easy for you to download,
+compile and link against libiconv 1.13.1; and run your test suite
+against it.
+
+This scenario might be simplified with something like this:
+
+```
+rake compile LIBICONV_VERSION=1.13.1
+```
+
+(For your homework, you can make libiconv version be taken from the
+appropriate `ENV` variables.)
+
+
+
+## Sounds easy, but where's the catch?
+
+You got me, there is a catch. At this time (and highly likely will be
+always) `MiniPortile` is only compatible with **GCC compilers** and
+**autoconf**- or **configure**-based projects.
+
+That is, it assumes the library you want to build contains a
+`configure` script, which all the autoconf-based libraries do.
+
+
+### How to use
+
+Now that you know the catch, and you're still reading this, here is a
+quick example:
+
+```ruby
+require "mini_portile"
+recipe = MiniPortile.new("libiconv", "1.13.1")
+recipe.files = ["http://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.13.1.tar.gz"]
+recipe.cook
+recipe.activate
+```
+
+That's all. `#cook` will download, extract, patch, configure and
+compile the library into a namespaced structure. `#activate` ensures
+GCC will find this library and prefer it over a system-wide
+installation.
+
+
+### Directory Structure Conventions
+
+`MiniPortile` follows the principle of **convention over configuration** and
+established a folder structure where is going to place files and perform work.
+
+Take the above example, and let's draw some picture:
+
+```
+mylib
+  |-- ports
+  |   |-- archives
+  |   |   `-- libiconv-1.13.1.tar.gz
+  |   `-- <platform>
+  |       `-- libiconv
+  |           `-- 1.13.1
+  |               |-- bin
+  |               |-- include
+  |               `-- lib
+  `-- tmp
+      `-- <platform>
+          `-- ports
+```
+
+In above structure, `<platform>` refers to the architecture that
+represents the operating system you're using (e.g. i686-linux,
+i386-mingw32, etc).
+
+Inside the platform folder, `MiniPortile` will store the artifacts
+that result from the compilation process. The library is versioned so
+you can keep multiple versions around on disk without clobbering
+anything.
+
+`archives` is where downloaded source files are cached. It is
+recommended you avoid trashing that folder to avoid downloading the
+same file multiple times (save bandwidth, save the world).
+
+`tmp` is where compilation is performed and can be safely discarded.
+
+Use the recipe's `#path` to obtain the full path to the installation
+directory:
+
+```ruby
+recipe.cook
+recipe.path # => /home/luis/projects/myapp/ports/i686-linux/libiconv/1.13.1
+```
+
+### How can I combine this with my compilation task?
+
+In the simplest case, your rake `compile` task will depend on
+`MiniPortile` compilation and most important, activation.
+
+Example:
+
+```ruby
+task :libiconv do
+  recipe = MiniPortile.new("libiconv", "1.13.1")
+  recipe.files << {
+    url: "http://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.13.1.tar.gz"],
+    md5: "7ab33ebd26687c744a37264a330bbe9a"
+  }
+  checkpoint = ".#{recipe.name}-#{recipe.version}.installed"
+
+  unless File.exist?(checkpoint)
+    recipe.cook
+    touch checkpoint
+  end
+
+  recipe.activate
+end
+
+task :compile => [:libiconv] do
+  # ... your library's compilation task ...
+end
+```
+
+The above example will:
+
+* **download** and verify integrity the sources only once
+* **compile** the library only once (using a timestamp file)
+* ensure compiled library is **activated**
+* make the compile task depend upon compiled library activation
+
+As an exercise for the reader, you could specify the libiconv version
+in an environment variable or a configuration file.
+
+
+### Native and/or Cross Compilation
+
+The above example covers the normal use case: compiling dependencies
+natively.
+
+`MiniPortile` also covers another use case, which is the
+cross-compilation of the dependencies to be used as part of a binary
+gem compilation.
+
+It is the perfect complementary tool for
+[`rake-compiler`](https://github.com/rake-compiler/rake-compiler) and
+its `cross` rake task.
+
+Depending on your usage of `rake-compiler`, you will need to use
+`host` to match the installed cross-compiler toolchain.
+
+Please refer to the examples directory for simplified and practical usage.
+
+
+### Supported Scenarios
+
+As mentioned before, `MiniPortile` requires a GCC compiler
+toolchain. This has been tested against Ubuntu, OSX and even Windows
+(RubyInstaller with DevKit)
+
+
+## License
+
+This library is licensed under MIT license. Please see LICENSE.txt for details.

data/Rakefile

@@ -1,53 +1,25 @@
 require "rake/clean"
-require "rubygems/package_task"
+require 'bundler/gem_tasks'
 
-GEM_SPEC = Gem::Specification.new do |s|
-  # basic information
-  s.name        = "mini_portile"
-  s.version     = "0.6.2"
-  s.platform    = Gem::Platform::RUBY
-
-  # description and details
-  s.summary     = "Simplistic port-like solution for developers"
-  s.description = "Simplistic port-like solution for developers. It provides a standard and simplified way to compile against dependency libraries without messing up your system."
-
-  # requirements
-  s.required_ruby_version = ">= 1.8.7"
-  s.required_rubygems_version = ">= 1.3.5"
-
-  # dependencies (add_dependency)
-  # development dependencies (add_development_dependency)
-
-  # components, files and paths
-  s.files = FileList["examples/Rakefile", "lib/**/*.rb", "Rakefile", "*.{rdoc,txt}"]
-
-  s.require_path = 'lib'
-
-  # documentation
-  s.has_rdoc = true
-  s.rdoc_options << '--main'  << 'README.rdoc' << '--title' << 'MiniPortile -- Documentation'
-
-  s.extra_rdoc_files = %w(README.rdoc History.txt LICENSE.txt)
-
-  # project information
-  s.homepage          = 'http://github.com/flavorjones/mini_portile'
-  s.licenses          = ['MIT']
+namespace :test do
+  desc "Test MiniPortile by running unit tests"
+  task :unit do
+    sh "ruby -w -W2 -I. -e \"#{Dir["test/test_*.rb"].map{|f| "require '#{f}';"}.join}\" -- -v"
+  end
 
-  # author and contributors
-  s.authors     = ['Luis Lavena', 'Mike Dalessio']
-  s.email       = 'mike.dalessio@gmail.com'
+  desc "Test MiniPortile by compiling examples"
+  task :examples do
+    Dir.chdir("examples") do
+      sh "rake ports:all"
+    end
+  end
 end
 
-Gem::PackageTask.new(GEM_SPEC) do |pkg|
-  pkg.need_tar = false
-  pkg.need_zip = false
+task :clean do
+  FileUtils.rm_rf ["examples/ports", "examples/tmp"], :verbose => true
 end
 
-desc "Test MiniPortile by compiling examples"
-task :test do
-  Dir.chdir("examples") do
-    sh "rake ports:all"
-  end
-end
+desc "Run all tests"
+task :test => ["test:unit", "test:examples"]
 
 task :default => [:test]

data/appveyor.yml

@@ -0,0 +1,21 @@
+---
+version: "{build}"
+clone_depth: 10
+install:
+  - ps: ((New-Object Net.WebClient).DownloadFile('https://raw.githubusercontent.com/bagder/ca-bundle/master/ca-bundle.crt', "$env:TMP\ca-bundle.crt"))
+  - SET SSL_CERT_FILE=%TMP%\ca-bundle.crt
+  - SET PATH=C:\Ruby%ruby_version%\bin;%PATH%
+  - ruby --version
+  - gem --version
+  - bundle install
+build: off
+test_script:
+  - bundle exec rake -rdevkit test
+
+environment:
+  matrix:
+    - ruby_version: "193"
+#    - ruby_version: "200"
+#    - ruby_version: "200-x64"
+#    - ruby_version: "21"
+    - ruby_version: "21-x64"

data/examples/.gitignore

@@ -0,0 +1,2 @@
+ports
+tmp

data/examples/Rakefile

@@ -1,10 +1,20 @@
-require File.expand_path("mini_portile", File.join(File.dirname(__FILE__), "../lib"))
+require 'rbconfig'
+
+$: << File.expand_path(File.join(File.dirname(__FILE__), "../lib"))
+require "mini_portile"
 
 recipes = []
 
+def windows?
+  RbConfig::CONFIG['target_os'] =~ /mswin|mingw32/
+end
+
 # libiconv
 libiconv = MiniPortile.new "libiconv", "1.14"
 libiconv.files << "ftp://ftp.gnu.org/pub/gnu/#{libiconv.name}/#{libiconv.name}-#{libiconv.version}.tar.gz"
+unless windows?
+  libiconv.patch_files = Dir["libiconv-patches/*.patch"].map { |dir| File.expand_path dir }
+end
 
 recipes.push libiconv
 
@@ -16,7 +26,7 @@ recipes.push sqlite3
 
 # c-ares
 c_ares = MiniPortile.new "c-ares", "1.7.5"
-c_ares.files << "https://distfiles.openknapsack.org/#{c_ares.name}/#{c_ares.name}-#{c_ares.version}.tar.gz"
+c_ares.files << "http://distfiles.openknapsack.org/#{c_ares.name}/#{c_ares.name}-#{c_ares.version}.tar.gz"
 
 recipes.push c_ares
 
@@ -73,7 +83,11 @@ class ZlibRecipe < MiniPortile
 end
 
 zlib = ZlibRecipe.new "zlib", "1.2.8"
-zlib.files << "http://zlib.net/#{zlib.name}-#{zlib.version}.tar.gz"
+zlib.files << {
+  url: "http://zlib.net/#{zlib.name}-#{zlib.version}.tar.gz",
+  md5: "44d667c142d7cda120332623eab69f40",
+}
+
 
 recipes.push zlib