-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathjustfile
209 lines (182 loc) · 9.81 KB
/
justfile
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
###############################################################
# Minimal commands to develop, build, test, and deploy
###############################################################
# just docs: https://github.com/casey/just
set shell := ["bash", "-c"]
set dotenv-load := true
# E.g. 'my.app.com'. Some services e.g. auth need know the external endpoint for example OAuth
# The root domain for this app, serving index.html
export APP_FQDN := env_var_or_default("APP_FQDN", "metaframe1.localhost")
export APP_PORT := env_var_or_default("APP_PORT", "4430")
ROOT := env_var_or_default("GITHUB_WORKSPACE", `(which git >/dev/null && git rev-parse --show-toplevel) || pwd`)
export CI := env_var_or_default("CI", "")
PACKAGE_NAME_SHORT := file_name(`cat package.json | jq -r '.name' | sed 's/.*\///'`)
# Store the CI/dev docker image in github
# ghcr.io packages cannot have more than one "/" after the organization name
export DOCKER_IMAGE_PREFIX := "ghcr.io/metapages/" + PACKAGE_NAME_SHORT
# Always assume our current cloud ops image is versioned to the exact same app images we deploy
export DOCKER_TAG := `if [ "${GITHUB_ACTIONS}" = "true" ]; then echo "${GITHUB_SHA}"; else echo "$(git rev-parse --short=8 HEAD)"; fi`
# The NPM_TOKEN is required for publishing to https://www.npmjs.com
NPM_TOKEN := env_var_or_default("NPM_TOKEN", "")
# Source of deno scripts. When developing we need to switch this
# DENO_SOURCE := env_var_or_default("DENO_SOURCE", "https://deno.land/x/[email protected]")
# vite needs an extra memory boost
vite := "VITE_APP_FQDN=" + APP_FQDN + " VITE_APP_PORT=" + APP_PORT + " NODE_OPTIONS='--max_old_space_size=16384' ./node_modules/vite/bin/vite.js"
tsc := "./node_modules/typescript/bin/tsc"
# minimal formatting, bold is very useful
bold := '\033[1m'
normal := '\033[0m'
green := "\\e[32m"
yellow := "\\e[33m"
blue := "\\e[34m"
magenta := "\\e[35m"
grey := "\\e[90m"
# If not in docker, get inside
@_help:
echo -e ""
just --list --unsorted --list-heading $'🌱 Commands:\n\n'
echo -e ""
echo -e " Develop URL 🔗 {{green}}https://{{APP_FQDN}}:{{APP_PORT}}/{{normal}}"
echo -e " Github URL 🔗 {{green}}$(cat package.json | jq -r '.repository.url'){{normal}}"
echo -e " Publish URL 🔗 {{green}}https://$(cat package.json | jq -r '.homepage'){{normal}}"
echo -e " npm URL 🔗 {{green}}https://www.npmjs.com/package/$(cat package.json | jq -r '.name')/{{normal}}"
echo -e ""
# Run the dev server. Opens the web app in browser.
dev: _mkcert _ensure_npm_modules (_tsc "--build") _ensure_deno
#!/usr/bin/env bash
set -euo pipefail
APP_ORIGIN=https://${APP_FQDN}:${APP_PORT}
echo "Browser development pointing to: ${APP_ORIGIN}"
deno run --allow-all --unstable https://deno.land/x/[email protected]/exec/open_url.ts https://metapages.github.io/load-page-when-available/?url=https://${APP_FQDN}:${APP_PORT}
npm i
export HOST={{APP_FQDN}}
export PORT={{APP_PORT}}
export CERT_FILE=.certs/{{APP_FQDN}}.pem
export CERT_KEY_FILE=.certs/{{APP_FQDN}}-key.pem
export BASE=
VITE_APP_ORIGIN=${APP_ORIGIN} {{vite}} --clearScreen false
generate-readme-from-notion:
NOTION_PAGE_ID="https://www.notion.so/metapages/README-md-app-metapages-org-0409b49d00fe4978bf230625e971ccb8?pvs=4" just ~/dev/git/metapages/cetami.io/api/functions/notion-page-to-markdown {{justfile_directory()}}/public README.md
# Increment semver version, push the tags (triggers "deploy-tag-version")
@publish npmversionargs="patch": _fix_git_actions_permission _ensureGitPorcelain (_npm_version npmversionargs)
# Push the tags up
git push origin v$(cat package.json | jq -r '.version')
# Publish targets (add to the end of the deploy-tag-version command to execute):
# - `deploy-tag-version-npm`: publish to npm
# - `deploy-tag-version-github-pages`: publish to github pages
# - `_cloudflare_pages_publish`: publish to cloudflare pages
# Reaction to "push-tag-version". On new git version tag: publish code [github pages, cloudflare pages, npm]
deploy-tag-version: _fix_git_actions_permission _ensure_npm_modules _ensureGitPorcelain deploy-tag-version-github-pages deploy-tag-version-npm
# build the browser app in ./docs (default for github pages)
_browser_client_build BASE="": _ensure_deno
HOST={{APP_FQDN}} \
OUTDIR=./docs \
BASE={{BASE}} \
deno run --allow-all --unstable https://deno.land/x/[email protected]/browser/vite-build.ts --versioning=true
# Test: currently bare minimum: only building. Need proper test harness.
@test: (_tsc "--build") build
# Build the [browser app, npm lib] for production. Called automatically by "test" and "publish"
build BASE="": _ensure_npm_modules (_tsc "--build") (_browser_client_build BASE) _npm_build
# Deletes: [ .certs, dist ]
@clean:
rm -rf .certs dist
# Rebuild the browser assets on changes, but do not serve
watch:
watchexec -w src -w tsconfig.json -w package.json -w vite.config.ts -- just build
# Watch and serve browser client. Can't use vite to serve: https://github.com/vitejs/vite/issues/2754
serve: _mkcert build
cd docs && \
npx http-server --cors '*' -a {{APP_FQDN}} -p {{APP_PORT}} --ssl --cert ../.certs/{{APP_FQDN}}.pem --key ../.certs/{{APP_FQDN}}-key.pem
# Build npm package for publishing
@_npm_build: _ensure_npm_modules _ensure_deno
mkdir -p dist
rm -rf dist/*
{{tsc}} --noEmit false --project ./tsconfig.json
OUTDIR=./dist \
# DEPLOY_TARGET=lib \
# deno run --allow-all --unstable https://deno.land/x/[email protected]/browser/vite-build.ts
echo " ✅ npm build"
types-npm:
{{tsc}} --noEmit false --project ./tsconfig.json
# bumps version, commits change, git tags
@_npm_version npmversionargs="patch":
npm version {{npmversionargs}}
echo -e " 📦 new version: {{green}}$(cat package.json | jq -r .version){{normal}}"
# If the npm version does not exist, publish the module
deploy-tag-version-npm: _require_NPM_TOKEN _npm_build
#!/usr/bin/env bash
set -euo pipefail
if [ "$CI" != "true" ]; then
# This check is here to prevent publishing if there are uncommitted changes, but this check does not work in CI environments
# because it starts as a clean checkout and git is not installed and it is not a full checkout, just the tip
if [[ $(git status --short) != '' ]]; then
git status
echo -e '💥 Cannot publish with uncommitted changes'
exit 2
fi
fi
PACKAGE_EXISTS=true
if npm search $(cat package.json | jq -r .name) | grep -q "No matches found"; then
echo -e " 👉 new npm module !"
PACKAGE_EXISTS=false
fi
VERSION=$(cat package.json | jq -r '.version')
# if [ $PACKAGE_EXISTS = "true" ]; then
# INDEX=$(npm view $(cat package.json | jq -r .name) versions --json | jq "index( \"$VERSION\" )")
# if [ "$INDEX" != "null" ]; then
# echo -e ' 🌳 Version exists, not publishing'
# exit 0
# fi
# fi
echo -e " 👉 PUBLISHING npm version $VERSION"
if [ ! -f .npmrc ]; then
echo "//registry.npmjs.org/:_authToken=${NPM_TOKEN}" > .npmrc
fi
npm publish --access public .
# compile typescript src, may or may not emit artifacts
_tsc +args="": _ensure_npm_modules
{{tsc}} {{args}}
# DEV: generate TLS certs for HTTPS over localhost https://blog.filippo.io/mkcert-valid-https-certificates-for-localhost/
@_mkcert: _ensure_deno
APP_FQDN={{APP_FQDN}} CERTS_DIR=.certs deno run --allow-all --unstable https://deno.land/x/[email protected]/commands/ensure_mkcert.ts
@_ensure_npm_modules:
if [ ! -f "{{tsc}}" ]; then npm i; fi
# vite builder commands
@_vite +args="":
{{vite}} {{args}}
# update "gh-pages" branch with the (versioned and default) current build (./docs) (and keeping all previous versions)
@deploy-tag-version-github-pages: _ensure_npm_modules _ensure_deno
BASE=$(if [ -f "public/CNAME" ]; then echo ""; else echo "{{PACKAGE_NAME_SHORT}}"; fi) \
deno run --unstable --allow-all https://deno.land/x/[email protected]/browser/gh-pages-publish-to-docs.ts --versioning=true
@_cloudflare_pages_publish: _ensure_npm_modules _ensure_deno
deno run --unstable --allow-all https://deno.land/x/[email protected]/browser/gh-pages-publish-to-docs.ts --versioning=true
_ensureGitPorcelain: _ensure_deno
#!/usr/bin/env bash
set -eo pipefail
# In github actions, we modify .github/actions/cloud/action.yml for reasons
# so do not do this check there
if [ "${GITHUB_WORKSPACE}" = "" ]; then
deno run --allow-all --unstable https://deno.land/x/[email protected]/git/git-fail-if-uncommitted-files.ts
fi
@_require_NPM_TOKEN:
if [ -z "{{NPM_TOKEN}}" ]; then echo "Missing NPM_TOKEN env var"; exit 1; fi
_fix_git_actions_permission:
#!/usr/bin/env bash
set -eo pipefail
# workaround for github actions docker permissions issue
if [ "${GITHUB_WORKSPACE}" != "" ]; then
git config --global --add safe.directory /github/workspace
git config --global --add safe.directory /repo
git config --global --add safe.directory $(pwd)
export GIT_CEILING_DIRECTORIES=/__w
git config --global user.email "[email protected]"
git config --global user.name "Metaframe Robot"
fi
_ensure_deno:
#!/usr/bin/env bash
set -eo pipefail
if ! command -v deno &> /dev/null
then
echo "deno could not be found. Please install: https://deno.land/"
exit 1
fi