cbc 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1d3dcf4c5bbcc2757b6b06c4e15dfcd898bc345b1b15b5633f760e0d3539e607
+  data.tar.gz: a939b6d0d0b8694c5e6e8d3f8d737a07a263dc1decbb1cc0cedcf3795567fda9
+SHA512:
+  metadata.gz: 608d2f2389cf608e34be2ad1675016177630c28d95fcc3c6ad2643c7a45bca2cf535cc54319031c1037e79a1d09d86d51e77c7fc42705751ccf98c2f56ba6547
+  data.tar.gz: 2e54fe9d70908e10d03d22119697f9c72d2589ba32defa1fafcf48244e0f44ef9a8c4416d548a2d6a522180f7371a71eec6f435327f17a0606d4f38a3a2726db

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+## 0.1.0 (2022-04-13)
+
+- First release

data/LICENSE.txt

@@ -0,0 +1,244 @@
+Eclipse Public License - v 2.0
+
+THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE PUBLIC
+LICENSE (“AGREEMENT”). ANY USE, REPRODUCTION OR DISTRIBUTION OF THE PROGRAM
+CONSTITUTES RECIPIENT'S ACCEPTANCE OF THIS AGREEMENT.
+
+1. DEFINITIONS
+   “Contribution” means:
+
+      a) in the case of the initial Contributor, the initial content Distributed
+         under this Agreement, and
+      b) in the case of each subsequent Contributor:
+         i) changes to the Program, and
+         ii) additions to the Program;
+      where such changes and/or additions to the Program originate from and
+      are Distributed by that particular Contributor. A Contribution
+      “originates” from a Contributor if it was added to the Program by such
+      Contributor itself or anyone acting on such Contributor's behalf.
+      Contributions do not include changes or additions to the Program that
+      are not Modified Works. “Contributor” means any person or entity that
+      Distributes the Program.
+
+   “Licensed Patents” mean patent claims licensable by a Contributor which are
+   necessarily infringed by the use or sale of its Contribution alone or when
+   combined with the Program.
+
+   “Program” means the Contributions Distributed in accordance with this
+   Agreement.
+
+   “Recipient” means anyone who receives the Program under this Agreement or
+   any Secondary License (as applicable), including Contributors.
+
+   “Derivative Works” shall mean any work, whether in Source Code or other
+   form, that is based on (or derived from) the Program and for which the
+   editorial revisions, annotations, elaborations, or other modifications
+   represent, as a whole, an original work of authorship.
+
+   “Modified Works” shall mean any work in Source Code or other form that
+   results from an addition to, deletion from, or modification of the contents
+   of the Program, including, for purposes of clarity any new file in Source
+   Code form that contains any contents of the Program. Modified Works shall
+   not include works that contain only declarations, interfaces, types,
+   classes, structures, or files of the Program solely in each case in order
+   to link to, bind by name, or subclass the Program or Modified Works
+   thereof.
+
+   “Distribute” means the acts of a) distributing or b) making available in
+   any manner that enables the transfer of a copy.
+
+   “Source Code” means the form of a Program preferred for making
+   modifications, including but not limited to software source code,
+   documentation source, and configuration files.
+
+   “Secondary License” means either the GNU General Public License, Version
+   2.0, or any later versions of that license, including any exceptions or
+   additional permissions as identified by the initial Contributor.
+
+2. GRANT OF RIGHTS
+
+   a) Subject to the terms of this Agreement, each Contributor hereby grants
+   Recipient a non-exclusive, worldwide, royalty-free copyright license to
+   reproduce, prepare Derivative Works of, publicly display, publicly perform,
+   Distribute and sublicense the Contribution of such Contributor, if any, and
+   such Derivative Works.
+
+   b) Subject to the terms of this Agreement, each Contributor hereby grants
+   Recipient a non-exclusive, worldwide, royalty-free patent license under
+   Licensed Patents to make, use, sell, offer to sell, import and otherwise
+   transfer the Contribution of such Contributor, if any, in Source Code or
+   other form. This patent license shall apply to the combination of the
+   Contribution and the Program if, at the time the Contribution is added by
+   the Contributor, such addition of the Contribution causes such combination
+   to be covered by the Licensed Patents. The patent license shall not apply
+   to any other combinations which include the Contribution. No hardware per
+   se is licensed hereunder.
+
+   c) Recipient understands that although each Contributor grants the licenses
+   to its Contributions set forth herein, no assurances are provided by any
+   Contributor that the Program does not infringe the patent or other
+   intellectual property rights of any other entity. Each Contributor
+   disclaims any liability to Recipient for claims brought by any other entity
+   based on infringement of intellectual property rights or otherwise. As a
+   condition to exercising the rights and licenses granted hereunder, each
+   Recipient hereby assumes sole responsibility to secure any other
+   intellectual property rights needed, if any. For example, if a third party
+   patent license is required to allow Recipient to Distribute the Program, it
+   is Recipient's responsibility to acquire that license before distributing
+   the Program.
+
+   d) Each Contributor represents that to its knowledge it has sufficient
+   copyright rights in its Contribution, if any, to grant the copyright
+   license set forth in this Agreement.
+
+   e) Notwithstanding the terms of any Secondary License, no Contributor makes
+   additional grants to any Recipient (other than those set forth in this
+   Agreement) as a result of such Recipient's receipt of the Program under the
+   terms of a Secondary License (if permitted under the terms of Section 3).
+
+3. REQUIREMENTS
+
+3.1 If a Contributor Distributes the Program in any form, then:
+
+   a) the Program must also be made available as Source Code, in accordance
+   with section 3.2, and the Contributor must accompany the Program with a
+   statement that the Source Code for the Program is available under this
+   Agreement, and informs Recipients how to obtain it in a reasonable manner
+   on or through a medium customarily used for software exchange; and
+
+   b) the Contributor may Distribute the Program under a license different
+   than this Agreement, provided that such license:
+
+      i) effectively disclaims on behalf of all other Contributors all
+      warranties and conditions, express and implied, including warranties or
+      conditions of title and non-infringement, and implied warranties or
+      conditions of merchantability and fitness for a particular purpose;
+
+      ii) effectively excludes on behalf of all other Contributors all
+      liability for damages, including direct, indirect, special, incidental
+      and consequential damages, such as lost profits;
+
+      iii) does not attempt to limit or alter the recipients' rights in the
+      Source Code under section 3.2; and
+
+      iv) requires any subsequent distribution of the Program by any party to
+      be under a license that satisfies the requirements of this section 3.
+
+3.2 When the Program is Distributed as Source Code:
+
+    a) it must be made available under this Agreement, or if the Program (i)
+    is combined with other material in a separate file or files made available
+    under a Secondary License, and (ii) the initial Contributor attached to
+    the Source Code the notice described in Exhibit A of this Agreement, then
+    the Program may be made available under the terms of such Secondary
+    Licenses, and
+
+    b) a copy of this Agreement must be included with each copy of the
+    Program.
+
+3.3 Contributors may not remove or alter any copyright, patent, trademark,
+attribution notices, disclaimers of warranty, or limitations of liability
+(‘notices’) contained within the Program from any copy of the Program which
+they Distribute, provided that Contributors may add their own appropriate
+notices.
+
+4. COMMERCIAL DISTRIBUTION
+
+Commercial distributors of software may accept certain responsibilities with
+respect to end users, business partners and the like. While this license is
+intended to facilitate the commercial use of the Program, the Contributor who
+includes the Program in a commercial product offering should do so in a manner
+which does not create potential liability for other Contributors. Therefore,
+if a Contributor includes the Program in a commercial product offering, such
+Contributor (“Commercial Contributor”) hereby agrees to defend and indemnify
+every other Contributor (“Indemnified Contributor”) against any losses,
+damages and costs (collectively “Losses”) arising from claims, lawsuits and
+other legal actions brought by a third party against the Indemnified
+Contributor to the extent caused by the acts or omissions of such Commercial
+Contributor in connection with its distribution of the Program in a commercial
+product offering. The obligations in this section do not apply to any claims
+or Losses relating to any actual or alleged intellectual property
+infringement. In order to qualify, an Indemnified Contributor must: a)
+promptly notify the Commercial Contributor in writing of such claim, and b)
+allow the Commercial Contributor to control, and cooperate with the Commercial
+Contributor in, the defense and any related settlement negotiations. The
+Indemnified Contributor may participate in any such claim at its own expense.
+
+For example, a Contributor might include the Program in a commercial product
+offering, Product X. That Contributor is then a Commercial Contributor. If
+that Commercial Contributor then makes performance claims, or offers
+warranties related to Product X, those performance claims and warranties are
+such Commercial Contributor's responsibility alone. Under this section, the
+Commercial Contributor would have to defend claims against the other
+Contributors related to those performance claims and warranties, and if a
+court requires any other Contributor to pay any damages as a result, the
+Commercial Contributor must pay those damages.
+
+5. NO WARRANTY
+
+EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, AND TO THE EXTENT PERMITTED
+BY APPLICABLE LAW, THE PROGRAM IS PROVIDED ON AN “AS IS” BASIS, WITHOUT
+WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED INCLUDING,
+WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT,
+MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Each Recipient is solely
+responsible for determining the appropriateness of using and distributing the
+Program and assumes all risks associated with its exercise of rights under
+this Agreement, including but not limited to the risks and costs of program
+errors, compliance with applicable laws, damage to or loss of data, programs
+or equipment, and unavailability or interruption of operations.
+
+6. DISCLAIMER OF LIABILITY
+
+EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, AND TO THE EXTENT PERMITTED
+BY APPLICABLE LAW, NEITHER RECIPIENT NOR ANY CONTRIBUTORS SHALL HAVE ANY
+LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OR DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED
+HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+7. GENERAL
+
+If any provision of this Agreement is invalid or unenforceable under
+applicable law, it shall not affect the validity or enforceability of the
+remainder of the terms of this Agreement, and without further action by the
+parties hereto, such provision shall be reformed to the minimum extent
+necessary to make such provision valid and enforceable.
+
+If Recipient institutes patent litigation against any entity (including a
+cross-claim or counterclaim in a lawsuit) alleging that the Program itself
+(excluding combinations of the Program with other software or hardware)
+infringes such Recipient's patent(s), then such Recipient's rights granted
+under Section 2(b) shall terminate as of the date such litigation is filed.
+
+All Recipient's rights under this Agreement shall terminate if it fails to
+comply with any of the material terms or conditions of this Agreement and does
+not cure such failure in a reasonable period of time after becoming aware of
+such noncompliance. If all Recipient's rights under this Agreement terminate,
+Recipient agrees to cease use and distribution of the Program as soon as
+reasonably practicable. However, Recipient's obligations under this Agreement
+and any licenses granted by Recipient relating to the Program shall continue
+and survive.
+
+Everyone is permitted to copy and distribute copies of this Agreement, but in
+order to avoid inconsistency the Agreement is copyrighted and may only be
+modified in the following manner. The Agreement Steward reserves the right to
+publish new versions (including revisions) of this Agreement from time to
+time. No one other than the Agreement Steward has the right to modify this
+Agreement. The Eclipse Foundation is the initial Agreement Steward. The
+Eclipse Foundation may assign the responsibility to serve as the Agreement
+Steward to a suitable separate entity. Each new version of the Agreement will
+be given a distinguishing version number. The Program (including
+Contributions) may always be Distributed subject to the version of the
+Agreement under which it was received. In addition, after a new version of the
+Agreement is published, Contributor may elect to Distribute the Program
+(including its Contributions) under the new version.
+
+Except as expressly stated in Sections 2(a) and 2(b) above, Recipient receives
+no rights or licenses to the intellectual property of any Contributor under
+this Agreement, whether expressly, by implication, estoppel or otherwise. All
+rights in the Program not expressly granted under this Agreement are reserved.
+Nothing in this Agreement is intended to be enforceable by any entity that is
+not a Contributor or Recipient. No third-party beneficiary rights are created
+under this Agreement.

data/README.md

@@ -0,0 +1,105 @@
+# Cbc Ruby
+
+[Cbc](https://github.com/coin-or/Cbc) - the mixed-integer programming solver - for Ruby
+
+[![Build Status](https://github.com/ankane/cbc-ruby/workflows/build/badge.svg?branch=master)](https://github.com/ankane/cbc-ruby/actions)
+
+## Installation
+
+First, install Cbc. For Homebrew, use:
+
+```sh
+brew install cbc
+```
+
+And for Ubuntu, use:
+
+```sh
+sudo apt-get install coinor-libcbc3
+```
+
+Then add this line to your application’s Gemfile:
+
+```ruby
+gem "cbc"
+```
+
+## Getting Started
+
+*The API is fairly low-level at the moment*
+
+Load a problem
+
+```ruby
+model =
+  Cbc.load_problem(
+    sense: :minimize,
+    start: [0, 3, 6],
+    index: [0, 1, 2, 0, 1, 2],
+    value: [2, 3, 2, 2, 4, 1],
+    col_lower: [0, 0],
+    col_upper: [1e30, 1e30],
+    obj: [8, 10],
+    row_lower: [7, 12, 6],
+    row_upper: [1e30, 1e30, 1e30],
+    col_type: [:integer, :continuous]
+  )
+```
+
+Solve
+
+```ruby
+model.solve
+```
+
+Write the problem to an LP or MPS file (LP requires Cbc 2.10.0+)
+
+```ruby
+model.write_lp("hello.lp")
+# or
+model.write_mps("hello") # adds mps.gz
+```
+
+Read a problem from an LP or MPS file (LP requires Cbc 2.10.0+)
+
+```ruby
+model = Cbc.read_lp("hello.lp")
+# or
+model = Cbc.read_mps("hello.mps.gz")
+```
+
+## Reference
+
+Set the log level (requires Cbc 2.10.0+)
+
+```ruby
+model.solve(log_level: 1) # 0 = off, 3 = max
+```
+
+Set the time limit in seconds (requires Cbc 2.10.0+)
+
+```ruby
+model.solve(time_limit: 30)
+```
+
+## History
+
+View the [changelog](https://github.com/ankane/cbc-ruby/blob/master/CHANGELOG.md)
+
+## Contributing
+
+Everyone is encouraged to help improve this project. Here are a few ways you can help:
+
+- [Report bugs](https://github.com/ankane/cbc-ruby/issues)
+- Fix bugs and [submit pull requests](https://github.com/ankane/cbc-ruby/pulls)
+- Write, clarify, or fix documentation
+- Suggest or add new features
+
+To get started with development:
+
+```sh
+git clone https://github.com/ankane/cbc-ruby.git
+cd cbc-ruby
+bundle install
+bundle exec rake test
+```

data/lib/cbc/ffi.rb

@@ -0,0 +1,83 @@
+module Cbc
+  module FFI
+    extend Fiddle::Importer
+
+    libs = Array(Cbc.ffi_lib).dup
+    begin
+      dlload Fiddle.dlopen(libs.shift)
+    rescue Fiddle::DLError => e
+      retry if libs.any?
+      raise e
+    end
+
+    # https://github.com/coin-or/Cbc/blob/releases/2.9.9/Cbc/src/Cbc_C_Interface.h
+
+    OBJ_SENSE = {
+      minimize: 1,
+      ignore: 0,
+      maximize: -1
+    }
+
+    STATUS = {
+      -1 => :not_started,
+      0 => :finished,
+      1 => :stopped,
+      2 => :abandoned,
+      5 => :interrupted
+    }
+
+    SECONDARY_STATUS = {
+      -1 => :unset,
+      0 => :completed,
+      1 => :infeasible,
+      2 => :stopped_gap,
+      3 => :stopped_nodes,
+      4 => :stopped_time,
+      5 => :stopped_user,
+      6 => :stopped_solutions,
+      7 => :unbounded,
+      8 => :stopped_iterations
+    }
+
+    typealias "CoinBigIndex", "int"
+
+    # version info
+    extern "char * Cbc_getVersion(void)"
+
+    # load models
+    extern "Cbc_Model * Cbc_newModel(void)"
+    extern "void Cbc_loadProblem(Cbc_Model *model, int numcols, int numrows, CoinBigIndex *start, int *index, double *value, double *collb, double *colub, double *obj, double *rowlb, double *rowub)"
+    extern "void Cbc_setObjSense(Cbc_Model *model, double sense)"
+    extern "int Cbc_isInteger(Cbc_Model * model, int i)"
+    extern "void Cbc_setContinuous(Cbc_Model *model, int iColumn)"
+    extern "void Cbc_setInteger(Cbc_Model *model, int iColumn)"
+    extern "void Cbc_deleteModel(Cbc_Model *model)"
+
+    # read and write
+    extern "int Cbc_readMps(Cbc_Model *model, char *filename)"
+    extern "void Cbc_writeMps(Cbc_Model *model, char *filename)"
+
+    # solve
+    extern "int Cbc_getNumCols(Cbc_Model *model)"
+    extern "int Cbc_getNumRows(Cbc_Model *model)"
+    extern "int Cbc_solve(Cbc_Model *model)"
+    extern "double * Cbc_getColSolution(Cbc_Model *model)"
+    extern "int Cbc_isAbandoned(Cbc_Model *model)"
+    extern "int Cbc_isProvenOptimal(Cbc_Model *model)"
+    extern "int Cbc_isProvenInfeasible(Cbc_Model *model)"
+    extern "int Cbc_isContinuousUnbounded(Cbc_Model *model)"
+    extern "double Cbc_getObjValue(Cbc_Model *model)"
+    extern "int Cbc_status(Cbc_Model *model)"
+    extern "int Cbc_secondaryStatus(Cbc_Model *model)"
+
+    if Gem::Version.new(FFI.Cbc_getVersion.to_s) >= Gem::Version.new("2.10.0")
+      extern "int Cbc_readLp(Cbc_Model *model, char *filename)"
+      extern "void Cbc_writeLp(Cbc_Model *model, char *filename)"
+
+      extern "double Cbc_getMaximumSeconds(Cbc_Model *model)"
+      extern "void Cbc_setMaximumSeconds(Cbc_Model *model, double maxSeconds)"
+      extern "int Cbc_getLogLevel(Cbc_Model *model)"
+      extern "void Cbc_setLogLevel(Cbc_Model *model, int logLevel)"
+    end
+  end
+end

data/lib/cbc/model.rb

@@ -0,0 +1,154 @@
+module Cbc
+  class Model
+    def initialize
+      @model = FFI.Cbc_newModel
+      ObjectSpace.define_finalizer(self, self.class.finalize(@model))
+
+      @below210 = Gem::Version.new(Cbc.lib_version) < Gem::Version.new("2.10.0")
+      FFI.Cbc_setLogLevel(model, 0) unless @below210
+    end
+
+    def load_problem(sense:, start:, index:, value:, col_lower:, col_upper:, obj:, row_lower:, row_upper:, col_type:)
+      start_size = start.size
+      index_size = index.size
+      num_cols = col_lower.size
+      num_rows = row_lower.size
+
+      FFI.Cbc_loadProblem(
+        model, num_cols, num_rows,
+        big_index_array(start, start_size), int_array(index, index_size), double_array(value, index_size),
+        double_array(col_lower, num_cols), double_array(col_upper, num_cols), double_array(obj, num_cols),
+        double_array(row_lower, num_rows), double_array(row_upper, num_rows)
+      )
+      FFI.Cbc_setObjSense(model, FFI::OBJ_SENSE.fetch(sense))
+
+      if col_type.size != num_cols
+        raise ArgumentError, "wrong size (given #{value.size}, expected #{size})"
+      end
+
+      col_type.each_with_index do |v, i|
+        case v
+        when :integer
+          FFI.Cbc_setInteger(model, i)
+        when :continuous
+          FFI.Cbc_setContinuous(model, i)
+        else
+          raise ArgumentError, "Unknown col_type"
+        end
+      end
+    end
+
+    def read_lp(filename)
+      check_version
+      check_status FFI.Cbc_readLp(model, filename)
+    end
+
+    def read_mps(filename)
+      check_status FFI.Cbc_readMps(model, filename)
+    end
+
+    def write_lp(filename)
+      check_version
+      FFI.Cbc_writeLp(model, filename)
+    end
+
+    def write_mps(filename)
+      FFI.Cbc_writeMps(model, filename)
+    end
+
+    def solve(log_level: nil, time_limit: nil)
+      with_options(log_level: log_level, time_limit: time_limit) do
+        # do not check status
+        FFI.Cbc_solve(model)
+      end
+
+      num_cols = FFI.Cbc_getNumCols(model)
+
+      status = FFI::STATUS[FFI.Cbc_status(model)]
+      secondary_status = FFI::SECONDARY_STATUS[FFI.Cbc_secondaryStatus(model)]
+
+      ret_status =
+        case status
+        when :not_started, :finished
+          if FFI.Cbc_isProvenOptimal(model)
+            :optimal
+          elsif FFI.Cbc_isProvenInfeasible(model)
+            :infeasible
+          else
+            secondary_status
+          end
+        else
+          secondary_status
+        end
+
+      {
+        status: ret_status,
+        objective: FFI.Cbc_getObjValue(model),
+        primal_col: read_double_array(FFI.Cbc_getColSolution(model), num_cols)
+      }
+    end
+
+    def self.finalize(model)
+      # must use proc instead of stabby lambda
+      proc { FFI.Cbc_deleteModel(model) }
+    end
+
+    private
+
+    def model
+      @model
+    end
+
+    def check_status(status)
+      if status != 0
+        raise Error, "Bad status: #{status}"
+      end
+    end
+
+    def check_version
+      if @below210
+        raise Error, "This feature requires Cbc 2.10.0+"
+      end
+    end
+
+    def double_array(value, size)
+      base_array(value, size, "d")
+    end
+
+    def int_array(value, size)
+      base_array(value, size, "i!")
+    end
+    alias_method :big_index_array, :int_array
+
+    def base_array(value, size, format)
+      if value.size != size
+        # TODO add variable name to message
+        raise ArgumentError, "wrong size (given #{value.size}, expected #{size})"
+      end
+      Fiddle::Pointer[value.pack("#{format}#{size}")]
+    end
+
+    def read_double_array(ptr, size)
+      ptr[0, size * Fiddle::SIZEOF_DOUBLE].unpack("d#{size}")
+    end
+
+    def with_options(log_level:, time_limit:)
+      if log_level
+        check_version
+        previous_log_level = FFI.Cbc_getLogLevel(model)
+        FFI.Cbc_setLogLevel(model, log_level)
+      end
+
+      if time_limit
+        check_version
+        previous_time_limit = FFI.Cbc_getMaximumSeconds(model)
+        FFI.Cbc_setMaximumSeconds(model, time_limit)
+      end
+
+      yield
+    ensure
+      FFI.Cbc_setLogLevel(model, previous_log_level) if previous_log_level
+      FFI.Cbc_setMaximumSeconds(model, previous_time_limit) if previous_time_limit
+    end
+  end
+end

data/lib/cbc/version.rb

@@ -0,0 +1,3 @@
+module Cbc
+  VERSION = "0.1.0"
+end

data/lib/cbc.rb

@@ -0,0 +1,51 @@
+# stdlib
+require "fiddle/import"
+
+# modules
+require "cbc/model"
+require "cbc/version"
+
+module Cbc
+  class Error < StandardError; end
+
+  class << self
+    attr_accessor :ffi_lib
+  end
+  lib_name =
+    if Gem.win_platform?
+      # TODO test
+      ["CbcSolver.dll"]
+    elsif RbConfig::CONFIG["host_os"] =~ /darwin/i
+      ["libCbcSolver.dylib"]
+    else
+      # coinor-libcbc-dev has libCbcSolver.so
+      # coinor-libcbc3 has libCbcSolver.so.3
+      ["libCbcSolver.so", "libCbcSolver.so.3"]
+    end
+  self.ffi_lib = lib_name
+
+  # friendlier error message
+  autoload :FFI, "cbc/ffi"
+
+  def self.lib_version
+    FFI.Cbc_getVersion.to_s
+  end
+
+  def self.read_lp(filename)
+    model = Model.new
+    model.read_lp(filename)
+    model
+  end
+
+  def self.read_mps(filename)
+    model = Model.new
+    model.read_mps(filename)
+    model
+  end
+
+  def self.load_problem(**options)
+    model = Model.new
+    model.load_problem(**options)
+    model
+  end
+end

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification
+name: cbc
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Andrew Kane
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2022-04-14 00:00:00.000000000 Z
+dependencies: []
+description:
+email: andrew@ankane.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- lib/cbc.rb
+- lib/cbc/ffi.rb
+- lib/cbc/model.rb
+- lib/cbc/version.rb
+homepage: https://github.com/ankane/cbc-ruby
+licenses:
+- EPL-2.0
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.7
+signing_key:
+specification_version: 4
+summary: Mixed-integer programming for Ruby
+test_files: []