css/docs/lib/sync.js

const chokidar = require('chokidar')
const klaw = require('klaw-sync')
const minimatch = require('minimatch')
const {green, red, yellow} = require('colorette')
const {basename, dirname, join} = require('path')
const {copySync, ensureDirSync, removeSync, writeFileSync} = require('fs-extra')
const {getIgnored, setIgnored} = require('./ignore')

module.exports = {sync, watch}

function sync({sourceDir, destDir, map, debug = false}) {
  const log = debug ? console.warn : noop
  const ignoreFile = join(destDir, '.gitignore')
  const ignored = getIgnored(ignoreFile)
  for (const file of ignored) {
    log(`${yellow('x')} removing: ${file}`)
    removeSync(file)
  }
  const links = getLinks(sourceDir, destDir, map)
  log(yellow(`linking ${links.length} files...`))
  syncLinks(links)
  const toBeIgnored = links.map(link => link.dest.substr(destDir.length + 1))
  log(yellow(`adding ${toBeIgnored.length} files to ${ignoreFile}...`))
  setIgnored(ignoreFile, toBeIgnored)
  log(green('done!'))
}

function watch(options) {
  const globs = Object.keys(map).map(path => join(sourceDir, path))
  let timeout
  const update = path => {
    if (timeout) return
    timeout = setTimeout(() => {
      copySync(options)
      clearTimeout(timeout)
      timeout = null
    }, 50)
  }
  console.warn(`watching: ${globs.map(g => yellow(g)).join(', ')}`)
  return chokidar.watch(globs)
    .on('add', update)
    .on('change', update)
    .on('unlink', update)
}

function syncLinks(links) {
  for (const {source, dest} of links) {
    const destDir = dirname(dest)
    removeSync(dest)
    ensureDirSync(destDir)
    copySync(source, dest)
  }
}

function getLinks(sourceDir, destDir, map) {
  const links = []

  const mapEntries = Object.entries(map)
  for (const [source, dest] of mapEntries) {
    if (source.indexOf('..') === 0 && typeof dest === 'string') {
      links.push({source, dest})
    }
  }

  console.warn(yellow(`walking: ${sourceDir}...`))
  const items = klaw(sourceDir, {
    nodir: true,
    filter: item => item.path.indexOf('node_modules') === -1
  })

  let skipped = []
  for (const item of items) {
    // item.path is fully-qualified, so we need to remove the sourceDir
    // from the beginning of it to get the relative path
    const source = item.path.substr(sourceDir.length + 1)
    let linked = false
    for (const [pattern, name] of mapEntries) {
      if (source === pattern || minimatch(source, pattern)) {
        const dest = typeof name === 'function' ? name(source) : name
        if (dest) {
          console.warn(`${source} ${yellow('->')} ${dest}`)
          links.push({source, dest})
          linked = true
        }
        break
      }
    }
    if (!linked && source.endsWith('.md')) {
      skipped.push(source)
    }
  }

  skipped = skipped.filter(file => file !== 'README.md')
  if (skipped.length) {
    console.warn(`skipped ${skipped.length} markdown files:`)
    for (const file of skipped) {
      console.warn(`${red('x')} ${file}`)
    }
  }

  return links.map(({source, dest}) => ({
    source: join(sourceDir, source),
    dest: join(destDir, dest)
  }))
}

function noop() {
}