Add main (programmatic API)

Author: Peter554

README.md

@@ -8,12 +8,14 @@ A CSS utility class generator. User friendly, simple, powerful. Inspired by [tai
 
 ## Usage
 
-- `cssutils --help`
+- `cssutils --help` (CLI)
+- `const cssutils = require("@peter554/cssutils")` (API)
 - Check out the tests for the full features.
 
 ### CSS variables
 
 - `cssutils variables --config ./config.yml`
+- `cssutils.variables({configPath: "./config.yml"})`
 
 ```yml
 variables:
@@ -35,6 +37,7 @@ variables:
 ### SASS/SCSS variables
 
 - `cssutils sassvariables --config ./config.yml`
+- `cssutils.sassVariables({configPath: "./config.yml"})`
 
 ```yml
 variables:
@@ -56,6 +59,7 @@ $color-red: #f00;
 ### Utility classes
 
 - `cssutils utilities --config ./config.yml`
+- `cssutils.utilities({configPath: "./config.yml"})`
 
 ```yml
 variables:

package.json

@@ -1,7 +1,8 @@
 {
   "name": "@peter554/cssutils",
-  "version": "0.12.0",
+  "version": "0.14.1",
   "description": "CSS utility class generator. User friendly, simple, powerful.",
+  "main": "./src/main.js",
   "keywords": [
     "css",
     "functional css",

src/cli.js

@@ -5,10 +5,8 @@ const { resolve, dirname } = require("path");
 
 const { program } = require("commander");
 const { mkdir } = require("shelljs");
-const CleanCSS = require("clean-css");
 
 const { getConfig } = require("./getConfig");
-const log = require("./logging");
 const { generateVariables } = require("./generators/generateVariables");
 const { generateSassVariables } = require("./generators/generateSassVariables");
 const { generateUtilities } = require("./generators/generateUtilities");
@@ -33,7 +31,7 @@ program
       const output = resolve(cmd.output);
       mkdir("-p", dirname(output));
       writeFileSync(output, css);
-      log.success(`CSS has been written to ${output}.`);
+      console.log(`CSS has been written to ${output}.`);
     } else {
       console.log(css);
     }
@@ -57,7 +55,7 @@ program
       const output = resolve(cmd.output);
       mkdir("-p", dirname(output));
       writeFileSync(output, sass);
-      log.success(`SASS has been written to ${output}.`);
+      console.log(`SASS has been written to ${output}.`);
     } else {
       console.log(sass);
     }
@@ -82,7 +80,7 @@ program
       const output = resolve(cmd.output);
       mkdir("-p", dirname(output));
       writeFileSync(output, css);
-      log.success(`CSS has been written to ${output}.`);
+      console.log(`CSS has been written to ${output}.`);
     } else {
       console.log(css);
     }

src/getConfig.js

@@ -4,14 +4,11 @@ const { resolve, extname } = require("path");
 const YAML = require("yaml");
 const { cosmiconfigSync } = require("cosmiconfig");
 
-const log = require("./logging");
-
 const getConfig = (configPath) => {
   if (configPath) {
     config = resolve(configPath);
     if (!existsSync(config)) {
-      log.error(`Configuration file ${config} does not exist.`);
-      process.exit(1);
+      throw Error(`Configuration file ${config} does not exist.`);
     }
     config = readFileSync(config, "utf8");
     return extname(config) == ".json" ? JSON.parse(config) : YAML.parse(config);
@@ -21,8 +18,7 @@ const getConfig = (configPath) => {
     });
     const searchResult = explorer.search();
     if (!searchResult) {
-      log.error(`Configuration file discovery failed.`);
-      process.exit(1);
+      throw Error(`Configuration file discovery failed.`);
     }
     return searchResult.config;
   }

src/logging.js

@@ -0,0 +1,20 @@
+const { getConfig } = require("./getConfig");
+const { generateVariables } = require("./generators/generateVariables");
+const { generateSassVariables } = require("./generators/generateSassVariables");
+const { generateUtilities } = require("./generators/generateUtilities");
+
+module.exports = {
+  variables: ({ configPath } = {}) => {
+    const config = getConfig(configPath);
+    return generateVariables(config);
+  },
+  utilities: ({ configPath, noSubstitute } = {}) => {
+    const substitute = !noSubstitute;
+    const config = getConfig(configPath);
+    return generateUtilities(config, substitute);
+  },
+  sassVariables: ({ configPath } = {}) => {
+    const config = getConfig(configPath);
+    return generateSassVariables(config);
+  },
+};