debugability

Author: Alexey Litvinov

README.md

@@ -228,6 +228,7 @@ Short alias for the [postcss-modules-local-by-default](https://github.com/css-mo
 
 [debug](https://www.npmjs.com/package/debug) package is used for debugging. So to turn it on simply specify the **DEBUG** environment variable:
 - `DEBUG=css-modules:fetch` — to see resolved paths to the files.
+- `DEBUG=css-modules:preset` — to see whether config was found or not.
 - `DEBUG=css-modules:setup` — to see the new options list.
 - `DEBUG=css-modules:*` — to see everything.
 

lib/index.js

@@ -17,21 +17,8 @@ const ExtractImports = require('postcss-modules-extract-imports');
 const Scope = require('postcss-modules-scope');
 const Parser = require('postcss-modules-parser');
 
-/**
- * @param  {function|regex|string} ignore glob, regex or function
- * @return {function}
- */
-function buildExceptionChecker(ignore) {
-  if (ignore instanceof RegExp) {
-    return filepath => ignore.test(filepath);
-  }
-
-  if (typeof ignore === 'string') {
-    return filepath => globToRegex(ignore).test(filepath);
-  }
-
-  return ignore || negate(identity);
-}
+const debugFetch = require('debug')('css-modules:fetch');
+const debugSetup = require('debug')('css-modules:setup');
 
 module.exports = function setupHook({
   extensions = '.css',
@@ -47,6 +34,7 @@ module.exports = function setupHook({
   use,
   rootDir: context = process.cwd(),
 }) {
+  debugSetup(arguments[0]);
   validate(arguments[0]);
 
   const tokensByFile = {};
@@ -93,9 +81,12 @@ module.exports = function setupHook({
       ? require.resolve(_to)
       : resolve(dirname(from), _to);
 
+
     // checking cache
     let tokens = tokensByFile[filename];
     if (tokens) {
+      debugFetch(`${filename} → cache`);
+      debugFetch(tokens);
       return tokens;
     }
 
@@ -120,10 +111,29 @@ module.exports = function setupHook({
       processCss(lazyResult.css, filename);
     }
 
+    debugFetch(`${filename} → fs`);
+    debugFetch(tokens);
+
     return tokens;
   };
 
   const isException = buildExceptionChecker(ignore);
 
   attachHook(filename => fetch(filename, filename), '.css', isException);
 };
+
+/**
+ * @param  {function|regex|string} ignore glob, regex or function
+ * @return {function}
+ */
+function buildExceptionChecker(ignore) {
+  if (ignore instanceof RegExp) {
+    return filepath => ignore.test(filepath);
+  }
+
+  if (typeof ignore === 'string') {
+    return filepath => globToRegex(ignore).test(filepath);
+  }
+
+  return ignore || negate(identity);
+}

preset.js

@@ -1,10 +1,15 @@
+const debug = require('debug')('css-modules:preset');
 const dirname = require('path').dirname;
 const hook = require('.');
 const seekout = require('seekout');
 
+debug('→ cmrh.conf.js');
 const preset = seekout('cmrh.conf.js', dirname(module.parent.filename));
+
 if (!preset) {
-  throw new Error('Unable to find cmrh.conf.js');
+  debug('failure');
+  return void hook({});
 }
 
+debug('success');
 hook(require(preset));