fasttext 0.1.2 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f83be8c01c6a45a90758ccee430b3898396bcfdda5a2c338126ed9dc3620aea5
-  data.tar.gz: 7e3dee8eb3afe12745f78448fd01ac68a2f0ac946bd01195f2f6e6081f62fbad
+  metadata.gz: 9aae7e20933f51ebebd802276d7e006ce792fcfc6dd94ea8ceda887ab0f4eca8
+  data.tar.gz: a90a7bbfffe424829052afc3519bc0473a7fc1b22a2d1ea0c8786d9372a0cdb5
 SHA512:
-  metadata.gz: be3117e1aceed3f6126fc1d84eb87caf53abb3be802a419ebcaa284cb567ee9ac033d5860842690bbd1c0477a6e5013dfc36eb96f6fb067a63015150fa18a1fe
-  data.tar.gz: dc2467f3f7317b5e1955ede144d9ad50c5abb1cc2b9dc5ad356350f192631b0142c91aecc4dd03b331d90f1cf65c7f3ba3ec176c17dc6b66a1226171261de1b6
+  metadata.gz: 3042a798560e5960d18d8bcefb66833bf621bc1dcf26f77742602d0d4e7b1e4cc33b078f9225c209ac9a0d2f89c9b3c98ad2446582af4a3ac4effc761192c58d
+  data.tar.gz: d70ce1005916a809a78b02f23232b1efd7cc59dc9d3ed2df7929f946db2f326c0df40729b2ea953846e906c2774d6b6e971650f3d585da65ae6562bdcb9a9b5e

data/CHANGELOG.md

@@ -1,3 +1,22 @@
+## 0.2.2 (2021-10-16)
+
+- Fixed `file cannot be opened` errors
+
+## 0.2.1 (2021-05-23)
+
+- Improved performance
+
+## 0.2.0 (2021-05-17)
+
+- Updated to Rice 4
+- Dropped support for Ruby < 2.6
+
+## 0.1.3 (2020-04-28)
+
+- Updated fastText to 0.9.2
+- Added support for autotune
+- Added `--with-optflags` option
+
 ## 0.1.2 (2020-01-10)
 
 - Fixed installation error with Ruby 2.7

data/LICENSE.txt

@@ -1,22 +1,22 @@
-Copyright (c) 2019-2020 Andrew Kane
-
 MIT License
 
-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:
+Copyright (c) 2016-present, Facebook, Inc.
+Copyright (c) 2019-2021 Andrew Kane
+
+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 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.
+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.md

@@ -2,7 +2,7 @@
 
 [fastText](https://fasttext.cc) - efficient text classification and representation learning - for Ruby
 
-[![Build Status](https://travis-ci.org/ankane/fasttext.svg?branch=master)](https://travis-ci.org/ankane/fasttext)
+[![Build Status](https://github.com/ankane/fastText/workflows/build/badge.svg?branch=master)](https://github.com/ankane/fastText/actions)
 
 ## Installation
 
@@ -77,6 +77,12 @@ model.labels
 
 > Use `include_freq: true` to get their frequency
 
+Search for the best hyperparameters
+
+```ruby
+model.fit(x, y, autotune_set: [x_valid, y_valid])
+```
+
 Compress the model - significantly reduces size but sacrifices a little performance
 
 ```ruby
@@ -121,6 +127,12 @@ Get a word vector
 model.word_vector("carrot")
 ```
 
+Get a sentence vector
+
+```ruby
+model.sentence_vector("sentence text")
+```
+
 Get words
 
 ```ruby
@@ -166,9 +178,13 @@ FastText::Classifier.new(
   thread: 3,                  # number of threads
   lr_update_rate: 100,        # change the rate of updates for the learning rate
   t: 0.0001,                  # sampling threshold
-  label_prefix: "__label__"   # label prefix
+  label_prefix: "__label__",  # label prefix
   verbose: 2,                 # verbose
-  pretrained_vectors: nil     # pretrained word vectors (.vec file)
+  pretrained_vectors: nil,    # pretrained word vectors (.vec file)
+  autotune_metric: "f1",      # autotune optimization metric
+  autotune_predictions: 1,    # autotune predictions
+  autotune_duration: 300,     # autotune search time in seconds
+  autotune_model_size: nil    # autotune model size, like 2M
 )
 ```
 
@@ -200,7 +216,7 @@ FastText::Vectorizer.new(
 Input can be read directly from files
 
 ```ruby
-model.fit("train.txt")
+model.fit("train.txt", autotune_set: "valid.txt")
 model.test("test.txt")
 ```
 
@@ -222,7 +238,7 @@ __label__spam text from document three
 
 ## Pretrained Models
 
-There are a number of [pretrained models](https://fasttext.cc/docs/en/english-vectors.html) you can download
+There are a number of [pretrained models](https://fasttext.cc/docs/en/supervised-models.html) you can download
 
 ### Language Identification
 
@@ -238,15 +254,6 @@ Get language predictions
 model.predict("bon appétit")
 ```
 
-## rbenv
-
-This library uses [Rice](https://github.com/jasonroelofs/rice) to interface with the fastText C++ library. Rice and earlier versions of rbenv don’t play nicely together. If you encounter an error during installation, upgrade ruby-build and reinstall your Ruby version.
-
-```sh
-brew upgrade ruby-build
-rbenv install [version]
-```
-
 ## History
 
 View the [changelog](https://github.com/ankane/fasttext/blob/master/CHANGELOG.md)
@@ -260,12 +267,12 @@ Everyone is encouraged to help improve this project. Here are a few ways you can
 - Write, clarify, or fix documentation
 - Suggest or add new features
 
-To get started with development and testing:
+To get started with development:
 
 ```sh
-git clone https://github.com/ankane/fasttext.git
-cd fasttext
+git clone --recursive https://github.com/ankane/fastText.git
+cd fastText
 bundle install
-rake compile
-rake test
+bundle exec rake compile
+bundle exec rake test
 ```

data/ext/fasttext/ext.cpp

@@ -1,116 +1,49 @@
-#include <args.h>
-#include <densematrix.h>
-#include <fasttext.h>
-#include <rice/Data_Type.hpp>
-#include <rice/Constructor.hpp>
-#include <rice/Array.hpp>
-#include <rice/Hash.hpp>
-#include <real.h>
-#include <vector.h>
+// stdlib
 #include <cmath>
 #include <iterator>
 #include <sstream>
 #include <stdexcept>
 
-using namespace Rice;
+// fasttext
+#include <args.h>
+#include <autotune.h>
+#include <densematrix.h>
+#include <fasttext.h>
+#include <real.h>
+#include <vector.h>
 
-template<>
-inline
-Object to_ruby<std::vector<std::pair<fasttext::real, std::string>>>(std::vector<std::pair<fasttext::real, std::string>> const & x)
-{
-  Array ret;
-  for (const auto& v : x) {
-    Array a;
-    a.push(v.first);
-    a.push(v.second);
-    ret.push(a);
-  }
-  return ret;
-}
+// rice
+#include <rice/rice.hpp>
+#include <rice/stl.hpp>
 
-fasttext::Args buildArgs(Hash h) {
-  fasttext::Args a;
+using fasttext::Args;
+using fasttext::FastText;
 
-  std::vector<Hash::Entry> v;
-  Hash::iterator it = h.begin();
-  Hash::iterator end = h.end();
+using Rice::Array;
+using Rice::Constructor;
+using Rice::Module;
+using Rice::define_class_under;
+using Rice::define_module;
+using Rice::define_module_under;
 
-  for(; it != end; ++it)
+namespace Rice::detail
+{
+  template<>
+  class To_Ruby<std::vector<std::pair<fasttext::real, std::string>>>
   {
-    std::string name = from_ruby<std::string>(it->key.to_s());
-    Object value = it->value;
-
-    if (name == "input") {
-      a.input = from_ruby<std::string>(value);
-    } else if (name == "output") {
-      a.output = from_ruby<std::string>(value);
-    } else if (name == "lr") {
-      a.lr = from_ruby<double>(value);
-    } else if (name == "lr_update_rate") {
-      a.lrUpdateRate = from_ruby<int>(value);
-    } else if (name == "dim") {
-      a.dim = from_ruby<int>(value);
-    } else if (name == "ws") {
-      a.ws = from_ruby<int>(value);
-    } else if (name == "epoch") {
-      a.epoch = from_ruby<int>(value);
-    } else if (name == "min_count") {
-      a.minCount = from_ruby<int>(value);
-    } else if (name == "min_count_label") {
-      a.minCountLabel = from_ruby<int>(value);
-    } else if (name == "neg") {
-      a.neg = from_ruby<int>(value);
-    } else if (name == "word_ngrams") {
-      a.wordNgrams = from_ruby<int>(value);
-    } else if (name == "loss") {
-      std::string str = from_ruby<std::string>(value);
-      if (str == "softmax") {
-        a.loss = fasttext::loss_name::softmax;
-      } else if (str == "ns") {
-        a.loss = fasttext::loss_name::ns;
-      } else if (str == "hs") {
-        a.loss = fasttext::loss_name::hs;
-      } else if (str == "ova") {
-        a.loss = fasttext::loss_name::ova;
-      } else {
-        throw std::invalid_argument("Unknown loss: " + str);
-      }
-    } else if (name == "model") {
-      std::string str = from_ruby<std::string>(value);
-      if (str == "supervised") {
-        a.model = fasttext::model_name::sup;
-      } else if (str == "skipgram") {
-        a.model = fasttext::model_name::sg;
-      } else if (str == "cbow") {
-        a.model = fasttext::model_name::cbow;
-      } else {
-        throw std::invalid_argument("Unknown model: " + str);
+  public:
+    VALUE convert(std::vector<std::pair<fasttext::real, std::string>> const & x)
+    {
+      Array ret;
+      for (const auto& v : x) {
+        Array a;
+        a.push(v.first);
+        a.push(v.second);
+        ret.push(a);
       }
-    } else if (name == "bucket") {
-      a.bucket = from_ruby<int>(value);
-    } else if (name == "minn") {
-      a.minn = from_ruby<int>(value);
-    } else if (name == "maxn") {
-      a.maxn = from_ruby<int>(value);
-    } else if (name == "thread") {
-      a.thread = from_ruby<int>(value);
-    } else if (name == "t") {
-      a.t = from_ruby<double>(value);
-    } else if (name == "label_prefix") {
-      a.label = from_ruby<std::string>(value);
-    } else if (name == "verbose") {
-      a.verbose = from_ruby<int>(value);
-    } else if (name == "pretrained_vectors") {
-      a.pretrainedVectors = from_ruby<std::string>(value);
-    } else if (name == "save_output") {
-      a.saveOutput = from_ruby<bool>(value);
-    // } else if (name == "seed") {
-    //   a.seed = from_ruby<int>(value);
-    } else {
-      throw std::invalid_argument("Unknown argument: " + name);
+      return ret;
     }
-  }
-  return a;
+  };
 }
 
 extern "C"
@@ -119,11 +52,68 @@ void Init_ext()
   Module rb_mFastText = define_module("FastText");
   Module rb_mExt = define_module_under(rb_mFastText, "Ext");
 
-  define_class_under<fasttext::FastText>(rb_mExt, "Model")
-    .define_constructor(Constructor<fasttext::FastText>())
+  define_class_under<Args>(rb_mExt, "Args")
+    .define_constructor(Constructor<Args>())
+    .define_attr("input", &Args::input)
+    .define_attr("output", &Args::output)
+    .define_attr("lr", &Args::lr)
+    .define_attr("lr_update_rate", &Args::lrUpdateRate)
+    .define_attr("dim", &Args::dim)
+    .define_attr("ws", &Args::ws)
+    .define_attr("epoch", &Args::epoch)
+    .define_attr("min_count", &Args::minCount)
+    .define_attr("min_count_label", &Args::minCountLabel)
+    .define_attr("neg", &Args::neg)
+    .define_attr("word_ngrams", &Args::wordNgrams)
+    .define_method(
+      "loss=",
+      [](Args& a, const std::string& str) {
+        if (str == "softmax") {
+          a.loss = fasttext::loss_name::softmax;
+        } else if (str == "ns") {
+          a.loss = fasttext::loss_name::ns;
+        } else if (str == "hs") {
+          a.loss = fasttext::loss_name::hs;
+        } else if (str == "ova") {
+          a.loss = fasttext::loss_name::ova;
+        } else {
+          throw std::invalid_argument("Unknown loss: " + str);
+        }
+      })
+    .define_method(
+      "model=",
+      [](Args& a, const std::string& str) {
+        if (str == "supervised") {
+          a.model = fasttext::model_name::sup;
+        } else if (str == "skipgram") {
+          a.model = fasttext::model_name::sg;
+        } else if (str == "cbow") {
+          a.model = fasttext::model_name::cbow;
+        } else {
+          throw std::invalid_argument("Unknown model: " + str);
+        }
+      })
+    .define_attr("bucket", &Args::bucket)
+    .define_attr("minn", &Args::minn)
+    .define_attr("maxn", &Args::maxn)
+    .define_attr("thread", &Args::thread)
+    .define_attr("t", &Args::t)
+    .define_attr("label_prefix", &Args::label)
+    .define_attr("verbose", &Args::verbose)
+    .define_attr("pretrained_vectors", &Args::pretrainedVectors)
+    .define_attr("save_output", &Args::saveOutput)
+    .define_attr("seed", &Args::seed)
+    .define_attr("autotune_validation_file", &Args::autotuneValidationFile)
+    .define_attr("autotune_metric", &Args::autotuneMetric)
+    .define_attr("autotune_predictions", &Args::autotunePredictions)
+    .define_attr("autotune_duration", &Args::autotuneDuration)
+    .define_attr("autotune_model_size", &Args::autotuneModelSize);
+
+  define_class_under<FastText>(rb_mExt, "Model")
+    .define_constructor(Constructor<FastText>())
     .define_method(
       "words",
-      *[](fasttext::FastText& m) {
+      [](FastText& m) {
         std::shared_ptr<const fasttext::Dictionary> d = m.getDictionary();
         std::vector<int64_t> freq = d->getCounts(fasttext::entry_type::word);
 
@@ -141,7 +131,7 @@ void Init_ext()
       })
     .define_method(
       "labels",
-      *[](fasttext::FastText& m) {
+      [](FastText& m) {
         std::shared_ptr<const fasttext::Dictionary> d = m.getDictionary();
         std::vector<int64_t> freq = d->getCounts(fasttext::entry_type::label);
 
@@ -159,12 +149,12 @@ void Init_ext()
       })
     .define_method(
       "test",
-      *[](fasttext::FastText& m, const std::string filename, int32_t k) {
+      [](FastText& m, const std::string& filename, int32_t k) {
         std::ifstream ifs(filename);
         if (!ifs.is_open()) {
           throw std::invalid_argument("Test file cannot be opened!");
         }
-        fasttext::Meter meter;
+        fasttext::Meter meter(false);
         m.test(ifs, k, 0.0, meter);
         ifs.close();
 
@@ -176,17 +166,21 @@ void Init_ext()
       })
     .define_method(
       "load_model",
-      *[](fasttext::FastText& m, std::string s) { m.loadModel(s); })
+      [](FastText& m, const std::string& s) {
+        m.loadModel(s);
+      })
     .define_method(
       "save_model",
-      *[](fasttext::FastText& m, std::string s) { m.saveModel(s); })
-    .define_method("dimension", &fasttext::FastText::getDimension)
-    .define_method("quantized?", &fasttext::FastText::isQuant)
-    .define_method("word_id", &fasttext::FastText::getWordId)
-    .define_method("subword_id", &fasttext::FastText::getSubwordId)
+      [](FastText& m, const std::string& s) {
+        m.saveModel(s);
+      })
+    .define_method("dimension", &FastText::getDimension)
+    .define_method("quantized?", &FastText::isQuant)
+    .define_method("word_id", &FastText::getWordId)
+    .define_method("subword_id", &FastText::getSubwordId)
     .define_method(
       "predict",
-      *[](fasttext::FastText& m, const std::string text, int32_t k, float threshold) {
+      [](FastText& m, const std::string& text, int32_t k, float threshold) {
         std::stringstream ioss(text);
         std::vector<std::pair<fasttext::real, std::string>> predictions;
         m.predictLine(ioss, predictions, k, threshold);
@@ -194,27 +188,26 @@ void Init_ext()
       })
     .define_method(
       "nearest_neighbors",
-      *[](fasttext::FastText& m, const std::string& word, int32_t k) {
+      [](FastText& m, const std::string& word, int32_t k) {
         return m.getNN(word, k);
       })
-    .define_method("analogies", &fasttext::FastText::getAnalogies)
-    .define_method("ngram_vectors", &fasttext::FastText::getNgramVectors)
+    .define_method("analogies", &FastText::getAnalogies)
+    // .define_method("ngram_vectors", &FastText::getNgramVectors)
     .define_method(
       "word_vector",
-      *[](fasttext::FastText& m, const std::string word) {
-        int dimension = m.getDimension();
+      [](FastText& m, const std::string& word) {
+        auto dimension = m.getDimension();
         fasttext::Vector vec = fasttext::Vector(dimension);
         m.getWordVector(vec, word);
-        float* data = vec.data();
         Array ret;
-        for (int i = 0; i < dimension; i++) {
-          ret.push(data[i]);
+        for (size_t i = 0; i < vec.size(); i++) {
+          ret.push(vec[i]);
         }
         return ret;
       })
     .define_method(
       "subwords",
-      *[](fasttext::FastText& m, const std::string word) {
+      [](FastText& m, const std::string& word) {
         std::vector<std::string> subwords;
         std::vector<int32_t> ngrams;
         std::shared_ptr<const fasttext::Dictionary> d = m.getDictionary();
@@ -228,36 +221,40 @@ void Init_ext()
       })
     .define_method(
       "sentence_vector",
-      *[](fasttext::FastText& m, const std::string text) {
+      [](FastText& m, const std::string& text) {
         std::istringstream in(text);
-        int dimension = m.getDimension();
+        auto dimension = m.getDimension();
         fasttext::Vector vec = fasttext::Vector(dimension);
         m.getSentenceVector(in, vec);
-        float* data = vec.data();
         Array ret;
-        for (int i = 0; i < dimension; i++) {
-          ret.push(data[i]);
+        for (size_t i = 0; i < vec.size(); i++) {
+          ret.push(vec[i]);
         }
         return ret;
       })
     .define_method(
       "train",
-      *[](fasttext::FastText& m, Hash h) {
-        m.train(buildArgs(h));
+      [](FastText& m, Args& a) {
+        if (a.hasAutotune()) {
+          fasttext::Autotune autotune(std::shared_ptr<fasttext::FastText>(&m, [](fasttext::FastText*) {}));
+          autotune.train(a);
+        } else {
+          m.train(a);
+        }
       })
     .define_method(
       "quantize",
-      *[](fasttext::FastText& m, Hash h) {
-        m.quantize(buildArgs(h));
+      [](FastText& m, Args& a) {
+        m.quantize(a);
       })
     .define_method(
       "supervised?",
-      *[](fasttext::FastText& m) {
+      [](FastText& m) {
         return m.getArgs().model == fasttext::model_name::sup;
       })
     .define_method(
       "label_prefix",
-      *[](fasttext::FastText& m) {
+      [](FastText& m) {
         return m.getArgs().label;
       });
 }

data/ext/fasttext/extconf.rb

@@ -1,9 +1,7 @@
 require "mkmf-rice"
 
-abort "Missing stdc++" unless have_library("stdc++")
-
-# TODO use -std=c++14 when available
-$CXXFLAGS << " -pthread -std=c++11 -funroll-loops -O3 -march=native"
+# -pthread and -O3 set by default
+$CXXFLAGS << " -std=c++17 $(optflags) -funroll-loops " << with_config("optflags", "-march=native")
 
 ext = File.expand_path(".", __dir__)
 fasttext = File.expand_path("../../vendor/fastText/src", __dir__)

data/lib/fasttext/classifier.rb

@@ -21,13 +21,25 @@ module FastText
       verbose: 2,
       pretrained_vectors: "",
       save_output: false,
-      # seed: 0
+      seed: 0,
+      autotune_validation_file: "",
+      autotune_metric: "f1",
+      autotune_predictions: 1,
+      autotune_duration: 60 * 5,
+      autotune_model_size: ""
     }
 
-    def fit(x, y = nil)
-      input = input_path(x, y)
+    def fit(x, y = nil, autotune_set: nil)
+      input, _ref = input_path(x, y)
       @m ||= Ext::Model.new
-      m.train(DEFAULT_OPTIONS.merge(@options).merge(input: input, model: "supervised"))
+      a = build_args(DEFAULT_OPTIONS)
+      a.input = input
+      a.model = "supervised"
+      if autotune_set
+        x, y = autotune_set
+        a.autotune_validation_file, _autotune_ref = input_path(x, y)
+      end
+      m.train(a)
     end
 
     def predict(text, k: 1, threshold: 0.0)
@@ -37,16 +49,16 @@ module FastText
       # TODO predict multiple in C++ for performance
       result =
         text.map do |t|
-          m.predict(prep_text(t), k, threshold).map do |v|
+          m.predict(prep_text(t), k, threshold).to_h do |v|
             [remove_prefix(v[1]), v[0]]
-          end.to_h
+          end
         end
 
       multiple ? result : result.first
     end
 
     def test(x, y = nil, k: 1)
-      input = input_path(x, y)
+      input, _ref = input_path(x, y)
       res = m.test(input, k)
       {
         examples: res[0],
@@ -57,7 +69,8 @@ module FastText
 
     # TODO support options
     def quantize
-      m.quantize({})
+      a = Ext::Args.new
+      m.quantize(a)
     end
 
     def labels(include_freq: false)
@@ -75,7 +88,7 @@ module FastText
     def input_path(x, y)
       if x.is_a?(String)
         raise ArgumentError, "Cannot pass y with file" if y
-        x
+        [x, nil]
       else
         tempfile = Tempfile.new("fasttext")
         x.zip(y) do |xi, yi|
@@ -85,7 +98,7 @@ module FastText
           tempfile.write("\n")
         end
         tempfile.close
-        tempfile.path
+        [tempfile.path, tempfile]
       end
     end
 

data/lib/fasttext/model.rb

@@ -56,5 +56,15 @@ module FastText
     def m
       @m || (raise Error, "Not fit")
     end
+
+    def build_args(default_options)
+      a = Ext::Args.new
+      opts = @options.dup
+      default_options.each do |k, v|
+        a.send("#{k}=", opts.delete(k) || v)
+      end
+      raise ArgumentError, "Unknown argument: #{opts.keys.first}" if opts.any?
+      a
+    end
   end
 end