laag 0.4.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7fc52971d2115cc524c37687915f4ebc6d1c4634a4daa33949428fd17262d687
+  data.tar.gz: 62300ed74edd656f990c4ea48aba64f6405251a49db719f4e4f74d853e018848
+SHA512:
+  metadata.gz: e3a6054e746b3f91f18643b217e565ae2fdabc67f1bf337c89d744ec039f96fe4157e542c8c4b04f08c214312c7d69ac33d6c2da40260e0935b2e611e518214b
+  data.tar.gz: f2a66b281ea07b95ad7b42dd9d310393844caaf21d6535b0b5be364435fd4a56936f4a2721051f06c4a859491d8f1cc0adfa926968c162130d61f6634fe38afb

data/.gitignore

@@ -0,0 +1 @@
+*.gem

data/LICENSE.txt

@@ -0,0 +1,22 @@
+
+The MIT License (MIT)
+Copyright © 2018 Chris Olstrom <chris@olstrom.com>
+Copyright © 2018 SUSE LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the “Software”), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.org

@@ -0,0 +1,23 @@
+#+TITLE: laag - Library as a Gem
+#+LATEX: \pagebreak
+
+* Overview
+  
+  ~laag~ is a library to support packaging libraries as Ruby Gems.
+
+* Why does this exist?
+
+  Ruby is portable and readily available on all significant platforms. It has
+  solid tools for dependency management, versioning, and vendoring.
+
+  ~laag~ leverages these tools to provide platform-native libraries, so that
+  other Gems that need those libraries can be easier to install.
+
+* License
+
+  ~laag~ is available under the [[https://tldrlegal.com/license/mit-license][MIT License]]. See ~LICENSE.txt~ for the full
+  text.
+
+* Contributors
+
+  - [[https://colstrom.github.io/][Chris Olstrom]] | [[mailto:chris@olstrom.com][e-mail]] | [[https://twitter.com/ChrisOlstrom][Twitter]]

data/laag.gemspec

@@ -0,0 +1,16 @@
+
+# -*- ruby -*-
+
+Gem::Specification.new do |gem|
+  gem.name        = 'laag'
+  gem.version     = `git describe --tags --abbrev=0`.chomp
+  gem.licenses    = 'MIT'
+  gem.authors     = ['Chris Olstrom']
+  gem.email       = 'chris@olstrom.com'
+  gem.homepage    = 'http://colstrom.github.io/laag/'
+  gem.summary     = 'Library as a Gem'
+  gem.description = 'Simplifies platform-native dependency management'
+
+  gem.files         = `git ls-files -z`.split("\x0")
+  gem.executables   = `git ls-files -z -- bin/*`.split("\x0").map { |f| File.basename(f) }
+end

data/lib/laag.rb

@@ -0,0 +1,7 @@
+
+# -*- ruby -*-
+
+require_relative 'laag/build_environment'
+require_relative 'laag/library'
+require_relative 'laag/platform'
+require_relative 'laag/version'

data/lib/laag/build_environment.rb

@@ -0,0 +1,143 @@
+
+# -*- ruby -*-
+
+require 'set' # Ruby Standard Library
+
+module LAAG
+  class BuildEnvironment
+    DEFAULT_FEATURES = Set.new %w[autoconf autoreconf configure make]
+
+    def initialize(library, **options)
+      @library  = library
+      @options  = options
+      @enabled  = Set.new
+      @disabled = Set.new
+      %i[enable disable].each { |s| [*options[s]].each { |f| send s, f } }
+      self
+    end
+
+    def script(&block)
+      instance_eval(&block) if block_given?
+    end
+
+    def execute!(command, *arguments)
+      STDOUT.puts ' -- ' + (commandline = [command, *arguments].flatten.map(&:to_s).join(' '))
+
+      Dir.chdir(@library.source_path) do
+        system(commandline).tap do |success|
+          raise "Error: '#{commandline}' failed" unless success
+        end
+      end
+    end
+
+    def autoreconf!
+      return unless enabled?(:autoreconf) and file?('configure.ac')
+      execute! 'autoreconf', '--install'
+    end
+
+    def autogen!
+      return unless enabled?(:autogen) and file?('autogen.sh')
+      execute! './autogen.sh'
+    end
+
+    def configure!(*arguments)
+      return unless enabled?(:configure)
+      autogen!    unless file?('configure')
+      autoreconf! unless file?('configure')
+      return      unless file?('configure')
+      execute! './configure', configure_options(arguments)
+    end
+
+    def make!(*arguments, make: ENV['MAKE'] || ENV['make'] || 'make')
+      configure! unless file?(makefile)
+      return     unless file?(makefile)
+      execute! make, "-j#{make_jobs}", arguments
+    end
+
+    def configure_options(arguments)
+      [
+        ("--prefix=#{@library.install_path}" unless disabled?(:prefix)),
+        ('--disable-dependency-tracking'     unless enabled?('dependency-tracking')),
+        ('--enable-shared'                   unless disabled?(:shared)),
+        ('--enable-static'                   unless disabled?(:static)),
+        ('--with-pic'                        unless disabled?(:pic)),
+        *arguments
+      ].compact.uniq
+    end
+
+    def default!
+      make! :clean
+      configure!
+      make!
+      make! :install
+      make! :clean
+    end
+
+    #############
+    # Detection #
+    #############
+
+    def file?(filename)
+      return unless filename
+      File.exist? File.join(@library.source_path, filename.split('/'))
+    end
+
+    def makefile
+      RbConfig::CONFIG['MAKEFILES'].split.find { |makefile| file? makefile } || 'Makefile'
+    end
+
+    def make_jobs
+      @options.fetch(:make_jobs) do
+        Etc.respond_to?(:nprocessors) ? Etc.nprocessors : ''
+      end
+    end
+
+    #################
+    # Feature Flags #
+    #################
+
+    def features
+      DEFAULT_FEATURES
+    end
+
+    def disabled
+      @disabled - @enabled
+    end
+
+    def enabled
+      features - disabled
+    end
+
+    ######################
+    # Flag State Queries #
+    ######################
+
+    def enabled?(feature)
+      enabled.include? feature.to_s
+    end
+
+    def disabled?(feature)
+      disabled.include? feature.to_s
+    end
+
+    ###########################
+    # Flag State Manipulation #
+    ###########################
+
+    def enable(feature)
+      feature.tap { @enabled << feature.to_s }
+    end
+
+    def unenable(feature)
+      feature.tap { @enabled.delete feature.to_s }
+    end
+
+    def disable(feature)
+      feature.tap { @disabled << feature.to_s }
+    end
+
+    def undisable(feature)
+      feature.tap { @disabled.delete feature.to_s }
+    end
+  end
+end

data/lib/laag/library.rb

@@ -0,0 +1,44 @@
+
+# -*- ruby -*-
+
+require 'rbconfig' # Ruby Standard Library
+
+module LAAG
+  class Library
+    def initialize(gem_root:, origin:, version:, **options)
+      @gem_root = gem_root
+      @origin   = origin
+      @version  = version
+      @options  = options
+      self
+    end
+
+    attr_reader :gem_root, :origin, :version
+
+    def name
+      @name ||= @options.fetch(:name) { origin.split('/').last.downcase }
+    end
+
+    def package_prefix
+      @package_prefix ||= @options.fetch(:package_prefix) { 'package' }
+    end
+
+    def install_prefix
+      @install_prefix ||= @options.fetch(:install_prefix) do
+        File.join package_prefix, ".#{name}", version
+      end
+    end
+
+    def vendor_prefix
+      @vendor_prefix ||= @options.fetch(:vendor_prefix) { 'vendor' }
+    end
+
+    def install_path
+      @install_path ||= File.join(gem_root, install_prefix)
+    end
+
+    def source_path
+      @source_path ||= File.join(gem_root, vendor_prefix, @origin)
+    end
+  end
+end

data/lib/laag/platform.rb

@@ -0,0 +1,12 @@
+
+# -*- ruby -*-
+
+require 'rbconfig' # Ruby Standard Library
+
+module LAAG
+  module Platform
+    HOST_OS = RbConfig::CONFIG['host_os'].downcase
+    SOEXT   = RbConfig::CONFIG['SOEXT'] || RbConfig::CONFIG['DLEXT']
+    SOGLOB  = (HOST_OS =~ /darwin/) ? "*.#{SOEXT}" : "#{SOEXT}.*"
+  end
+end

data/lib/laag/version.rb

@@ -0,0 +1,11 @@
+
+# -*- ruby -*-
+
+module LAAG
+  VERSION = $LOADED_FEATURES
+              .map { |f| f.match %r{laag-(?<version>[[:digit:]]+\.[[:digit:]]+\.[[:digit:]]+(\.pre)?)} }
+              .compact
+              .map { |gem| gem['version'] }
+              .uniq
+              .first
+end

metadata

@@ -0,0 +1,52 @@
+--- !ruby/object:Gem::Specification
+name: laag
+version: !ruby/object:Gem::Version
+  version: 0.4.4
+platform: ruby
+authors:
+- Chris Olstrom
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-03-07 00:00:00.000000000 Z
+dependencies: []
+description: Simplifies platform-native dependency management
+email: chris@olstrom.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- LICENSE.txt
+- README.org
+- laag.gemspec
+- lib/laag.rb
+- lib/laag/build_environment.rb
+- lib/laag/library.rb
+- lib/laag/platform.rb
+- lib/laag/version.rb
+homepage: http://colstrom.github.io/laag/
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.6
+signing_key: 
+specification_version: 4
+summary: Library as a Gem
+test_files: []