poops 1.9.2 → 1.9.4

package/README.md

@@ -110,6 +110,7 @@ or pass a custom config. This is useful when you have multiple environments:
 | `--port <number>`            | `-p`  | Specify the server port, overrides config            |
 | `--livereload-port <number>` | `-l`  | Specify the livereload port, overrides config        |
 | `--base-url <path>`          | `-u`  | Set the base URL prefix for markup, overrides config |
+| `--quiet`                    | `-q`  | Hide the header and the server/livereload info lines |
 
 The `--base-url` flag is particularly useful for CI/CD pipelines where the deploy path may differ per environment:
 
@@ -117,6 +118,14 @@ The `--base-url` flag is particularly useful for CI/CD pipelines where the deplo
 poops --build --base-url /blog
 ```
 
+The `--quiet` flag drops the `💩 Poops — vX.Y.Z` header (and its terminal bell) plus the `Local server` / `Network` / `LiveReload` lines. Handy when you run several Poops instances side by side and only want to see which one is compiling:
+
+```bash
+poops -q & poops -q -c site/poops.json
+```
+
+Build logs, warnings and errors are unaffected — `--quiet` only removes the banner.
+
 If you have installed Poops locally you can run it with `npx poops` or `npx 💩` or add a script to your `package.json`:
 
 ```json

package/lib/utils/minify.js

@@ -37,5 +37,7 @@ export default async function minifyToFile({ outfilePath, loader, code, banner,
     console.error(err)
   }
 
-  if (options.justMinified) fs.unlinkSync(outfilePath)
+  // The unminified file only exists on disk when a compiler wrote it there —
+  // watch rebuilds pass `code` in memory and there is nothing to delete.
+  if (options.justMinified && pathExists(outfilePath)) fs.unlinkSync(outfilePath)
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "poops",
   "description": "Straightforward, no-bullshit bundler for the web.",
-  "version": "1.9.2",
+  "version": "1.9.4",
   "license": "MIT",
   "type": "module",
   "main": "poops.js",

package/poops.js

@@ -30,6 +30,7 @@ const cli = new Argoyle(pkg.version)
   .option('port', { short: 'p', value: '<number>', description: 'Specify the port for the server, overrides the config file' })
   .option('livereload-port', { short: 'l', value: '<number>', description: 'Specify the port for the livereload server, overrides the config file' })
   .option('base-url', { short: 'u', value: '<path>', description: 'Set the base URL prefix for markup, overrides the config file' })
+  .option('quiet', { short: 'q', description: 'Hide the header and the server/livereload info lines' })
 
 let flags, positionals
 try {
@@ -44,6 +45,7 @@ const defaultConfigPath = flags.config || positionals[0] || 'poops.json'
 const overridePort = flags.port
 const overrideLivereloadPort = flags['livereload-port']
 const overrideBaseURL = flags['base-url']
+const quiet = flags.quiet // hides the header and the address lines only — build logs, warnings and errors still print
 
 let configPath = path.join(cwd, defaultConfigPath)
 if (!pathExists(configPath)) configPath = path.join(cwd, '💩.json') // the canonical alternative config name
@@ -107,7 +109,7 @@ const hook = (stage) => runExec(config, cwd, stage)
 function setupLiveReloadServer(config) {
   if (!config.livereload) return
   liveReloadServer = livereload.createServer({ port: config.livereload_port })
-  styledLog(`🔃 {dim}LiveReload  :{/} ${liveReloadServer.config.port}`)
+  if (!quiet) styledLog(`🔃 {dim}LiveReload  :{/} ${liveReloadServer.config.port}`)
   console.log()
 }
 
@@ -137,6 +139,44 @@ function setupWatchers(config, modules) {
     .filter((zone) => zone && zone !== '.')
   const isBuildOutput = (file) => outputZones.some((zone) => pathContainsPathSegment(file, zone))
 
+  // One chokidar event fires per written file, so a single build that writes
+  // several outputs into a watched dir (css + map + min.css) triggers the same
+  // rebuild branch once per file. The trailing debounce folds such a burst
+  // into one run; the window collects the paths so the handler can still
+  // reason per-file (the copy branch's css hot-swap vs full reload). 300ms:
+  // outlives the 150ms awaitWriteFinish settle between files of one burst.
+  const coalesce = (fn, ms = 300) => {
+    let timer
+    const files = new Set()
+    return (file) => {
+      files.add(file)
+      clearTimeout(timer)
+      timer = setTimeout(() => {
+        const batch = [...files]
+        files.clear()
+        fn(batch)
+      }, ms)
+    }
+  }
+
+  const recompileStyles = coalesce(() => {
+    modules.styles.compile().then(() => modules.postcss.compile())
+      .then(() => { hook('styles'); styleOutputs(config).forEach((out) => reload(out)) })
+      .catch(err => console.error(err))
+  })
+
+  // A copied .css (e.g. the styles compiler's own output landing in a copy
+  // source) stays a hot-swap; any other copied file escalates to a full
+  // reload — reload() itself folds the batch into one refresh.
+  const recopy = coalesce((batch) => {
+    modules.copy.execute()
+      .then(() => {
+        hook('copy')
+        batch.forEach((file) => reload(/\.css$/i.test(file) ? file : undefined))
+      })
+      .catch(err => console.error(err))
+  })
+
   const rebuild = (file) => {
     // Engines that keep compiled templates across compiles (nunjucks) drop
     // exactly this file's entries; shared by change/add/unlink via rebuild.
@@ -154,9 +194,7 @@ function setupWatchers(config, modules) {
       }
     }
     if (/(\.sass|\.scss|\.css)$/i.test(file) && !isBuildOutput(file)) {
-      modules.styles.compile().then(() => modules.postcss.compile())
-        .then(() => { hook('styles'); styleOutputs(config).forEach((out) => reload(out)) })
-        .catch(err => console.error(err))
+      recompileStyles(file)
     }
     if (/(\.html|\.xml|\.rss|\.atom|\.njk|\.liquid|\.md)$/i.test(file)) {
       // Incremental: re-render only the pages whose last render touched this
@@ -187,11 +225,7 @@ function setupWatchers(config, modules) {
         .then(() => { hook('images'); hook('markup'); reload() })
         .catch(err => console.error(err))
     }
-    // A copied .css (e.g. the styles compiler's own output landing in a copy
-    // source) stays a hot-swap; any other copied file needs a full reload.
-    doesFileBelongToPath(file, config.copy) && modules.copy.execute()
-      .then(() => { hook('copy'); reload(/\.css$/i.test(file) ? file : undefined) })
-      .catch(err => console.error(err))
+    doesFileBelongToPath(file, config.copy) && recopy(file)
   }
 
   // Atomic-save editors (rename-write) fire unlink+add for every save, so an
@@ -296,8 +330,10 @@ async function poops() {
 }
 
 // CLI Header
-const title = `💩 Poops — v${pkg.version}`
-styledLog(`\n{#8b4513}${title}\n${title.replace(/./g, '-')}{/}{bell}\n`)
+if (!quiet) {
+  const title = `💩 Poops — v${pkg.version}`
+  styledLog(`\n{#8b4513}${title}\n${title.replace(/./g, '-')}{/}{bell}\n`)
+}
 
 // Check if poops.json exists
 if (!pathExists(configPath)) {
@@ -391,9 +427,11 @@ async function startServer() {
 
   // eslint-disable-next-line @stylistic/space-before-function-paren
   http.createServer(createStaticHandler(base)).listen(parseInt(port), '0.0.0.0', async () => {
-    console.log()
-    styledLog(`🏠 {dim}Local server:{/} {underline|http://localhost:${port}}`)
-    styledLog(`🛜 {dim} Network     :{/} {underline|http://${getLocalIP()}:${port}}`)
+    if (!quiet) {
+      console.log()
+      styledLog(`🏠 {dim}Local server:{/} {underline|http://localhost:${port}}`)
+      styledLog(`🛜 {dim} Network     :{/} {underline|http://${getLocalIP()}:${port}}`)
+    }
     setupLiveReloadServer(config)
   })
 }