linguist-js 2.4.2 → 2.5.0

package/dist/cli.js

@@ -19,6 +19,7 @@ commander_1.program
     .option('-j|--json [bool]', 'Display the output as JSON', false)
     .option('-t|--tree <traversal>', 'Which part of the output JSON to display (dot-delimited)')
     .option('-q|--quick [bool]', 'Skip complex language analysis (alias for -{A|I|H|S}=false)', false)
+    .option('-o|--offline [bool]', 'Use packaged data files instead of fetching latest from GitHub', false)
     .option('-V|--keepVendored [bool]', 'Prevent skipping over vendored/generated files', false)
     .option('-B|--keepBinary [bool]', 'Prevent skipping over binary files', false)
     .option('-r|--relativePaths [bool]', 'Convert absolute file paths to relative', false)

package/dist/helpers/load-data.js

@@ -3,11 +3,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
 const cross_fetch_1 = __importDefault(require("cross-fetch"));
 const node_cache_1 = __importDefault(require("node-cache"));
 const cache = new node_cache_1.default({});
-/** Load a data file from github-linguist. */
-async function loadFile(file) {
+async function loadWebFile(file) {
     // Return cache if it exists
     const cachedContent = cache.get(file);
     if (cachedContent)
@@ -18,4 +19,12 @@ async function loadFile(file) {
     cache.set(file, fileContent);
     return fileContent;
 }
+async function loadLocalFile(file) {
+    const filePath = path_1.default.resolve(__dirname, '../../ext', file);
+    return promises_1.default.readFile(filePath).then(buffer => buffer.toString());
+}
+/** Load a data file from github-linguist. */
+async function loadFile(file, offline = false) {
+    return offline ? loadLocalFile(file) : loadWebFile(file);
+}
 exports.default = loadFile;

package/dist/index.js

@@ -20,11 +20,11 @@ async function analyse(input, opts = {}) {
     input = [input !== null && input !== void 0 ? input : []].flat();
     opts.fileContent = [(_a = opts.fileContent) !== null && _a !== void 0 ? _a : []].flat();
     // Load data from github-linguist web repo
-    const langData = await (0, load_data_1.default)('languages.yml').then(js_yaml_1.default.load);
-    const vendorData = await (0, load_data_1.default)('vendor.yml').then(js_yaml_1.default.load);
-    const docData = await (0, load_data_1.default)('documentation.yml').then(js_yaml_1.default.load);
-    const heuristicsData = await (0, load_data_1.default)('heuristics.yml').then(js_yaml_1.default.load);
-    const generatedData = await (0, load_data_1.default)('generated.rb').then(text => { var _a; return (_a = text.match(/(?<=name\.match\(\/).+?(?=(?<!\\)\/)/gm)) !== null && _a !== void 0 ? _a : []; });
+    const langData = await (0, load_data_1.default)('languages.yml', opts.offline).then(js_yaml_1.default.load);
+    const vendorData = await (0, load_data_1.default)('vendor.yml', opts.offline).then(js_yaml_1.default.load);
+    const docData = await (0, load_data_1.default)('documentation.yml', opts.offline).then(js_yaml_1.default.load);
+    const heuristicsData = await (0, load_data_1.default)('heuristics.yml', opts.offline).then(js_yaml_1.default.load);
+    const generatedData = await (0, load_data_1.default)('generated.rb', opts.offline).then(text => { var _a; return (_a = text.match(/(?<=name\.match\(\/).+?(?=(?<!\\)\/)/gm)) !== null && _a !== void 0 ? _a : []; });
     const vendorPaths = [...vendorData, ...docData, ...generatedData];
     // Setup main variables
     const fileAssociations = {};
@@ -86,8 +86,9 @@ async function analyse(input, opts = {}) {
     if (!useRawContent && opts.checkAttributes) {
         for (const folder of folders) {
             // Skip if folder is marked in gitattributes
-            if (relPath(folder) && gitignores.ignores(relPath(folder)))
+            if (relPath(folder) && gitignores.ignores(relPath(folder))) {
                 continue;
+            }
             // Parse gitignores
             const ignoresFile = path_1.default.join(folder, '.gitignore');
             if (opts.checkIgnored && fs_1.default.existsSync(ignoresFile)) {
@@ -101,10 +102,12 @@ async function analyse(input, opts = {}) {
                 // Explicit text/binary associations
                 const contentTypeMatches = attributesData.matchAll(/^(\S+).*?(-?binary|-?text)(?!=auto)/gm);
                 for (const [_line, path, type] of contentTypeMatches) {
-                    if (['text', '-binary'].includes(type))
+                    if (['text', '-binary'].includes(type)) {
                         customText.add(path);
-                    if (['-text', 'binary'].includes(type))
+                    }
+                    if (['-text', 'binary'].includes(type)) {
                         customBinary.add(path);
+                    }
                 }
                 // Custom vendor options
                 const vendorMatches = attributesData.matchAll(/^(\S+).*[^-]linguist-(vendored|generated|documentation)(?!=false)/gm);
@@ -117,8 +120,9 @@ async function analyse(input, opts = {}) {
                     // If specified language is an alias, associate it with its full name
                     if (!langData[forcedLang]) {
                         const overrideLang = Object.entries(langData).find(entry => { var _a; return (_a = entry[1].aliases) === null || _a === void 0 ? void 0 : _a.includes(forcedLang.toLowerCase()); });
-                        if (overrideLang)
+                        if (overrideLang) {
                             forcedLang = overrideLang[0];
+                        }
                     }
                     const fullPath = relPath(folder) + '/' + path;
                     overrides[fullPath] = forcedLang;
@@ -154,11 +158,11 @@ async function analyse(input, opts = {}) {
         if (useRawContent) {
             firstLine = (_e = (_d = (_c = opts.fileContent) === null || _c === void 0 ? void 0 : _c[files.indexOf(file)]) === null || _d === void 0 ? void 0 : _d.split('\n')[0]) !== null && _e !== void 0 ? _e : null;
         }
-        else {
-            if (!fs_1.default.existsSync(file) || fs_1.default.lstatSync(file).isDirectory())
-                continue;
+        else if (fs_1.default.existsSync(file) && !fs_1.default.lstatSync(file).isDirectory()) {
             firstLine = await (0, read_file_1.default)(file, true).catch(() => null);
         }
+        else
+            continue;
         // Skip if file is unreadable
         if (firstLine === null)
             continue;
@@ -175,10 +179,11 @@ async function analyse(input, opts = {}) {
                 const matchesLang = firstLine.toLowerCase().match(langMatcher(lang));
                 const matchesAlias = (_g = data.aliases) === null || _g === void 0 ? void 0 : _g.some(lang => firstLine.toLowerCase().match(langMatcher(lang)));
                 // Add language
-                if (opts.checkShebang && matchesInterpretor)
-                    matches.push(lang);
-                if (opts.checkModeline && (matchesLang || matchesAlias))
+                const interpretorCheck = opts.checkShebang && matchesInterpretor;
+                const modelineCheck = opts.checkModeline && (matchesLang || matchesAlias);
+                if (interpretorCheck || modelineCheck) {
                     matches.push(lang);
+                }
             }
             if (matches.length) {
                 // Add explicitly-identified language
@@ -213,12 +218,14 @@ async function analyse(input, opts = {}) {
             for (const lang in langData) {
                 // Check if extension is a match
                 const matchesExt = (_j = langData[lang].extensions) === null || _j === void 0 ? void 0 : _j.some(ext => file.toLowerCase().endsWith(ext.toLowerCase()));
-                if (matchesExt)
+                if (matchesExt) {
                     addResult(file, lang);
+                }
             }
         // Fallback to null if no language matches
-        if (!fileAssociations[file])
+        if (!fileAssociations[file]) {
             addResult(file, null);
+        }
     }
     // Narrow down file associations to the best fit
     for (const file in fileAssociations) {
@@ -280,16 +287,19 @@ async function analyse(input, opts = {}) {
         const categories = ['data', 'markup', 'programming', 'prose'];
         const hiddenCategories = categories.filter(cat => !opts.categories.includes(cat));
         for (const [file, lang] of Object.entries(results.files.results)) {
-            if (!hiddenCategories.some(cat => { var _a; return lang && ((_a = langData[lang]) === null || _a === void 0 ? void 0 : _a.type) === cat; }))
+            if (!hiddenCategories.some(cat => { var _a; return lang && ((_a = langData[lang]) === null || _a === void 0 ? void 0 : _a.type) === cat; })) {
                 continue;
+            }
             delete results.files.results[file];
-            if (lang)
+            if (lang) {
                 delete results.languages.results[lang];
+            }
         }
         for (const category of hiddenCategories) {
             for (const [lang, { type }] of Object.entries(results.languages.results)) {
-                if (type === category)
+                if (type === category) {
                     delete results.languages.results[lang];
+                }
             }
         }
     }
@@ -298,8 +308,9 @@ async function analyse(input, opts = {}) {
         const newMap = {};
         for (const [file, lang] of Object.entries(results.files.results)) {
             let relPath = path_1.default.relative(process.cwd(), file).replace(/\\/g, '/');
-            if (!relPath.startsWith('../'))
+            if (!relPath.startsWith('../')) {
                 relPath = './' + relPath;
+            }
             newMap[relPath] = lang;
         }
         results.files.results = newMap;
@@ -323,8 +334,9 @@ async function analyse(input, opts = {}) {
         // Add language and bytes data to corresponding section
         const { type } = langData[lang];
         (_s = (_v = results.languages.results)[lang]) !== null && _s !== void 0 ? _s : (_v[lang] = { type, bytes: 0, color: langData[lang].color });
-        if (opts.childLanguages)
+        if (opts.childLanguages) {
             results.languages.results[lang].parent = langData[lang].group;
+        }
         results.languages.results[lang].bytes += fileSize;
         results.languages.bytes += fileSize;
     }

package/dist/types.d.ts

@@ -14,6 +14,7 @@ export interface Options {
     relativePaths?: boolean;
     childLanguages?: boolean;
     quick?: boolean;
+    offline?: boolean;
     checkIgnored?: boolean;
     checkAttributes?: boolean;
     checkHeuristics?: boolean;

package/ext/documentation.yml

@@ -0,0 +1,17 @@
+- ^[Dd]ocs?/
+- (^|/)[Dd]ocumentation/
+- (^|/)[Gg]roovydoc/
+- (^|/)[Jj]avadoc/
+- ^[Mm]an/
+- ^[Ee]xamples/
+- ^[Dd]emos?/
+- (^|/)inst/doc/- (^|/)CITATION(\.cff|(S)?(\.(bib|md))?)$
+- (^|/)CHANGE(S|LOG)?(\.|$)
+- (^|/)CONTRIBUTING(\.|$)
+- (^|/)COPYING(\.|$)
+- (^|/)INSTALL(\.|$)
+- (^|/)LICEN[CS]E(\.|$)
+- (^|/)[Ll]icen[cs]e(\.|$)
+- (^|/)README(\.|$)
+- (^|/)[Rr]eadme(\.|$)
+- ^[Ss]amples?/

package/ext/generated.rb

@@ -0,0 +1,351 @@
+module Linguist
+  class Generated
+    def self.generated?(name, data)
+      new(name, data).generated?
+    end
+    def initialize(name, data)
+      @name = name
+      @extname = File.extname(name)
+      @_data = data
+    end    attr_reader :name, :extname
+    def data
+      @data ||= @_data.respond_to?(:call) ? @_data.call() : @_data
+    end
+    def lines
+      @lines ||= data ? data.split("\n", -1) : []
+    end
+    def generated?
+      xcode_file? ||
+      intellij_file? ||
+      cocoapods? ||
+      carthage_build? ||
+      generated_graphql_relay? ||
+      generated_net_designer_file? ||
+      generated_net_specflow_feature_file? ||
+      composer_lock? ||
+      cargo_lock? ||
+      node_modules? ||
+      go_vendor? ||
+      go_lock? ||
+      poetry_lock? ||
+      esy_lock? ||
+      npm_shrinkwrap_or_package_lock? ||
+      terraform_lock? ||
+      generated_yarn_plugnplay? ||
+      godeps? ||
+      generated_by_zephir? ||
+      minified_files? ||
+      has_source_map? ||
+      source_map? ||
+      compiled_coffeescript? ||
+      generated_parser? ||
+      generated_net_docfile? ||
+      generated_postscript? ||
+      compiled_cython_file? ||
+      pipenv_lock? ||
+      generated_go? ||
+      generated_protocol_buffer_from_go? ||
+      generated_protocol_buffer? ||
+      generated_javascript_protocol_buffer? ||
+      generated_apache_thrift? ||
+      generated_jni_header? ||
+      vcr_cassette? ||
+      generated_antlr? ||
+      generated_module? ||
+      generated_unity3d_meta? ||
+      generated_racc? ||
+      generated_jflex? ||
+      generated_grammarkit? ||
+      generated_roxygen2? ||
+      generated_html? ||
+      generated_jison? ||
+      generated_grpc_cpp? ||
+      generated_dart? ||
+      generated_perl_ppport_header? ||
+      generated_gamemakerstudio? ||
+      generated_gimp? ||
+      generated_visualstudio6? ||
+      generated_haxe? ||
+      generated_jooq? ||
+      generated_pascal_tlb?
+    end
+    def xcode_file?
+      ['.nib', '.xcworkspacedata', '.xcuserstate'].include?(extname)
+    end
+    def intellij_file?
+      !!name.match(/(?:^|\/)\.idea\//)
+    end
+    def cocoapods?
+      !!name.match(/(^Pods|\/Pods)\//)
+    end
+    def carthage_build?
+      !!name.match(/(^|\/)Carthage\/Build\//)
+    end
+    def maybe_minified?
+      ['.js', '.css'].include? extname.downcase
+    end
+    def minified_files?
+      if maybe_minified? and lines.any?
+        (lines.inject(0) { |n, l| n += l.length } / lines.length) > 110
+      else
+        false
+      end
+    end
+    def has_source_map?
+      return false unless maybe_minified?
+      lines.last(2).any? { |l| l.match(/^\/[*\/][\#@] source(?:Mapping)?URL|sourceURL=/) }
+    end
+    def source_map?
+      return false unless extname.downcase == '.map'      name =~ /(\.css|\.js)\.map$/i ||
+      lines[0] =~ /^{"version":\d+,/ ||
+      lines[0] =~ /^\/\*\* Begin line maps\. \*\*\/{/
+    end
+    def compiled_coffeescript?
+      return false unless extname == '.js'
+      if lines[0] =~ /^\/\/ Generated by /
+        return true
+      end      if lines[0] == '(function() {' &&
+          lines[-2] == '}).call(this);' &&
+          lines[-1] == ''        score = 0        lines.each do |line|
+          if line =~ /var /
+            score += 1 * line.gsub(/(_fn|_i|_len|_ref|_results)/).count
+            score += 3 * line.gsub(/(__bind|__extends|__hasProp|__indexOf|__slice)/).count
+          end
+        end
+        score >= 3
+      else
+        false
+      end
+    end
+    def generated_net_docfile?
+      return false unless extname.downcase == ".xml"
+      return false unless lines.count > 3
+      return lines[1].include?("<doc>") &&
+        lines[2].include?("<assembly>") &&
+        lines[-2].include?("</doc>")
+    end
+    def generated_net_designer_file?
+      !!name.match(/\.designer\.(cs|vb)$/i)
+    end
+    def generated_net_specflow_feature_file?
+      !!name.match(/\.feature\.cs$/i)
+    end
+    def generated_parser?
+      return false unless extname == '.js'
+      if lines[0..4].join('') =~ /^(?:[^\/]|\/[^\*])*\/\*(?:[^\*]|\*[^\/])*Generated by PEG.js/
+        return true
+      end      false
+    end
+    def generated_postscript?
+      return false unless ['.ps', '.eps', '.pfa'].include? extname
+      return true if data =~ /(\n|\r\n|\r)\s*(?:currentfile eexec\s+|\/sfnts\s+\[\1<)\h{8,}\1/
+      creator = lines[0..9].find {|line| line =~ /^%%Creator: /}
+      return false if creator.nil?
+      return true if creator =~ /[0-9]|draw|mpage|ImageMagick|inkscape|MATLAB/ ||
+        creator =~ /PCBNEW|pnmtops|\(Unknown\)|Serif Affinity|Filterimage -tops/
+      !!creator.include?("EAGLE") and lines[0..4].find {|line| line =~ /^%%Title: EAGLE Drawing /}
+    end    def generated_go?
+      return false unless extname == '.go'
+      return false unless lines.count > 1      return lines.first(40).any? { |l| l.include? "Code generated by" }
+    end
+    def generated_protocol_buffer_from_go?
+      return false unless extname == '.proto'
+      return false unless lines.count > 1      return lines.first(20).any? { |l| l.include? "This file was autogenerated by go-to-protobuf" }
+    end    PROTOBUF_EXTENSIONS = ['.py', '.java', '.h', '.cc', '.cpp', '.m', '.rb', '.php']
+    def generated_protocol_buffer?
+      return false unless PROTOBUF_EXTENSIONS.include?(extname)
+      return false unless lines.count > 1      return lines.first(3).any? { |l| l.include?("Generated by the protocol buffer compiler.  DO NOT EDIT!") }
+    end
+    def generated_javascript_protocol_buffer?
+      return false unless extname == ".js"
+      return false unless lines.count > 6      return lines[5].include?("GENERATED CODE -- DO NOT EDIT!")
+    end    APACHE_THRIFT_EXTENSIONS = ['.rb', '.py', '.go', '.js', '.m', '.java', '.h', '.cc', '.cpp', '.php']
+    def generated_apache_thrift?
+      return false unless APACHE_THRIFT_EXTENSIONS.include?(extname)
+      return lines.first(6).any? { |l| l.include?("Autogenerated by Thrift Compiler") }
+    end
+    def generated_jni_header?
+      return false unless extname == '.h'
+      return false unless lines.count > 2      return lines[0].include?("/* DO NOT EDIT THIS FILE - it is machine generated */") &&
+               lines[1].include?("#include <jni.h>")
+    end
+    def node_modules?
+      !!name.match(/node_modules\//)
+    end
+    def go_vendor?
+      !!name.match(/vendor\/((?!-)[-0-9A-Za-z]+(?<!-)\.)+(com|edu|gov|in|me|net|org|fm|io)/)
+    end
+    def go_lock?
+      !!name.match(/(Gopkg|glide)\.lock/)
+    end
+    def poetry_lock?
+      !!name.match(/poetry\.lock/)
+    end
+    def esy_lock?
+      !!name.match(/(^|\/)(\w+\.)?esy.lock$/)
+    end
+    def npm_shrinkwrap_or_package_lock?
+      !!name.match(/npm-shrinkwrap\.json/) || !!name.match(/package-lock\.json/)
+    end
+    def generated_yarn_plugnplay?
+      !!name.match(/(^|\/)\.pnp\..*$/)
+    end
+    def godeps?
+      !!name.match(/Godeps\//)
+    end
+    def composer_lock?
+      !!name.match(/composer\.lock/)
+    end
+    def generated_by_zephir?
+      !!name.match(/.\.zep\.(?:c|h|php)$/)
+    end
+    def cargo_lock?
+      !!name.match(/Cargo\.lock/)
+    end
+    def vcr_cassette?
+      return false unless extname == '.yml'
+      return false unless lines.count > 2
+      return lines[-2].include?("recorded_with: VCR")
+    end
+    def generated_antlr?
+      return false unless extname == '.g'
+      return false unless lines.count > 2
+      return lines[1].include?("generated by Xtest")
+    end
+    def compiled_cython_file?
+      return false unless ['.c', '.cpp'].include? extname
+      return false unless lines.count > 1
+      return lines[0].include?("Generated by Cython")
+    end
+    def pipenv_lock?
+      !!name.match(/Pipfile\.lock/)
+    end
+    def terraform_lock?
+      !!name.match(/(?:^|\/)\.terraform\.lock\.hcl$/)
+    end
+    def generated_module?
+      return false unless extname == '.mod'
+      return false unless lines.count > 1
+      return lines[0].include?("PCBNEW-LibModule-V") ||
+              lines[0].include?("GFORTRAN module version '")
+    end
+    def generated_unity3d_meta?
+      return false unless extname == '.meta'
+      return false unless lines.count > 1
+      return lines[0].include?("fileFormatVersion: ")
+    end
+    def generated_racc?
+      return false unless extname == '.rb'
+      return false unless lines.count > 2
+      return lines[2].start_with?("# This file is automatically generated by Racc")
+    end
+    def generated_jflex?
+      return false unless extname == '.java'
+      return false unless lines.count > 1
+      return lines[0].start_with?("/* The following code was generated by JFlex ")
+    end
+    def generated_grammarkit?
+      return false unless extname == '.java'
+      return false unless lines.count > 1
+      return lines[0].start_with?("// This is a generated file. Not intended for manual editing.")
+    end
+    def generated_roxygen2?
+      return false unless extname == '.Rd'
+      return false unless lines.count > 1      return lines[0].include?("% Generated by roxygen2: do not edit by hand")
+    end
+    def generated_jison?
+      return false unless extname == '.js'
+      return false unless lines.count > 1
+      return lines[0].start_with?("/* parser generated by jison ") ||
+             lines[0].start_with?("/* generated by jison-lex ")
+    end
+    def generated_grpc_cpp?
+      return false unless %w{.cpp .hpp .h .cc}.include? extname
+      return false unless lines.count > 1
+      return lines[0].start_with?("// Generated by the gRPC")
+    end
+    def generated_dart?
+      return false unless extname == '.dart'
+      return false unless lines.count > 1
+      return lines.first.downcase =~ /generated code\W{2,3}do not modify/
+    end
+    def generated_perl_ppport_header?
+        return false unless name.match(/ppport\.h$/)
+        return false unless lines.count > 10
+        return lines[8].include?("Automatically created by Devel::PPPort")
+    end
+    def generated_graphql_relay?
+      !!name.match(/__generated__\//)
+    end
+    def generated_gamemakerstudio?
+      return false unless ['.yy', '.yyp'].include? extname
+      return false unless lines.count > 3
+      return lines[2].match(/\"modelName\"\:\s*\"GM/) ||
+             lines[0] =~ /^\d\.\d\.\d.+\|\{/
+    end
+    def generated_gimp?
+      return false unless ['.c', '.h'].include? extname
+      return false unless lines.count > 0
+      return lines[0].match(/\/\* GIMP [a-zA-Z0-9\- ]+ C\-Source image dump \(.+?\.c\) \*\//) ||
+             lines[0].match(/\/\*  GIMP header image file format \([a-zA-Z0-9\- ]+\)\: .+?\.h  \*\//)
+    end
+    def generated_visualstudio6?
+      return false unless extname.downcase == '.dsp'
+      lines.first(3).any? { |l| l.include? '# Microsoft Developer Studio Generated Build File' }
+    end    HAXE_EXTENSIONS = ['.js', '.py', '.lua', '.cpp', '.h', '.java', '.cs', '.php']
+    def generated_haxe?
+      return false unless HAXE_EXTENSIONS.include?(extname)
+      return lines.first(3).any? { |l| l.include?("Generated by Haxe") }
+    end
+    def generated_html?
+      return false unless ['.html', '.htm', '.xhtml'].include? extname.downcase
+      return false unless lines.count > 1
+      return true if lines[0..1].any? do |line|
+        line.match(/<!-- Generated by pkgdown: do not edit by hand -->/)
+      end
+      return true if lines.count > 2 && lines[2].start_with?('<!-- This is an automatically generated file.')
+      return true if lines[0..30].any? do |line|
+        line.match(/<!--\s+Generated by Doxygen\s+[.0-9]+\s*-->/i)
+      end
+      matches = lines[0..30].join(' ').scan(/<meta(\s+[^>]++)>/i)
+      return false if matches.empty?
+      return matches.map {|x| extract_html_meta(x) }.any? do |attr|
+        attr["name"].to_s.downcase == 'generator' &&
+        [attr["content"], attr["value"]].any? do |cv|
+          !cv.nil? &&
+          cv.match(/^
+            ( org \s+ mode
+            | j?latex2html
+            | groff
+            | makeinfo
+            | texi2html
+            | ronn
+            ) \b
+          /ix)
+        end
+      end
+    end
+    def generated_jooq?
+      return false unless extname.downcase == '.java'
+      lines.first(2).any? { |l| l.include? 'This file is generated by jOOQ.' }
+    end
+    def generated_pascal_tlb?
+      !!name.match(/_tlb\.pas$/i)
+    end
+    def extract_html_meta(match)
+      (match.last.sub(/\/\Z/, "").strip.scan(/
+        (?<=^|\s)
+        (name|content|value)
+        \s* = \s*
+        ( "[^"]+"
+        | '[^']+'
+        |  [^\s"']+
+        )
+      /ix)).map do |match|
+        key = match[0].downcase
+        val = match[1].gsub(/\A["']|["']\Z/, '')
+        [key, val]
+      end.select { |x| x.length == 2 }.to_h
+    end
+  end
+end