linguist-js 2.6.1 → 2.7.0

package/dist/cli.js

@@ -4,6 +4,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const VERSION = require('../package.json').version;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
 const commander_1 = require("commander");
 const index_1 = __importDefault(require("./index"));
 const colouredMsg = ([r, g, b], msg) => `\u001B[${38};2;${r};${g};${b}m${msg}${'\u001b[0m'}`;
@@ -18,6 +20,7 @@ commander_1.program
     .option('-C|--childLanguages [bool]', 'Display child languages instead of their parents', false)
     .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('-F|--listFiles [bool]', 'Whether to list every matching file under the language results', false)
     .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)
@@ -59,21 +62,52 @@ if (args.analyze)
             const sortedEntries = Object.entries(languages.results).sort((a, b) => a[1].bytes < b[1].bytes ? +1 : -1);
             const totalBytes = languages.bytes;
             console.log(`\n Analysed ${files.bytes.toLocaleString()} B from ${files.count} files with linguist-js`);
-            console.log(`\n Language analysis results:`);
+            console.log(`\n Language analysis results: \n`);
             let count = 0;
             if (sortedEntries.length === 0)
                 console.log(`  None`);
+            // Collate files per language
+            const filesPerLanguage = {};
+            if (args.listFiles) {
+                for (const language of Object.keys(languages.results)) {
+                    filesPerLanguage[language] = [];
+                }
+                for (const [file, lang] of Object.entries(files.results)) {
+                    if (lang)
+                        filesPerLanguage[lang].push(file);
+                }
+            }
             // List parsed results
             for (const [lang, { bytes, color }] of sortedEntries) {
+                const percent = (bytes) => bytes / (totalBytes || 1) * 100;
                 const fmtd = {
                     index: (++count).toString().padStart(2, ' '),
                     lang: lang.padEnd(24, ' '),
-                    percent: (bytes / (totalBytes || 1) * 100).toFixed(2).padStart(5, ' '),
+                    percent: percent(bytes).toFixed(2).padStart(5, ' '),
                     bytes: bytes.toLocaleString().padStart(10, ' '),
                     icon: colouredMsg(hexToRgb(color !== null && color !== void 0 ? color : '#ededed'), '\u2588'),
                 };
                 console.log(`  ${fmtd.index}. ${fmtd.icon} ${fmtd.lang} ${fmtd.percent}% ${fmtd.bytes} B`);
+                // If using `listFiles` option, list all files tagged as this language
+                if (args.listFiles) {
+                    console.log(); // padding
+                    for (const file of filesPerLanguage[lang]) {
+                        let relFile = path_1.default.relative(path_1.default.resolve('.'), file).replace(/\\/g, '/');
+                        if (!relFile.startsWith('../'))
+                            relFile = './' + relFile;
+                        const bytes = (await fs_1.default.promises.stat(file)).size;
+                        const fmtd2 = {
+                            file: relFile.padEnd(42, ' '),
+                            percent: percent(bytes).toFixed(2).padStart(5, ' '),
+                            bytes: bytes.toLocaleString().padStart(10, ' '),
+                        };
+                        console.log(`        ${fmtd.icon} ${fmtd2.file}  ${fmtd2.percent}% ${fmtd2.bytes} B`);
+                    }
+                    console.log(); // padding
+                }
             }
+            if (!args.listFiles)
+                console.log(); // padding
             console.log(` Total: ${totalBytes.toLocaleString()} B`);
             // List unknown files/extensions
             if (unknown.bytes > 0) {

package/dist/helpers/parse-gitattributes.d.ts

@@ -0,0 +1,16 @@
+import * as T from '../types';
+export type FlagAttributes = {
+    'vendored': boolean | null;
+    'generated': boolean | null;
+    'documentation': boolean | null;
+    'binary': boolean | null;
+    'language': T.LanguageResult;
+};
+export type ParsedGitattributes = Array<{
+    glob: T.FileGlob;
+    attrs: FlagAttributes;
+}>;
+/**
+ * Parses a gitattributes file.
+ */
+export default function parseAttributes(content: string, folderRoot?: string): ParsedGitattributes;

package/dist/helpers/parse-gitattributes.js

@@ -0,0 +1,38 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = __importDefault(require("path"));
+/**
+ * Parses a gitattributes file.
+ */
+function parseAttributes(content, folderRoot = '.') {
+    var _a, _b;
+    const output = [];
+    for (const rawLine of content.split('\n')) {
+        const line = rawLine.replace(/#.*/, '').trim();
+        if (!line)
+            continue;
+        const parts = line.split(/\s+/g);
+        const fileGlob = parts[0];
+        const relFileGlob = path_1.default.join(folderRoot, fileGlob).replace(/\\/g, '/');
+        const attrParts = parts.slice(1);
+        const isTrue = (str) => !str.startsWith('-') && !str.endsWith('=false');
+        const isFalse = (str) => str.startsWith('-') || str.endsWith('=false');
+        const trueParts = (str) => attrParts.filter(part => part.includes(str) && isTrue(part));
+        const falseParts = (str) => attrParts.filter(part => part.includes(str) && isFalse(part));
+        const hasTrueParts = (str) => trueParts(str).length > 0;
+        const hasFalseParts = (str) => falseParts(str).length > 0;
+        const attrs = {
+            'generated': hasTrueParts('linguist-generated') ? true : hasFalseParts('linguist-generated') ? false : null,
+            'vendored': hasTrueParts('linguist-vendored') ? true : hasFalseParts('linguist-vendored') ? false : null,
+            'documentation': hasTrueParts('linguist-documentation') ? true : hasFalseParts('linguist-documentation') ? false : null,
+            'binary': hasTrueParts('binary') || hasFalseParts('text') ? true : hasFalseParts('binary') || hasTrueParts('text') ? false : null,
+            'language': (_b = (_a = trueParts('linguist-language').at(-1)) === null || _a === void 0 ? void 0 : _a.split('=')[1]) !== null && _b !== void 0 ? _b : null,
+        };
+        output.push({ glob: relFileGlob, attrs });
+    }
+    return output;
+}
+exports.default = parseAttributes;

package/dist/helpers/walk-tree.d.ts

@@ -8,8 +8,8 @@ interface WalkInput {
     folderRoots: string[];
     /** The absolute path of folders being checked */
     folders: string[];
-    gitignores: Ignore;
-    regexIgnores: RegExp[];
+    /** An instantiated Ignore object listing ignored files */
+    ignored: Ignore;
 }
 interface WalkOutput {
     files: string[];

package/dist/helpers/walk-tree.js

@@ -11,7 +11,7 @@ let allFolders;
 ;
 /** Generate list of files in a directory. */
 function walk(data) {
-    const { init, commonRoot, folderRoots, folders, gitignores, regexIgnores } = data;
+    const { init, commonRoot, folderRoots, folders, ignored } = data;
     // Initialise files and folders lists
     if (init) {
         allFiles = new Set();
@@ -34,11 +34,13 @@ function walk(data) {
             // Create absolute path for disc operations
             const path = path_1.default.resolve(commonRoot, file).replace(/\\/g, '/');
             const localPath = localRoot ? file.replace(`./${localRoot}/`, '') : file.replace('./', '');
-            // Skip if nonexistant or ignored
+            // Skip if nonexistant
             const nonExistant = !fs_1.default.existsSync(path);
-            const isGitIgnored = gitignores.test(localPath).ignored;
-            const isRegexIgnored = regexIgnores.find(match => localPath.match(match));
-            if (nonExistant || isGitIgnored || isRegexIgnored)
+            if (nonExistant)
+                continue;
+            // Skip if marked as ignored
+            const isIgnored = ignored.test(localPath).ignored;
+            if (isIgnored)
                 continue;
             // Add absolute folder path to list
             allFolders.add(path_1.default.resolve(folder).replace(/\\/g, '/'));
@@ -46,7 +48,7 @@ function walk(data) {
             if (file.endsWith('/')) {
                 // Recurse into subfolders
                 allFolders.add(path);
-                walk({ init: false, commonRoot: commonRoot, folderRoots, folders: [path], gitignores, regexIgnores });
+                walk({ init: false, commonRoot, folderRoots, folders: [path], ignored });
             }
             else {
                 // Add file path to list
@@ -57,7 +59,7 @@ function walk(data) {
     // Recurse into all folders
     else {
         for (const i in folders) {
-            walk({ init: false, commonRoot: commonRoot, folderRoots: [folderRoots[i]], folders: [folders[i]], gitignores, regexIgnores });
+            walk({ init: false, commonRoot, folderRoots: [folderRoots[i]], folders: [folders[i]], ignored });
         }
     }
     // Return absolute files and folders lists

package/dist/index.js

@@ -35,13 +35,23 @@ const isbinaryfile_1 = require("isbinaryfile");
 const walk_tree_1 = __importDefault(require("./helpers/walk-tree"));
 const load_data_1 = __importStar(require("./helpers/load-data"));
 const read_file_1 = __importDefault(require("./helpers/read-file"));
+const parse_gitattributes_1 = __importDefault(require("./helpers/parse-gitattributes"));
 const convert_pcre_1 = __importDefault(require("./helpers/convert-pcre"));
-async function analyse(input, opts = {}) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s;
-    var _t, _u;
+async function analyse(rawPaths, opts = {}) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
+    var _r, _s;
     const useRawContent = opts.fileContent !== undefined;
-    input = [input !== null && input !== void 0 ? input : []].flat();
-    opts.fileContent = [(_a = opts.fileContent) !== null && _a !== void 0 ? _a : []].flat();
+    const input = [rawPaths !== null && rawPaths !== void 0 ? rawPaths : []].flat();
+    const manualFileContent = [(_a = opts.fileContent) !== null && _a !== void 0 ? _a : []].flat();
+    // Normalise input option arguments
+    opts = {
+        checkIgnored: !opts.quick,
+        checkAttributes: !opts.quick,
+        checkHeuristics: !opts.quick,
+        checkShebang: !opts.quick,
+        checkModeline: !opts.quick,
+        ...opts,
+    };
     // Load data from github-linguist web repo
     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);
@@ -52,30 +62,33 @@ async function analyse(input, opts = {}) {
     // Setup main variables
     const fileAssociations = {};
     const extensions = {};
-    const overrides = {};
+    const globOverrides = {};
     const results = {
         files: { count: 0, bytes: 0, results: {}, alternatives: {} },
         languages: { count: 0, bytes: 0, results: {} },
         unknown: { count: 0, bytes: 0, extensions: {}, filenames: {} },
     };
-    // Prepare list of ignored files
-    const gitignores = (0, ignore_1.default)();
-    const regexIgnores = [];
-    gitignores.add('.git');
-    if (!opts.keepVendored)
-        regexIgnores.push(...vendorPaths.map(path => RegExp(path, 'i')));
-    if (opts.ignoredFiles)
-        gitignores.add(opts.ignoredFiles);
     // Set a common root path so that vendor paths do not incorrectly match parent folders
     const normPath = (file) => file.replace(/\\/g, '/');
     const resolvedInput = input.map(path => normPath(path_1.default.resolve(path)));
     const commonRoot = (input.length > 1 ? (0, common_path_prefix_1.default)(resolvedInput) : resolvedInput[0]).replace(/\/?$/, '');
     const localRoot = (folder) => folder.replace(commonRoot, '').replace(/^\//, '');
-    const relPath = (file) => normPath(path_1.default.relative(commonRoot, file));
-    const unRelPath = (file) => normPath(path_1.default.resolve(commonRoot, file));
-    const localPath = (file) => localRoot(unRelPath(file));
+    const relPath = (file) => useRawContent ? file : normPath(path_1.default.relative(commonRoot, file));
+    const unRelPath = (file) => useRawContent ? file : normPath(path_1.default.resolve(commonRoot, file));
+    // Other helper functions
+    const fileMatchesGlobs = (file, ...globs) => (0, ignore_1.default)().add(globs).ignores(relPath(file));
+    const filterOutIgnored = (files, ignored) => ignored.filter(files.map(relPath)).map(unRelPath);
+    //*PREPARE FILES AND DATA*//
+    // Prepare list of ignored files
+    const ignored = (0, ignore_1.default)();
+    ignored.add('.git/');
+    ignored.add((_b = opts.ignoredFiles) !== null && _b !== void 0 ? _b : []);
+    const regexIgnores = [];
+    if (!opts.keepVendored)
+        regexIgnores.push(...vendorPaths.map(path => RegExp(path, 'i')));
     // Load file paths and folders
-    let files, folders;
+    let files;
+    let folders;
     if (useRawContent) {
         // Uses raw file content
         files = input;
@@ -83,21 +96,76 @@ async function analyse(input, opts = {}) {
     }
     else {
         // Uses directory on disc
-        const data = (0, walk_tree_1.default)({ init: true, commonRoot, folderRoots: resolvedInput, folders: resolvedInput, gitignores, regexIgnores });
+        const data = (0, walk_tree_1.default)({ init: true, commonRoot, folderRoots: resolvedInput, folders: resolvedInput, ignored });
         files = data.files;
         folders = data.folders;
     }
-    // Apply aliases
-    opts = {
-        checkIgnored: !opts.quick,
-        checkAttributes: !opts.quick,
-        checkHeuristics: !opts.quick,
-        checkShebang: !opts.quick,
-        checkModeline: !opts.quick,
-        ...opts
+    // Load gitignore data and apply ignores rules
+    if (!useRawContent && opts.checkIgnored) {
+        const nestedIgnoreFiles = files.filter(file => file.endsWith('.gitignore'));
+        for (const ignoresFile of nestedIgnoreFiles) {
+            const relIgnoresFile = relPath(ignoresFile);
+            const relIgnoresFolder = path_1.default.dirname(relIgnoresFile);
+            // Parse gitignores
+            const ignoresDataRaw = await (0, read_file_1.default)(ignoresFile);
+            const ignoresData = ignoresDataRaw.replace(/#.+|\s+$/gm, '');
+            const absoluteIgnoresData = ignoresData
+                // '.file' -> 'root/*/.file'
+                .replace(/^(?=[^\s\/\\])/gm, localRoot(relIgnoresFolder) + '/*/')
+                // '/folder' -> 'root/folder'
+                .replace(/^[\/\\]/gm, localRoot(relIgnoresFolder) + '/');
+            ignored.add(absoluteIgnoresData);
+            files = filterOutIgnored(files, ignored);
+        }
+    }
+    // Fetch and normalise gitattributes data of all subfolders and save to metadata
+    const manualAttributes = {}; // Maps file globs to gitattribute boolean flags
+    const getFlaggedGlobs = (attr, val) => {
+        return Object.entries(manualAttributes).filter(([, attrs]) => attrs[attr] === val).map(([glob,]) => glob);
     };
+    if (!useRawContent && opts.checkAttributes) {
+        const nestedAttrFiles = files.filter(file => file.endsWith('.gitattributes'));
+        for (const attrFile of nestedAttrFiles) {
+            const relAttrFile = relPath(attrFile);
+            const relAttrFolder = path_1.default.dirname(relAttrFile);
+            const contents = await (0, read_file_1.default)(attrFile);
+            const parsed = (0, parse_gitattributes_1.default)(contents, relAttrFolder);
+            for (const { glob, attrs } of parsed) {
+                manualAttributes[glob] = attrs;
+            }
+        }
+    }
+    // Apply vendor file path matches and filter out vendored files
+    if (!opts.keepVendored) {
+        // Get data of files that have been manually marked with metadata
+        const vendorTrueGlobs = [...getFlaggedGlobs('vendored', true), ...getFlaggedGlobs('generated', true), ...getFlaggedGlobs('documentation', true)];
+        const vendorFalseGlobs = [...getFlaggedGlobs('vendored', false), ...getFlaggedGlobs('generated', false), ...getFlaggedGlobs('documentation', false)];
+        // Set up glob ignore object to use for expanding globs to match files
+        const vendorTrueIgnore = (0, ignore_1.default)().add(vendorTrueGlobs);
+        const vendorFalseIgnore = (0, ignore_1.default)().add(vendorFalseGlobs);
+        // Remove all files marked as vendored by default
+        const excludedFiles = files.filter(file => vendorPaths.some(pathPtn => RegExp(pathPtn, 'i').test(relPath(file))));
+        files = files.filter(file => !excludedFiles.includes(file));
+        // Re-add removed files that are overridden manually in gitattributes
+        const overriddenExcludedFiles = excludedFiles.filter(file => vendorFalseIgnore.ignores(relPath(file)));
+        files.push(...overriddenExcludedFiles);
+        // Remove files explicitly marked as vendored in gitattributes
+        files = files.filter(file => !vendorTrueIgnore.ignores(relPath(file)));
+    }
+    // Filter out binary files
+    if (!opts.keepBinary) {
+        // Filter out files that are binary by default
+        files = files.filter(file => !binary_extensions_1.default.some(ext => file.endsWith('.' + ext)));
+        // Filter out manually specified binary files
+        const binaryIgnored = (0, ignore_1.default)().add(getFlaggedGlobs('binary', true));
+        files = filterOutIgnored(files, binaryIgnored);
+        // Re-add files manually marked not as binary
+        const binaryUnignored = (0, ignore_1.default)().add(getFlaggedGlobs('binary', false));
+        const unignoredList = filterOutIgnored(files, binaryUnignored);
+        files.push(...unignoredList);
+    }
     // Ignore specific languages
-    for (const lang of (_b = opts.ignoredLanguages) !== null && _b !== void 0 ? _b : []) {
+    for (const lang of (_c = opts.ignoredLanguages) !== null && _c !== void 0 ? _c : []) {
         for (const key in langData) {
             if (lang.toLowerCase() === key.toLowerCase()) {
                 delete langData[key];
@@ -105,71 +173,22 @@ async function analyse(input, opts = {}) {
             }
         }
     }
-    // Load gitignores and gitattributes
-    const customBinary = (0, ignore_1.default)();
-    const customText = (0, ignore_1.default)();
-    if (!useRawContent && opts.checkAttributes) {
-        for (const folder of folders) {
-            // TODO FIX: this is absolute when only 1 path given
-            const localFilePath = (path) => localRoot(folder) ? localRoot(folder) + '/' + localPath(path) : path;
-            // Skip if folder is marked in gitattributes
-            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)) {
-                const ignoresData = await (0, read_file_1.default)(ignoresFile);
-                const localIgnoresData = ignoresData.replace(/^[\/\\]/g, localRoot(folder) + '/');
-                gitignores.add(localIgnoresData);
-            }
-            // Parse gitattributes
-            const attributesFile = path_1.default.join(folder, '.gitattributes');
-            if (opts.checkAttributes && fs_1.default.existsSync(attributesFile)) {
-                const attributesData = await (0, read_file_1.default)(attributesFile);
-                // 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)) {
-                        customText.add(localFilePath(path));
-                    }
-                    if (['-text', 'binary'].includes(type)) {
-                        customBinary.add(localFilePath(path));
-                    }
-                }
-                // Custom vendor options
-                const vendorMatches = attributesData.matchAll(/^(\S+).*[^-]linguist-(vendored|generated|documentation)(?!=false)/gm);
-                for (const [_line, path] of vendorMatches) {
-                    gitignores.add(localFilePath(path));
-                }
-                // Custom file associations
-                const customLangMatches = attributesData.matchAll(/^(\S+).*[^-]linguist-language=(\S+)/gm);
-                for (let [_line, path, forcedLang] of customLangMatches) {
-                    // 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) {
-                            forcedLang = overrideLang[0];
-                        }
-                    }
-                    const fullPath = path_1.default.join(relPath(folder), path);
-                    overrides[fullPath] = forcedLang;
-                }
+    // Establish language overrides taken from gitattributes
+    const forcedLangs = Object.entries(manualAttributes).filter(([, attrs]) => attrs.language);
+    for (const [globPath, attrs] of forcedLangs) {
+        let forcedLang = attrs.language;
+        if (!forcedLang)
+            continue;
+        // 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) {
+                forcedLang = overrideLang[0];
             }
         }
+        globOverrides[globPath] = forcedLang;
     }
-    // Check vendored files
-    if (!opts.keepVendored) {
-        // Filter out any files that match a vendor file path
-        if (useRawContent) {
-            files = gitignores.filter(files);
-            files = files.filter(file => !regexIgnores.find(match => match.test(file)));
-        }
-        else {
-            files = gitignores.filter(files.map(localPath)).map(unRelPath);
-        }
-    }
-    // Load all files and parse languages
+    //*PARSE LANGUAGES*//
     const addResult = (file, result) => {
         if (!fileAssociations[file]) {
             fileAssociations[file] = [];
@@ -177,26 +196,36 @@ async function analyse(input, opts = {}) {
         }
         // Set parent to result group if it is present
         // Is nullish if either `opts.childLanguages` is set or if there is no group
-        const finalResult = !opts.childLanguages && result && langData[result].group || result;
-        if (!fileAssociations[file].includes(finalResult))
+        const finalResult = !opts.childLanguages && result && langData[result] && langData[result].group || result;
+        if (!fileAssociations[file].includes(finalResult)) {
             fileAssociations[file].push(finalResult);
+        }
         extensions[file] = path_1.default.extname(file).toLowerCase();
     };
-    const overridesArray = Object.entries(overrides);
-    // List all languages that could be associated with a given file
     const definiteness = {};
     const fromShebang = {};
-    for (const file of files) {
+    fileLoop: for (const file of files) {
+        // Check manual override
+        for (const globMatch in globOverrides) {
+            if (!fileMatchesGlobs(file, globMatch))
+                continue;
+            // If the given file matches the glob, apply the override to the file
+            const forcedLang = globOverrides[globMatch];
+            addResult(file, forcedLang);
+            definiteness[file] = true;
+            continue fileLoop; // no need to check other heuristics, the classified language has been found
+        }
+        // Check first line for readability
         let firstLine;
         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;
+            firstLine = (_e = (_d = manualFileContent[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()) {
             firstLine = await (0, read_file_1.default)(file, true).catch(() => null);
         }
         else
             continue;
-        // Skip if file is unreadable
+        // Skip if file is unreadable or blank
         if (firstLine === null)
             continue;
         // Check first line for explicit classification
@@ -231,17 +260,6 @@ async function analyse(input, opts = {}) {
                 continue;
             }
         }
-        // Check override for manual language classification
-        if (!useRawContent && !opts.quick && opts.checkAttributes) {
-            const isOverridden = (path) => (0, ignore_1.default)().add(path).ignores(relPath(file));
-            const match = overridesArray.find(item => isOverridden(item[0]));
-            if (match) {
-                const forcedLang = match[1];
-                addResult(file, forcedLang);
-                definiteness[file] = true;
-                continue;
-            }
-        }
         // Search each language
         let skipExts = false;
         // Check if filename is a match
@@ -286,12 +304,8 @@ async function analyse(input, opts = {}) {
         }
         // Skip binary files
         if (!useRawContent && !opts.keepBinary) {
-            const isCustomText = customText.ignores(relPath(file));
-            const isCustomBinary = customBinary.ignores(relPath(file));
-            const isBinaryExt = binary_extensions_1.default.some(ext => file.endsWith('.' + ext));
-            if (!isCustomText && (isCustomBinary || isBinaryExt || await (0, isbinaryfile_1.isBinaryFile)(file))) {
+            if (await (0, isbinaryfile_1.isBinaryFile)(file))
                 continue;
-            }
         }
         // Parse heuristics if applicable
         if (opts.checkHeuristics)
@@ -327,7 +341,7 @@ async function analyse(input, opts = {}) {
                         }
                     }
                     // Check file contents and apply heuristic patterns
-                    const fileContent = ((_l = opts.fileContent) === null || _l === void 0 ? void 0 : _l.length) ? opts.fileContent[files.indexOf(file)] : await (0, read_file_1.default)(file).catch(() => null);
+                    const fileContent = opts.fileContent ? manualFileContent[files.indexOf(file)] : await (0, read_file_1.default)(file).catch(() => null);
                     // Skip if file read errors
                     if (fileContent === null)
                         continue;
@@ -351,7 +365,7 @@ async function analyse(input, opts = {}) {
         }
     }
     // Skip specified categories
-    if ((_m = opts.categories) === null || _m === void 0 ? void 0 : _m.length) {
+    if ((_l = opts.categories) === null || _l === void 0 ? void 0 : _l.length) {
         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)) {
@@ -387,21 +401,21 @@ async function analyse(input, opts = {}) {
     for (const [file, lang] of Object.entries(results.files.results)) {
         if (lang && !langData[lang])
             continue;
-        const fileSize = (_q = (_p = (_o = opts.fileContent) === null || _o === void 0 ? void 0 : _o[files.indexOf(file)]) === null || _p === void 0 ? void 0 : _p.length) !== null && _q !== void 0 ? _q : fs_1.default.statSync(file).size;
+        const fileSize = (_o = (_m = manualFileContent[files.indexOf(file)]) === null || _m === void 0 ? void 0 : _m.length) !== null && _o !== void 0 ? _o : fs_1.default.statSync(file).size;
         results.files.bytes += fileSize;
         // If no language found, add extension in other section
         if (!lang) {
             const ext = path_1.default.extname(file);
             const unknownType = ext === '' ? 'filenames' : 'extensions';
             const name = ext === '' ? path_1.default.basename(file) : ext;
-            (_r = (_t = results.unknown[unknownType])[name]) !== null && _r !== void 0 ? _r : (_t[name] = 0);
+            (_p = (_r = results.unknown[unknownType])[name]) !== null && _p !== void 0 ? _p : (_r[name] = 0);
             results.unknown[unknownType][name] += fileSize;
             results.unknown.bytes += fileSize;
             continue;
         }
         // Add language and bytes data to corresponding section
         const { type } = langData[lang];
-        (_s = (_u = results.languages.results)[lang]) !== null && _s !== void 0 ? _s : (_u[lang] = { type, bytes: 0, color: langData[lang].color });
+        (_q = (_s = results.languages.results)[lang]) !== null && _q !== void 0 ? _q : (_s[lang] = { type, bytes: 0, color: langData[lang].color });
         if (opts.childLanguages) {
             results.languages.results[lang].parent = langData[lang].group;
         }

package/dist/types.d.ts

@@ -4,6 +4,10 @@ export type Category = 'data' | 'markup' | 'programming' | 'prose';
 export type FilePath = string;
 export type Bytes = Integer;
 export type Integer = number;
+export type RelFile = string & {};
+export type AbsFile = string & {};
+export type AbsFolder = string & {};
+export type FileGlob = string & {};
 export interface Options {
     fileContent?: string | string[];
     ignoredFiles?: string[];

package/ext/generated.rb

@@ -22,3 +22,4 @@
 - ppport\.h$
 - __generated__\/
 - _tlb\.pas$
+- (?:^|\/)htmlcov\/

package/ext/heuristics.yml

@@ -45,7 +45,7 @@ disambiguations:
   - language: Public Key
     pattern: '^(----[- ]BEGIN|ssh-(rsa|dss)) '
   - language: AsciiDoc
-    pattern: '^[=-]+(\s|\n)|\{\{[A-Za-z]'
+    pattern: '^[=-]+\s|\{\{[A-Za-z]'
   - language: AGS Script
     pattern: '^(\/\/.+|((import|export)\s+)?(function|int|float|char)\s+((room|repeatedly|on|game)_)?([A-Za-z]+[A-Za-z_0-9]+)\s*[;\(])'
 - extensions: ['.asm']
@@ -101,6 +101,8 @@ disambiguations:
     - (?i:^\s*(end\ssub)$)
     - (?i:^\s*(?=^function\s)(?:function\s*\w+\(.*?\)\s*as\s*\w*)|(?::\s*function\(.*?\)\s*as\s*\w*)$)
     - (?i:^\s*(end\sfunction)$)
+  - language: Bluespec BH
+    pattern: '^package\s+[A-Za-z_][A-Za-z0-9_'']*(?:\s*\(|\s+where)'
 - extensions: ['.builds']
   rules:
   - language: XML
@@ -132,7 +134,7 @@ disambiguations:
 - extensions: ['.cmp']
   rules:
   - language: Gerber Image
-    pattern: '^[DGMT][0-9]{2}\*\r?\n'
+    pattern: '^[DGMT][0-9]{2}\*(?:\r?\n|\r)'
 - extensions: ['.cs']
   rules:
   - language: Smalltalk
@@ -242,7 +244,7 @@ disambiguations:
 - extensions: ['.ftl']
   rules:
   - language: FreeMarker
-    pattern: '^(?:<|[a-zA-Z-][a-zA-Z0-9_-]+[ \t]+\w)|\$\{\w+[^\n]*?\}|^[ \t]*(?:<#--.*?-->|<#([a-z]+)(?=\s|>)[^>]*>.*?</#\1>|\[#--.*?--\]|\[#([a-z]+)(?=\s|\])[^\]]*\].*?\[#\2\])'
+    pattern: '^(?:<|[a-zA-Z-][a-zA-Z0-9_-]+[ \t]+\w)|\$\{\w+[^\r\n]*?\}|^[ \t]*(?:<#--.*?-->|<#([a-z]+)(?=\s|>)[^>]*>.*?</#\1>|\[#--.*?--\]|\[#([a-z]+)(?=\s|\])[^\]]*\].*?\[#\2\])'
   - language: Fluent
     pattern: '^-?[a-zA-Z][a-zA-Z0-9_-]* *=|\{\$-?[a-zA-Z][-\w]*(?:\.[a-zA-Z][-\w]*)?\}'
 - extensions: ['.g']
@@ -250,7 +252,7 @@ disambiguations:
   - language: GAP
     pattern: '\s*(Declare|BindGlobal|KeyDependentOperation|Install(Method|GlobalFunction)|SetPackageInfo)'
   - language: G-code
-    pattern: '^[MG][0-9]+\n'
+    pattern: '^[MG][0-9]+(?:\r?\n|\r)'
 - extensions: ['.gd']
   rules:
   - language: GAP
@@ -350,6 +352,12 @@ disambiguations:
     pattern: '^\.[A-Za-z]{2}(\s|$)'
   - language: PicoLisp
     pattern: '^\((de|class|rel|code|data|must)\s'
+- extensions: ['.lean']
+  rules:
+  - language: Lean
+    pattern: '^import [a-z]'
+  - language: Lean 4
+    pattern: '^import [A-Z]'
 - extensions: ['.ls']
   rules:
   - language: LoomScript
@@ -395,7 +403,7 @@ disambiguations:
   - language: Win32 Message File
     pattern: '(?i)^[ \t]*(?>\/\*\s*)?MessageId=|^\.$'
   - language: M4
-    pattern: '^dnl|^divert\((?:-?\d+)?\)|^\w+\(`[^\n]*?''[),]'
+    pattern: '^dnl|^divert\((?:-?\d+)?\)|^\w+\(`[^\r\n]*?''[),]'
   - language: Monkey C
     pattern: '\b(?:using|module|function|class|var)\s+\w'
 - extensions: ['.md']
@@ -440,7 +448,7 @@ disambiguations:
   - language: XML
     pattern: '^\s*<\?xml\s+version'
   - language: Gerber Image
-    pattern: '^[DGMT][0-9]{2}\*\r?\n'
+    pattern: '^[DGMT][0-9]{2}\*(?:\r?\n|\r)'
   - language: Text
     pattern: 'THE_TITLE'
 - extensions: ['.nl']
@@ -504,7 +512,7 @@ disambiguations:
 - extensions: ['.pod']
   rules:
   - language: Pod 6
-    pattern: '^[\s&&[^\n]]*=(comment|begin pod|begin para|item\d+)'
+    pattern: '^[\s&&[^\r\n]]*=(comment|begin pod|begin para|item\d+)'
   - language: Pod
 - extensions: ['.pp']
   rules:
@@ -543,7 +551,7 @@ disambiguations:
 - extensions: ['.q']
   rules:
   - language: q
-    pattern: '((?i:[A-Z.][\w.]*:\{)|(^|\n)\\(cd?|d|l|p|ts?) )'
+    pattern: '((?i:[A-Z.][\w.]*:\{)|^\\(cd?|d|l|p|ts?) )'
   - language: HiveQL
     pattern: '(?i:SELECT\s+[\w*,]+\s+FROM|(CREATE|ALTER|DROP)\s(DATABASE|SCHEMA|TABLE))'
 - extensions: ['.qs']
@@ -556,6 +564,8 @@ disambiguations:
   rules:
   - language: Rebol
     pattern: '(?i:\bRebol\b)'
+  - language: Rez
+    pattern: '(#include\s+["<](Types\.r|Carbon\/Carbon\.r)[">])|((resource|data|type)\s+''[A-Za-z0-9]{4}''\s+((\(.*\)\s+){0,1}){)'
   - language: R
     pattern: '<-|^\s*#'
 - extensions: ['.re']
@@ -615,7 +625,7 @@ disambiguations:
   - language: Solidity
     pattern: '\bpragma\s+solidity\b|\b(?:abstract\s+)?contract\s+(?!\d)[a-zA-Z0-9$_]+(?:\s+is\s+(?:[a-zA-Z0-9$_][^\{]*?)?)?\s*\{'
   - language: Gerber Image
-    pattern: '^[DGMT][0-9]{2}\*\r?\n'
+    pattern: '^[DGMT][0-9]{2}\*(?:\r?\n|\r)'
 - extensions: ['.sql']
   rules:
   - language: PLpgSQL
@@ -645,7 +655,7 @@ disambiguations:
 - extensions: ['.stl']
   rules:
   - language: STL
-    pattern: '\A\s*solid(?=$|\s)(?:.|[\r\n])*?^endsolid(?:$|\s)'
+    pattern: '\A\s*solid(?:$|\s)[\s\S]*^endsolid(?:$|\s)'
 - extensions: ['.sw']
   rules:
   - language: Sway
@@ -699,10 +709,15 @@ disambiguations:
   - language: Adblock Filter List
     pattern: '\A\[(?<version>(?:[Aa]d[Bb]lock(?:[ \t][Pp]lus)?|u[Bb]lock(?:[ \t][Oo]rigin)?|[Aa]d[Gg]uard)(?:[ \t] \d+(?:\.\d+)*+)?)(?:[ \t]?;[ \t]?\g<version>)*+\]'
   - language: Text
+- extensions: ['.typ']
+  rules:
+  - language: Typst
+    pattern: '^#(import|show|let|set)'
+  - language: XML
 - extensions: ['.url']
   rules:
   - language: INI
-    pattern: '^\[InternetShortcut\](?:\r?\n|\r)(?>[^\s\[][^\n]*(?:\r?\n|\r))*URL='
+    pattern: '^\[InternetShortcut\](?:\r?\n|\r)(?>[^\s\[][^\r\n]*(?:\r?\n|\r))*URL='
 - extensions: ['.v']
   rules:
   - language: Coq

package/ext/languages.yml

@@ -606,9 +606,28 @@ Bluespec:
   color: "#12223c"
   extensions:
   - ".bsv"
+  aliases:
+  - bluespec bsv
+  - bsv
   tm_scope: source.bsv
   ace_mode: verilog
+  codemirror_mode: verilog
+  codemirror_mime_type: text/x-systemverilog
   language_id: 36
+Bluespec BH:
+  type: programming
+  group: Bluespec
+  color: "#12223c"
+  extensions:
+  - ".bs"
+  aliases:
+  - bh
+  - bluespec classic
+  tm_scope: source.haskell
+  ace_mode: haskell
+  codemirror_mode: haskell
+  codemirror_mime_type: text/x-haskell
+  language_id: 641580358
 Boo:
   type: programming
   color: "#d4bec1"
@@ -1607,7 +1626,7 @@ ECL:
 ECLiPSe:
   type: programming
   color: "#001d9d"
-  group: prolog
+  group: Prolog
   extensions:
   - ".ecl"
   tm_scope: source.prolog.eclipse
@@ -1689,6 +1708,17 @@ Ecmarkup:
   aliases:
   - ecmarkdown
   language_id: 844766630
+EdgeQL:
+  type: programming
+  color: "#31A7FF"
+  aliases:
+  - esdl
+  extensions:
+  - ".edgeql"
+  - ".esdl"
+  ace_mode: text
+  tm_scope: source.edgeql
+  language_id: 925235833
 EditorConfig:
   type: data
   color: "#fff1f2"
@@ -2144,6 +2174,7 @@ GLSL:
   - ".tese"
   - ".vert"
   - ".vrx"
+  - ".vs"
   - ".vsh"
   - ".vshader"
   tm_scope: source.glsl
@@ -2205,20 +2236,20 @@ Gemini:
   wrap: true
   tm_scope: source.gemini
   language_id: 310828396
-Genero:
+Genero 4gl:
   type: programming
   color: "#63408e"
   extensions:
   - ".4gl"
-  tm_scope: source.genero
+  tm_scope: source.genero-4gl
   ace_mode: text
   language_id: 986054050
-Genero Forms:
+Genero per:
   type: markup
   color: "#d8df39"
   extensions:
   - ".per"
-  tm_scope: source.genero-forms
+  tm_scope: source.genero-per
   ace_mode: text
   language_id: 902995658
 Genie:
@@ -2316,7 +2347,6 @@ Gherkin:
 Git Attributes:
   type: data
   color: "#F44D27"
-  group: INI
   aliases:
   - gitattributes
   filenames:
@@ -2361,6 +2391,15 @@ Gleam:
   - ".gleam"
   tm_scope: source.gleam
   language_id: 1054258749
+Glimmer JS:
+  type: programming
+  extensions:
+  - ".gjs"
+  ace_mode: javascript
+  color: "#F5835F"
+  tm_scope: source.gjs
+  group: JavaScript
+  language_id: 5523150
 Glyph:
   type: programming
   color: "#c1ac7f"
@@ -2489,6 +2528,15 @@ Gradle:
   tm_scope: source.groovy.gradle
   ace_mode: text
   language_id: 136
+Gradle Kotlin DSL:
+  group: Gradle
+  type: data
+  color: "#02303a"
+  extensions:
+  - ".gradle.kts"
+  ace_mode: text
+  tm_scope: source.kotlin
+  language_id: 432600901
 Grammatical Framework:
   type: programming
   aliases:
@@ -2603,8 +2651,8 @@ HOCON:
   extensions:
   - ".hocon"
   filenames:
-  - .scalafix.conf
-  - .scalafmt.conf
+  - ".scalafix.conf"
+  - ".scalafmt.conf"
   tm_scope: source.hocon
   ace_mode: text
   language_id: 679725279
@@ -2812,6 +2860,8 @@ Hosts File:
   filenames:
   - HOSTS
   - hosts
+  aliases:
+  - hosts
   tm_scope: source.hosts
   ace_mode: text
   language_id: 231021894
@@ -2910,7 +2960,6 @@ Idris:
 Ignore List:
   type: data
   color: "#000000"
-  group: INI
   aliases:
   - ignore
   - gitignore
@@ -3104,6 +3153,7 @@ JSON:
   - ".watchmanconfig"
   - Pipfile.lock
   - composer.lock
+  - deno.lock
   - flake.lock
   - mcmod.info
   language_id: 174
@@ -3120,6 +3170,7 @@ JSON with Comments:
   extensions:
   - ".jsonc"
   - ".code-snippets"
+  - ".code-workspace"
   - ".sublime-build"
   - ".sublime-commands"
   - ".sublime-completions"
@@ -3623,6 +3674,14 @@ Lean:
   tm_scope: source.lean
   ace_mode: text
   language_id: 197
+Lean 4:
+  type: programming
+  group: Lean
+  extensions:
+  - ".lean"
+  tm_scope: source.lean4
+  ace_mode: text
+  language_id: 455147478
 Less:
   type: markup
   color: "#1d365d"
@@ -4374,7 +4433,7 @@ Nasal:
   extensions:
   - ".nas"
   tm_scope: source.nasal
-  ace_mode: text
+  ace_mode: nasal
   language_id: 178322513
 Nearley:
   type: programming
@@ -4823,6 +4882,8 @@ Option List:
   - ackrc
   filenames:
   - ".ackrc"
+  - ".rspec"
+  - ".yardopts"
   - ackrc
   - mocha.opts
   tm_scope: source.opts
@@ -5101,6 +5162,8 @@ Pic:
   extensions:
   - ".pic"
   - ".chem"
+  aliases:
+  - pikchr
   ace_mode: text
   codemirror_mode: troff
   codemirror_mime_type: text/troff
@@ -5257,6 +5320,14 @@ PowerShell:
   interpreters:
   - pwsh
   language_id: 293
+Praat:
+  type: programming
+  color: "#c8506d"
+  tm_scope: source.praat
+  ace_mode: praat
+  extensions:
+  - ".praat"
+  language_id: 106029007
 Prisma:
   type: data
   color: "#0c344b"
@@ -5851,6 +5922,14 @@ RenderScript:
   tm_scope: none
   ace_mode: text
   language_id: 323
+Rez:
+  type: programming
+  extensions:
+  - ".r"
+  tm_scope: source.rez
+  ace_mode: text
+  color: "#FFDAB3"
+  language_id: 498022874
 Rich Text Format:
   type: markup
   extensions:
@@ -6740,7 +6819,7 @@ Svelte:
   language_id: 928734530
 Sway:
   type: programming
-  color: "#dea584"
+  color: "#00F58C"
   extensions:
   - ".sw"
   tm_scope: source.sway
@@ -6748,6 +6827,14 @@ Sway:
   codemirror_mode: rust
   codemirror_mime_type: text/x-rustsrc
   language_id: 271471144
+Sweave:
+  type: prose
+  color: "#198ce7"
+  extensions:
+  - ".rnw"
+  tm_scope: text.tex.latex.sweave
+  ace_mode: tex
+  language_id: 558779190
 Swift:
   type: programming
   color: "#F05138"
@@ -6784,7 +6871,7 @@ TI Program:
 TL-Verilog:
   type: programming
   extensions:
-    - ".tlv"
+  - ".tlv"
   tm_scope: source.tlverilog
   ace_mode: verilog
   color: "#C40023"
@@ -6939,6 +7026,17 @@ Terra:
   interpreters:
   - lua
   language_id: 371
+Terraform Template:
+  type: markup
+  extensions:
+  - ".tftpl"
+  color: "#7b42bb"
+  tm_scope: source.hcl.terraform
+  ace_mode: ruby
+  codemirror_mode: ruby
+  codemirror_mime_type: text/x-ruby
+  group: HCL
+  language_id: 856832701
 Texinfo:
   type: prose
   wrap: true
@@ -7023,6 +7121,14 @@ Thrift:
   - ".thrift"
   ace_mode: text
   language_id: 374
+Toit:
+  type: programming
+  color: "#c2c9fb"
+  extensions:
+  - ".toit"
+  tm_scope: source.toit
+  ace_mode: text
+  language_id: 356554395
 Turing:
   type: programming
   color: "#cf142b"
@@ -7077,6 +7183,16 @@ TypeScript:
   codemirror_mode: javascript
   codemirror_mime_type: application/typescript
   language_id: 378
+Typst:
+  type: programming
+  color: "#239dad"
+  aliases:
+  - typ
+  extensions:
+  - ".typ"
+  tm_scope: source.typst
+  ace_mode: text
+  language_id: 704730682
 Unified Parallel C:
   type: programming
   color: "#4e3617"
@@ -7687,6 +7803,7 @@ XML:
   - ".tml"
   - ".ts"
   - ".tsx"
+  - ".typ"
   - ".ui"
   - ".urdf"
   - ".ux"

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "linguist-js",
-	"version": "2.6.1",
+	"version": "2.7.0",
 	"description": "Analyse languages used in a folder. Powered by GitHub Linguist, although it doesn't need to be installed.",
 	"main": "dist/index.js",
 	"bin": {
@@ -42,13 +42,13 @@
 		"commander": "^9.5.0 <10",
 		"common-path-prefix": "^3.0.0",
 		"cross-fetch": "^3.1.8 <4",
-		"ignore": "^5.2.4",
+		"ignore": "^5.3.1",
 		"isbinaryfile": "^4.0.10 <5",
 		"js-yaml": "^4.1.0",
 		"node-cache": "^5.1.2"
 	},
 	"devDependencies": {
-		"@types/js-yaml": "^4.0.5",
+		"@types/js-yaml": "^4.0.9",
 		"@types/node": "ts5.0",
 		"deep-object-diff": "^1.1.9",
 		"typescript": "~5.0.4 <5.1"

package/readme.md

@@ -95,9 +95,17 @@ Running LinguistJS on this folder will return the following JSON:
 
 ```js
 const linguist = require('linguist-js');
-let folder = './src';
-let options = { keepVendored: false, quick: false };
-const { files, languages, unknown } = linguist(folder, options);
+
+// Analyse folder on disc
+const folder = './src';
+const options = { keepVendored: false, quick: false };
+const { files, languages, unknown } = await linguist(folder, options);
+
+// Analyse file content from raw input
+const fileNames = ['file1.ts', 'file2.ts', 'ignoreme.js'];
+const fileContent = ['#!/usr/bin/env node', 'console.log("Example");', '"ignored"'];
+const options = { ignoredFiles: ['ignore*'] };
+const { files, languages, unknown } = await linguist(fileNames, { fileContent, ...options });
 ```
 
 - `linguist(entry?, opts?)` (default export):
@@ -122,7 +130,7 @@ const { files, languages, unknown } = linguist(folder, options);
       Alias for `checkAttributes:false, checkIgnored:false, checkHeuristics:false, checkShebang:false, checkModeline:false`.
     - `offline` (boolean):
       Whether to use pre-packaged metadata files instead of fetching them from GitHub at runtime (defaults to `false`).
-	- `keepVendored` (boolean):
+    - `keepVendored` (boolean):
       Whether to keep vendored files (dependencies, etc) (defaults to `false`).
       Does nothing when `fileContent` is set.
     - `keepBinary` (boolean):
@@ -160,14 +168,20 @@ linguist --version
     A list of languages to exclude from the output.
   - `--categories <categories...>`:
     A list of language categories that should be displayed in the output.
-	Must be one or more of `data`, `prose`, `programming`, `markup`.
+    Must be one or more of `data`, `prose`, `programming`, `markup`.
   - `--childLanguages`:
     Display sub-languages instead of their parents, when possible.
   - `--json`:
+    Only affects the CLI output.
     Display the outputted language data as JSON.
   - `--tree <traversal>`:
+    Only affects the CLI output.
     A dot-delimited traversal to the nested object that should be logged to the console instead of the entire output.
     Requires `--json` to be specified.
+  - `--listFiles`:
+    Only affects the visual CLI output.
+    List each matching file and its size under each outputted language result.
+    Does nothing if `--json` is specified.
   - `--quick`:
     Skip the checking of `.gitattributes` and `.gitignore` files for manual language classifications.
     Alias for `--checkAttributes=false --checkIgnored=false --checkHeuristics=false --checkShebang=false --checkModeline=false`.