lpsolver 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9ff84f9d0bcf181ac202f5f25cf5754e04319e1bf459ab830af40f8e91c42bc7
-  data.tar.gz: f51148b23deca2cd3070726c78fc505d07bc3d9c3594e386cfbba4048e68187c
+  metadata.gz: a24185adf2e045f36f5249e311b5d357ca16134ab259c4f350fddbe07e141d9c
+  data.tar.gz: 9fb91dbea34b972e32876b97b4719ef771b30b8975d9ec5bf7494a4d7d49b2d7
 SHA512:
-  metadata.gz: 827cfb4a818544a8a90a47231ec46de845b973c4522f4e3496ce9c85d4b55f01fd9cfed0eaf206d93757db09208e61047b8106519b38285ce789940518cb8e11
-  data.tar.gz: 253710d8517bbbc6fd817cb15ad630b8d9949c89ea08f6c3a9b0f71d08e1abf627b2739ceca7f133904ddc310a5925073475a2cfdfcaac0c921db782cfa49820
+  metadata.gz: b64322ff1240d58b92345ce8e9fff552dceeada28d57066fc56a94c02a89f66debaeeb1ccc3e37fbb434fe6619b828f91f536a5f8abc323d2792c8f8da37e4c9
+  data.tar.gz: fe8f3fba95166b9608837886d84b81adfa4d9b1416864c3607a5f194d9aaa679d36af36389ec1e6db4dc239e7d64417bd9b985a3a1a300c3c35f75597a950988

data/Gemfile

@@ -7,6 +7,7 @@ gemspec
 
 # Specify development dependencies here and not in the gemspec
 gem 'rake'
+gem 'rake-compiler'
 gem 'rspec'
 gem 'rubocop'
 gem 'rubocop-rake'

data/README.md

@@ -109,30 +109,7 @@ Or run directly from source:
 ruby -Ilib examples/coin_purse.rb
 ```
 
-## Prerequisites
-
-HiGHS must be installed:
-
-```bash
-# Ubuntu/Debian
-sudo apt install highs
-
-# macOS
-brew install highs
-
-# Or from source
-git clone https://github.com/ERGO-Code/HiGHS.git
-cd HiGHS && mkdir build && cd build
-cmake .. -DCMAKE_BUILD_TYPE=Release
-make -j$(nproc)
-sudo make install
-```
-
-Or set a custom path:
-
-```bash
-export HIGHS_PATH=/path/to/highs
-```
+> **HiGHS is bundled automatically.** The `rake compile` task (run during `bundle install` or `rake`) downloads the HiGHS v1.14.0 precompiled static library from GitHub and links it into the gem. No system-level HiGHS installation is required — it ships with the gem.
 
 ## Usage
 
@@ -159,6 +136,28 @@ solution = model.minimize!(x * 3 + y * 5)
 puts "Cost: $#{solution.objective_value}"
 puts "x = #{solution[:x]}"
 puts "y = #{solution[:y]}"
+
+# Extract all variable values
+puts solution.all_variables  # => { :x => 0.0, :y => 100.0 }
+puts solution.to_h           # => { :x => 0.0, :y => 100.0 }
+
+# Iterate over all variables
+solution.each_variable { |name, value| puts "#{name} = #{value}" }
+
+# Check if a variable exists
+puts solution.has_variable?(:x)  # => true
+puts solution.has_variable?(:z)  # => false
+
+# Access by Variable object directly
+puts solution[x]  # => 0.0
+puts solution[y]  # => 100.0
+
+# Get values for multiple variables
+puts solution.values_at(:x, :y)      # => [0.0, 100.0]
+puts solution.values_at(x, y)        # => [0.0, 100.0]
+
+# List all variables defined in the model
+model.variables.each { |name, var| puts "#{name} => #{var}" }
 ```
 
 ### Integer (MIP) Example
@@ -304,10 +303,55 @@ Writes the model to an LP file.
 Solves the model without setting an objective (legacy).
 
 ### `Solution#[]`
-Get a variable's value: `solution[:x]`
+Get a variable's value. Accepts Symbol, String, or Variable object.
+
+```ruby
+solution[:x]        # => 4.0 (by symbol)
+solution['x']       # => 4.0 (by string)
+solution[x]         # => 4.0 (by Variable object)
+```
 
 ### `Solution#values_at(*names)`
-Get multiple values: `solution.values_at(:x, :y)`
+Get multiple values. Accepts Symbol, String, or Variable objects.
+
+```ruby
+solution.values_at(:x, :y)      # => [4.0, 0.0]
+solution.values_at(x, y)        # => [4.0, 0.0]
+solution.values_at(:x, y, 'z')  # => [4.0, 0.0, 3.0]
+```
+
+### `Solution#all_variables`
+Returns all variables as a Symbol-keyed Hash.
+
+```ruby
+solution.all_variables  # => { :x => 4.0, :y => 0.0 }
+```
+
+### `Solution#to_h`
+Alias for `all_variables`. Returns a plain Hash.
+
+### `Solution#each_variable { |name, value| ... }`
+Iterate over all variables and their values.
+
+```ruby
+solution.each_variable { |name, value| puts "#{name} = #{value}" }
+```
+
+### `Solution#has_variable?(name)`
+Check if a variable exists in the solution. Accepts Symbol, String, or Variable.
+
+```ruby
+solution.has_variable?(:x)  # => true
+solution.has_variable?(:z)  # => false
+```
+
+### `Model#variables`
+Returns all defined variables as a Hash mapping names to Variable objects.
+
+```ruby
+model.variables  # => { :x => @x(0), :y => @y(1) }
+model.variables.each { |name, var| puts "#{name} => #{var}" }
+```
 
 ### `Solution#objective_value`
 The optimal (best) objective value.

data/ext/lpsolver/Makefile

@@ -0,0 +1,273 @@
+
+SHELL = /bin/sh
+
+# V=0 quiet, V=1 verbose.  other values don't work.
+V = 0
+V0 = $(V:0=)
+Q1 = $(V:1=)
+Q = $(Q1:0=@)
+ECHO1 = $(V:1=@ :)
+ECHO = $(ECHO1:0=@ echo)
+NULLCMD = :
+
+#### Start of system configuration section. ####
+
+srcdir = .
+topdir = /usr/local/include/ruby-3.4.0
+hdrdir = $(topdir)
+arch_hdrdir = /usr/local/include/ruby-3.4.0/x86_64-linux
+PATH_SEPARATOR = :
+VPATH = $(srcdir):$(arch_hdrdir)/ruby:$(hdrdir)/ruby
+prefix = $(DESTDIR)/usr/local
+rubysitearchprefix = $(rubylibprefix)/$(sitearch)
+rubyarchprefix = $(rubylibprefix)/$(arch)
+rubylibprefix = $(libdir)/$(RUBY_BASE_NAME)
+exec_prefix = $(prefix)
+vendorarchhdrdir = $(vendorhdrdir)/$(sitearch)
+sitearchhdrdir = $(sitehdrdir)/$(sitearch)
+rubyarchhdrdir = $(rubyhdrdir)/$(arch)
+vendorhdrdir = $(rubyhdrdir)/vendor_ruby
+sitehdrdir = $(rubyhdrdir)/site_ruby
+rubyhdrdir = $(includedir)/$(RUBY_VERSION_NAME)
+vendorarchdir = $(vendorlibdir)/$(sitearch)
+vendorlibdir = $(vendordir)/$(ruby_version)
+vendordir = $(rubylibprefix)/vendor_ruby
+sitearchdir = $(sitelibdir)/$(sitearch)
+sitelibdir = $(sitedir)/$(ruby_version)
+sitedir = $(rubylibprefix)/site_ruby
+rubyarchdir = $(rubylibdir)/$(arch)
+rubylibdir = $(rubylibprefix)/$(ruby_version)
+sitearchincludedir = $(includedir)/$(sitearch)
+archincludedir = $(includedir)/$(arch)
+sitearchlibdir = $(libdir)/$(sitearch)
+archlibdir = $(libdir)/$(arch)
+ridir = $(datarootdir)/$(RI_BASE_NAME)
+modular_gc_dir = $(DESTDIR)
+mandir = $(datarootdir)/man
+localedir = $(datarootdir)/locale
+libdir = $(exec_prefix)/lib
+psdir = $(docdir)
+pdfdir = $(docdir)
+dvidir = $(docdir)
+htmldir = $(docdir)
+infodir = $(datarootdir)/info
+docdir = $(datarootdir)/doc/$(PACKAGE)
+oldincludedir = $(DESTDIR)/usr/include
+includedir = $(prefix)/include
+runstatedir = $(localstatedir)/run
+localstatedir = $(prefix)/var
+sharedstatedir = $(prefix)/com
+sysconfdir = $(prefix)/etc
+datadir = $(datarootdir)
+datarootdir = $(prefix)/share
+libexecdir = $(exec_prefix)/libexec
+sbindir = $(exec_prefix)/sbin
+bindir = $(exec_prefix)/bin
+archdir = $(rubyarchdir)
+
+
+CC_WRAPPER = 
+CC = gcc
+CXX = g++
+LIBRUBY = $(LIBRUBY_SO)
+LIBRUBY_A = lib$(RUBY_SO_NAME)-static.a
+LIBRUBYARG_SHARED = -Wl,-rpath,$(libdir) -L$(libdir) -l$(RUBY_SO_NAME)
+LIBRUBYARG_STATIC = -Wl,-rpath,$(libdir) -L$(libdir) -l$(RUBY_SO_NAME)-static $(MAINLIBS)
+empty =
+OUTFLAG = -o $(empty)
+COUTFLAG = -o $(empty)
+CSRCFLAG = $(empty)
+
+RUBY_EXTCONF_H = 
+cflags   = $(hardenflags)  $(optflags) $(debugflags) $(warnflags)
+cxxflags = 
+optflags = -O3 -fno-fast-math
+debugflags = -ggdb3
+warnflags = -Wall -Wextra -Wdeprecated-declarations -Wdiv-by-zero -Wduplicated-cond -Wimplicit-function-declaration -Wimplicit-int -Wpointer-arith -Wwrite-strings -Wold-style-definition -Wimplicit-fallthrough=0 -Wmissing-noreturn -Wno-cast-function-type -Wno-constant-logical-operand -Wno-long-long -Wno-missing-field-initializers -Wno-overlength-strings -Wno-packed-bitfield-compat -Wno-parentheses-equality -Wno-self-assign -Wno-tautological-compare -Wno-unused-parameter -Wno-unused-value -Wsuggest-attribute=format -Wsuggest-attribute=noreturn -Wunused-variable -Wmisleading-indentation -Wundef
+cppflags = 
+CCDLFLAGS = -fPIC
+CFLAGS   = $(CCDLFLAGS) $(cflags)  -fPIC $(ARCH_FLAG)
+INCFLAGS = -I. -I$(arch_hdrdir) -I$(hdrdir)/ruby/backward -I$(hdrdir) -I$(srcdir) -I/home/david/programs/ai/pi/workspace/lpsolver/ext/lpsolver-highs/highs -I/home/david/programs/ai/pi/workspace/lpsolver/ext/lpsolver-highs/build/include/highs
+DEFS     = 
+CPPFLAGS =   $(DEFS) $(cppflags)
+CXXFLAGS = $(CCDLFLAGS)  $(ARCH_FLAG)
+ldflags  = -L. -fstack-protector-strong -rdynamic -Wl,-export-dynamic -Wl,--no-as-needed -L/home/david/programs/ai/pi/workspace/lpsolver/ext/lpsolver-highs/build/lib -Wl,-rpath,/home/david/programs/ai/pi/workspace/lpsolver/ext/lpsolver-highs/build/lib
+dldflags = -Wl,--compress-debug-sections=zlib 
+ARCH_FLAG = 
+DLDFLAGS = $(ldflags) $(dldflags) $(ARCH_FLAG)
+LDSHARED = $(CC) -shared
+LDSHAREDXX = $(CXX) -shared
+POSTLINK = :
+AR = gcc-ar
+LD = ld
+EXEEXT = 
+
+RUBY_INSTALL_NAME = $(RUBY_BASE_NAME)
+RUBY_SO_NAME = ruby
+RUBYW_INSTALL_NAME = 
+RUBY_VERSION_NAME = $(RUBY_BASE_NAME)-$(ruby_version)
+RUBYW_BASE_NAME = rubyw
+RUBY_BASE_NAME = ruby
+
+arch = x86_64-linux
+sitearch = $(arch)
+ruby_version = 3.4.0
+ruby = $(bindir)/$(RUBY_BASE_NAME)
+RUBY = $(ruby)
+BUILTRUBY = $(bindir)/$(RUBY_BASE_NAME)
+ruby_headers = $(hdrdir)/ruby.h $(hdrdir)/ruby/backward.h $(hdrdir)/ruby/ruby.h $(hdrdir)/ruby/defines.h $(hdrdir)/ruby/missing.h $(hdrdir)/ruby/intern.h $(hdrdir)/ruby/st.h $(hdrdir)/ruby/subst.h $(arch_hdrdir)/ruby/config.h
+
+RM = rm -f
+RM_RF = rm -fr
+RMDIRS = rmdir --ignore-fail-on-non-empty -p
+MAKEDIRS = /usr/bin/mkdir -p
+INSTALL = /usr/bin/install -c
+INSTALL_PROG = $(INSTALL) -m 0755
+INSTALL_DATA = $(INSTALL) -m 644
+COPY = cp
+TOUCH = exit >
+
+#### End of system configuration section. ####
+
+preload = 
+libpath = . $(libdir)
+LIBPATH = -L. -L$(libdir) -Wl,-rpath,$(libdir)
+DEFFILE = 
+
+CLEANFILES = mkmf.log
+DISTCLEANFILES = 
+DISTCLEANDIRS = 
+
+extout = 
+extout_prefix = 
+target_prefix = /lpsolver
+LOCAL_LIBS = 
+LIBS = $(LIBRUBYARG_SHARED)  -lm -lpthread  -lc -lhighs -lstdc++
+ORIG_SRCS = ext.c
+SRCS = $(ORIG_SRCS) 
+OBJS = ext.o
+HDRS = 
+LOCAL_HDRS = 
+TARGET = native
+TARGET_NAME = native
+TARGET_ENTRY = Init_$(TARGET_NAME)
+DLLIB = $(TARGET).so
+EXTSTATIC = 
+STATIC_LIB = 
+
+TIMESTAMP_DIR = .
+BINDIR        = $(bindir)
+RUBYCOMMONDIR = $(sitedir)$(target_prefix)
+RUBYLIBDIR    = $(sitelibdir)$(target_prefix)
+RUBYARCHDIR   = $(sitearchdir)$(target_prefix)
+HDRDIR        = $(sitehdrdir)$(target_prefix)
+ARCHHDRDIR    = $(sitearchhdrdir)$(target_prefix)
+TARGET_SO_DIR =
+TARGET_SO     = $(TARGET_SO_DIR)$(DLLIB)
+CLEANLIBS     = $(TARGET_SO) false
+CLEANOBJS     = $(OBJS) *.bak
+TARGET_SO_DIR_TIMESTAMP = $(TIMESTAMP_DIR)/.sitearchdir.-.lpsolver.time
+
+all:    $(DLLIB)
+static: $(STATIC_LIB)
+.PHONY: all install static install-so install-rb
+.PHONY: clean clean-so clean-static clean-rb
+
+clean-static::
+clean-rb-default::
+clean-rb::
+clean-so::
+clean: clean-so clean-static clean-rb-default clean-rb
+		-$(Q)$(RM_RF) $(CLEANLIBS) $(CLEANOBJS) $(CLEANFILES) .*.time
+
+distclean-rb-default::
+distclean-rb::
+distclean-so::
+distclean-static::
+distclean: clean distclean-so distclean-static distclean-rb-default distclean-rb
+		-$(Q)$(RM) Makefile $(RUBY_EXTCONF_H) conftest.* mkmf.log
+		-$(Q)$(RM) core ruby$(EXEEXT) *~ $(DISTCLEANFILES)
+		-$(Q)$(RMDIRS) $(DISTCLEANDIRS) 2> /dev/null || true
+
+realclean: distclean
+install: install-so install-rb
+
+install-so: $(DLLIB) $(TARGET_SO_DIR_TIMESTAMP)
+	$(INSTALL_PROG) $(DLLIB) $(RUBYARCHDIR)
+clean-static::
+	-$(Q)$(RM) $(STATIC_LIB)
+install-rb: pre-install-rb do-install-rb install-rb-default
+install-rb-default: pre-install-rb-default do-install-rb-default
+pre-install-rb: Makefile
+pre-install-rb-default: Makefile
+do-install-rb:
+do-install-rb-default:
+pre-install-rb-default:
+	@$(NULLCMD)
+$(TARGET_SO_DIR_TIMESTAMP):
+	$(Q) $(MAKEDIRS) $(@D) $(RUBYARCHDIR)
+	$(Q) $(TOUCH) $@
+
+site-install: site-install-so site-install-rb
+site-install-so: install-so
+site-install-rb: install-rb
+
+.SUFFIXES: .c .m .cc .mm .cxx .cpp .o .S
+
+.cc.o:
+	$(ECHO) compiling $(<)
+	$(Q) $(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(COUTFLAG)$@ -c $(CSRCFLAG)$<
+
+.cc.S:
+	$(ECHO) translating $(<)
+	$(Q) $(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(COUTFLAG)$@ -S $(CSRCFLAG)$<
+
+.mm.o:
+	$(ECHO) compiling $(<)
+	$(Q) $(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(COUTFLAG)$@ -c $(CSRCFLAG)$<
+
+.mm.S:
+	$(ECHO) translating $(<)
+	$(Q) $(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(COUTFLAG)$@ -S $(CSRCFLAG)$<
+
+.cxx.o:
+	$(ECHO) compiling $(<)
+	$(Q) $(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(COUTFLAG)$@ -c $(CSRCFLAG)$<
+
+.cxx.S:
+	$(ECHO) translating $(<)
+	$(Q) $(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(COUTFLAG)$@ -S $(CSRCFLAG)$<
+
+.cpp.o:
+	$(ECHO) compiling $(<)
+	$(Q) $(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(COUTFLAG)$@ -c $(CSRCFLAG)$<
+
+.cpp.S:
+	$(ECHO) translating $(<)
+	$(Q) $(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(COUTFLAG)$@ -S $(CSRCFLAG)$<
+
+.c.o:
+	$(ECHO) compiling $(<)
+	$(Q) $(CC) $(INCFLAGS) $(CPPFLAGS) $(CFLAGS) $(COUTFLAG)$@ -c $(CSRCFLAG)$<
+
+.c.S:
+	$(ECHO) translating $(<)
+	$(Q) $(CC) $(INCFLAGS) $(CPPFLAGS) $(CFLAGS) $(COUTFLAG)$@ -S $(CSRCFLAG)$<
+
+.m.o:
+	$(ECHO) compiling $(<)
+	$(Q) $(CC) $(INCFLAGS) $(CPPFLAGS) $(CFLAGS) $(COUTFLAG)$@ -c $(CSRCFLAG)$<
+
+.m.S:
+	$(ECHO) translating $(<)
+	$(Q) $(CC) $(INCFLAGS) $(CPPFLAGS) $(CFLAGS) $(COUTFLAG)$@ -S $(CSRCFLAG)$<
+
+$(TARGET_SO): $(OBJS) Makefile
+	$(ECHO) linking shared-object lpsolver/$(DLLIB)
+	-$(Q)$(RM) $(@)
+	$(Q) $(LDSHARED) -o $@ $(OBJS) $(LIBPATH) $(DLDFLAGS) $(LOCAL_LIBS) $(LIBS)
+	$(Q) $(POSTLINK)
+
+
+
+$(OBJS): $(HDRS) $(ruby_headers)