zx-bulk-release 1.13.0 → 1.14.0

package/CHANGELOG.md

@@ -1,3 +1,8 @@
+## [1.14.0](https://github.com/semrel-extra/zx-bulk-release/compare/v1.13.0...v1.14.0) (2022-06-27)
+
+### Features
+* feat: add config normalizer ([80afee7](https://github.com/semrel-extra/zx-bulk-release/commit/80afee796e71aef6288943b2c6276b6f172192c5))
+
 ## [1.13.0](https://github.com/semrel-extra/zx-bulk-release/compare/v1.12.0...v1.13.0) (2022-06-27)
 
 ### Features

package/README.md

@@ -10,9 +10,10 @@
 ## Roadmap
 * [x] [Conventional commits](https://www.conventionalcommits.org/en/v1.0.0/#specification) trigger semantic releases.
 * [x] Predictable [toposort](https://githib.com/semrel-extra/topo)-driven flow.
-* [x] No blocking (no release commits).
-* [ ] Changelogs, docs, bundles go to: release assets and/or meta branch.
-* [x] No extra builds. The required deps are fetched from the pkg registry.
+* [x] No default branch blocking (no release commits).
+* [x] Pkg changelogs go to `changelog` branch (configurable).
+* [x] Docs are published to `gh-pages` branch (configurable).
+* [x] No extra builds. The required deps are fetched from the pkg registry (`npmFetch` flag).
 
 ## Requirements
 * macOS / linux
@@ -42,10 +43,13 @@ await run({
 
 ### Config
 Any [cosmiconfig](https://github.com/davidtheclark/cosmiconfig) compliant format: `.releaserc`, `.release.json`, `.release.yaml`, etc.
-```yaml
-buildCmd:      'yarn && yarn build'
-testCmd:       'yarn test'
-fetch:         true
+```json
+{
+  "cmd": "yarn && yarn build && yarn test",
+  "npmFetch": true,
+  "changelog": "changelog",
+  "ghPages": "gh-pages"
+}
 ```
 
 ## Implementation notes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zx-bulk-release",
-  "version": "1.13.0",
+  "version": "1.14.0",
   "description": "zx-based alternative for multi-semantic-release",
   "type": "module",
   "exports": "./src/main/js/index.js",

package/src/main/js/build.js

@@ -1,36 +1,29 @@
-import {ctx, tempy, fs} from 'zx-extra'
+import {tempy, fs, $} from 'zx-extra'
 import {copy} from 'git-glob-cp'
 import ini from 'ini'
 import {traverseDeps} from './deps.js'
 import {parseEnv} from './publish.js'
 
-export const build = (pkg, packages) => ctx(async ($) => {
+export const build = async (pkg, packages) => {
   if (pkg.built) return true
 
   await traverseDeps(pkg, packages, async (_, {pkg}) => build(pkg, packages))
 
   const {config} = pkg
 
-  if (config.buildCmd) {
-    if (pkg.changes.length === 0 && config.fetch) await fetchPkg(pkg)
-
+  if (config.cmd) {
+    if (pkg.changes.length === 0 && config.npmFetch) await fetchPkg(pkg)
     if (!pkg.fetched) {
-      $.cwd = pkg.absPath
-      console.log(`[${pkg.name}] build`)
-      await $.raw`${config.buildCmd}`
-
-      if (config.testCmd) {
-        console.log(`[${pkg.name}] test`)
-        await $.raw`${config.testCmd}`
-      }
+      console.log(`[${pkg.name}] run cmd '${config.cmd}'`)
+      await $.o({cwd: pkg.absPath, quote: v => v})`${config.cmd}`
     }
   }
 
   pkg.built = true
   return true
-})
+}
 
-const fetchPkg = (pkg) => ctx(async ($) => {
+const fetchPkg = async (pkg) => {
   try {
     const cwd = pkg.absPath
     const {npmRegistry, npmToken, npmConfig} = parseEnv($.env)
@@ -49,7 +42,7 @@ const fetchPkg = (pkg) => ctx(async ($) => {
   } catch (e) {
     console.log(`[${pkg.name}] fetching '${pkg.name}@${pkg.version}' failed`, e)
   }
-})
+}
 
 // NOTE registry-auth-token does not work with localhost:4873
 const getAuthToken = (registry, npmrc) =>

package/src/main/js/config.js

@@ -14,13 +14,19 @@ const CONFIG_FILES = [
 ]
 
 export const defaultConfig = {
-  buildCmd: 'yarn && yarn build',
-  testCmd: 'yarn test',
-  fetch: true
+  cmd: 'yarn && yarn build && yarn test',
+  npmFetch: true,
+  changelog: 'changelog',
+  ghPages: 'gh-pages'
 }
 
 export const getConfig = async (...cwds) =>
-  (await Promise.all(cwds.map(
+  normalizeConfig((await Promise.all(cwds.map(
     cwd => cosmiconfig(CONFIG_NAME, { searchPlaces: CONFIG_FILES }).search(cwd).then(r => r?.config)
-  ))).find(Boolean) || defaultConfig
+  ))).find(Boolean) || defaultConfig)
 
+export const normalizeConfig = config => ({
+  ...config,
+  npmFetch: config.npmFetch || config.fetch || config.fetchPkg,
+  cmd:      config.cmd || (config.buildCmd ? `${config.buildCmd}${config.testCmd ? ` && ${config.testCmd}` : ''}` : '')
+})

package/src/main/js/publish.js

@@ -15,17 +15,17 @@ export const pushTag = (pkg) => ctx(async ($) => {
   const {absPath: cwd, name, version} = pkg
   const tag = formatTag({name, version})
   const {gitCommitterEmail, gitCommitterName} = parseEnv($.env)
-  $.cwd = cwd
 
   console.log(`[${name}] push release tag ${tag}`)
 
+  $.cwd = cwd
   await $`git config user.name ${gitCommitterName}`
   await $`git config user.email ${gitCommitterEmail}`
   await $`git tag -m ${tag} ${tag}`
   await $`git push origin ${tag}`
 })
 
-export const pushMeta = (pkg) => ctx(async ($) => {
+export const pushMeta = async (pkg) => {
   console.log(`[${pkg.name}] push artifact to branch 'meta'`)
 
   const cwd = pkg.absPath
@@ -34,9 +34,7 @@ export const pushMeta = (pkg) => ctx(async ($) => {
   const to = '.'
   const branch = 'meta'
   const msg = `chore: release meta ${name} ${version}`
-
-  $.cwd = cwd
-  const hash = (await $`git rev-parse HEAD`).toString().trim()
+  const hash = (await $.o({cwd})`git rev-parse HEAD`).toString().trim()
   const meta = {
     META_VERSION: '1',
     name: pkg.name,
@@ -50,7 +48,7 @@ export const pushMeta = (pkg) => ctx(async ($) => {
   const files = [{relpath: `${getArtifactPath(tag)}.json`, contents: meta}]
 
   await push({cwd, to, branch, msg, files})
-})
+}
 
 export const npmPublish = (pkg) => ctx(async ($) => {
   const {absPath: cwd, name, version} = pkg
@@ -124,10 +122,11 @@ const ghPages = async (pkg) => {
   const {config: {ghPages: opts}} = pkg
   if (!opts) return
 
-  console.log(`[${pkg.name}] publish to gh-pages`)
-  const [from, branch = 'gh-pages', to = '.', msg = `docs: update docs ${pkg.name} ${pkg.version}`] = typeof opts === 'string'
+  const [branch = 'gh-pages', from = 'docs', to = '.', msg = `docs: update docs ${pkg.name} ${pkg.version}`] = typeof opts === 'string'
     ? opts.split(' ')
-    : [opts.from, opts.branch, opts.to, opts.msg]
+    : [opts.branch, opts.from, opts.to, opts.msg]
+
+  console.log(`[${pkg.name}] publish docs to ${branch}`)
 
   await push({
     cwd: path.resolve(pkg.absPath, from),
@@ -224,10 +223,9 @@ export const parseEnv = (env = process.env) => {
   }
 }
 
-export const parseRepo = (cwd) => ctx(async ($) => {
-  $.cwd = cwd
+export const parseRepo = async (cwd) => {
   const {ghToken, ghUser} = parseEnv($.env)
-  const originUrl = (await $`git config --get remote.origin.url`).toString().trim()
+  const originUrl = (await $.o({cwd})`git config --get remote.origin.url`).toString().trim()
   const [,,repoHost, repoName] = originUrl.replace(':', '/').replace(/\.git/, '').match(/.+(@|\/\/)([^/]+)\/(.+)$/) || []
   const repoPublicUrl = `https://${repoHost}/${repoName}`
   const repoAuthedUrl = ghToken && ghUser && repoHost && repoName?
@@ -241,4 +239,4 @@ export const parseRepo = (cwd) => ctx(async ($) => {
     repoAuthedUrl,
     originUrl,
   }
-})
+}

package/src/test/js/integration.test.js

@@ -52,7 +52,7 @@ const cwd = await createFakeRepo({
               buildCmd: 'yarn && yarn build',
               testCmd: 'yarn test',
               fetch: true,
-              changelog: {}
+              changelog: 'changelog'
             },
             exports: {
               '.': {
@@ -115,7 +115,7 @@ const cwd = await createFakeRepo({
               buildCmd: 'yarn && yarn build',
               testCmd: 'yarn test',
               fetch: true,
-              ghPages: 'docs gh-pages b'
+              ghPages: 'gh-pages docs b'
             },
             exports: {
               '.': {