README.md

support-firecloud/repo/mk

Use these Makefile "puzzle" pieces by making your main Makefile look like this:

ifeq (,$(wildcard support-firecloud/Makefile))
INSTALL_SUPPORT_FIRECLOUD := $(shell git submodule update --init --recursive support-firecloud)
ifneq (,$(filter undefine,$(.FEATURES)))
undefine INSTALL_SUPPORT_FIRECLOUD
endif
endif

include support-firecloud/repo/mk/generic.common.mk
include support-firecloud/repo/mk/...

# ------------------------------------------------------------------------------

... include here custom EXE variables, which call which/npm-which ...

... include here custom variables ...

... include here support-firecloud variables (configuration) ...

# ------------------------------------------------------------------------------

... include here your custom targets ...

The pieces MUST be included in this order:

• common (e.g. generic.common.mk)
• deps
• build
• check
• test
• release
• misc

NOTE All are split into:

• docs
• includes
• variables
• targets

The high-level colletions of pieces are as follows:

• core.common.mk - the "bare minimum" for generic repositories
  • core.clean.mk
  • core.deps.mk
  • core.build.mk
  • core.check.mk
  • core.test.mk
  • core.vendor.mk
• generic.common.mk - core.common.mk + the "must have" for generic repositories
  • core.deps.git-hook-pre-push.mk
  • core.check.eclint.mk
  • core.check.jsonlint.mk
  • core.check.path.mk
  • core.build.build-version-files.mk
  • core.misc.bootstrap.mk
  • core.misc.release.mk
  • core.misc.sf-update.mk
  • core.misc.snapshot.mk
  • core.misc.transcrypt.mk
  • core.misc.version.mk
• js.common.mk - generic.common.mk + the "must have" for JavaScript repositories
  • js.deps.npm.mk
• node.common.mk - js.common.mk + the "must have" for NodeJS repositories
  • js.build.babel.mk
• py.common.mk - generic.common.mk + the "must have" for Python repositories

NOTE It is only *.common.mk makefiles that can include. All others are atomic.

Addon pieces by type of repository:

• generic
  • core.misc.merge-upstream.mk
  • core.misc.source-const-inc.mk
  • core.release.npg.mk
  • core.release.tag.mk
  • env.common.mk (FIXME)
    • env.promote-tag-to-env-branch.mk
    • env.teardown-env.mk
• JavaScript/NodeJS
  • js.deps.private.mk
  • js.build.cp-dts.mk
  • js.build.webpack.mk
  • js.check.d.ts.mk
  • js.check.eslint.mk
  • js.check.sasslint.mk
  • js.test.jest.mk
• Python
  • py.check.flake.mk

For a full list of available pieces click here.