| 1 | #!/usr/bin/env bash
 | 
| 2 | #
 | 
| 3 | # Build the dev version of Oil on CPython.
 | 
| 4 | # This is in contrast to oils-for-unix and the oil.ovm build.
 | 
| 5 | #
 | 
| 6 | # Usage:
 | 
| 7 | #   build/py.sh <function name>
 | 
| 8 | 
 | 
| 9 | set -o nounset
 | 
| 10 | set -o pipefail
 | 
| 11 | set -o errexit
 | 
| 12 | shopt -s strict:all 2>/dev/null || true  # dogfood for OSH
 | 
| 13 | 
 | 
| 14 | REPO_ROOT=$(cd "$(dirname $0)/.."; pwd)
 | 
| 15 | readonly REPO_ROOT
 | 
| 16 | 
 | 
| 17 | source build/common.sh       # log, $CLANGXX
 | 
| 18 | source devtools/run-task.sh
 | 
| 19 | # TODO: We could have the user run deps/from-apt.sh directly
 | 
| 20 | 
 | 
| 21 | if test -z "${IN_NIX_SHELL:-}"; then
 | 
| 22 |   source build/dev-shell.sh  # to run 're2c'
 | 
| 23 | fi
 | 
| 24 | 
 | 
| 25 | export PYTHONPATH='.:vendor/'
 | 
| 26 | 
 | 
| 27 | ubuntu-deps() {
 | 
| 28 |   ### Alias for backward compatility
 | 
| 29 |   build/deps.sh install-ubuntu-packages
 | 
| 30 | }
 | 
| 31 | 
 | 
| 32 | # This is what Python uses on OS X.
 | 
| 33 | #
 | 
| 34 | # https://www.thrysoee.dk/editline/
 | 
| 35 | install-libedit() {
 | 
| 36 |   sudo apt install libedit-dev
 | 
| 37 | }
 | 
| 38 | 
 | 
| 39 | libedit-flags() {
 | 
| 40 |   pkg-config --libs --cflags libedit
 | 
| 41 | }
 | 
| 42 | 
 | 
| 43 | install-py3() {
 | 
| 44 |   pip3 install mypy
 | 
| 45 | }
 | 
| 46 | 
 | 
| 47 | destroy-pip() {
 | 
| 48 |   rm -r -f -v ~/.cache/pip ~/.local/lib/python2.7
 | 
| 49 | }
 | 
| 50 | 
 | 
| 51 | # Needed for the release process, but not the dev process.
 | 
| 52 | # TODO: remove in favor of wedges in deps/
 | 
| 53 | release-ubuntu-deps() {
 | 
| 54 |   # For the release to run test/report.R, you need r-base-core too.
 | 
| 55 |   # cloc is used for line counts
 | 
| 56 |   # valgrind/cachegrind for benchmarks
 | 
| 57 |   sudo apt-get install r-base-core cloc valgrind
 | 
| 58 | }
 | 
| 59 | 
 | 
| 60 | # 3/2021: For installing dplyr on Ubuntu Xenial 16.04 LTS, which has an old R version
 | 
| 61 | # Following these instructions
 | 
| 62 | # https://cloud.r-project.org/bin/linux/ubuntu/README.html
 | 
| 63 | 
 | 
| 64 | # 5/2021: Upgraded to Ubuntu Bionic, which has R 3.4.4.  So it looks like I no
 | 
| 65 | # longer need this.
 | 
| 66 | #
 | 
| 67 | # 2/2023: I need this again because R 3.4.4 is too old for dplyr.
 | 
| 68 | #
 | 
| 69 | # https://cloud.r-project.org/bin/linux/ubuntu/
 | 
| 70 | 
 | 
| 71 | _install-new-r() {
 | 
| 72 |   # update indices
 | 
| 73 |   apt update -qq
 | 
| 74 | 
 | 
| 75 |   # install two helper packages we need
 | 
| 76 |   apt install --no-install-recommends software-properties-common dirmngr
 | 
| 77 | 
 | 
| 78 |   # import the signing key (by Michael Rutter) for these repo
 | 
| 79 |   apt-key adv --keyserver keyserver.ubuntu.com --recv-keys E298A3A825C0D65DFD57CBB651716619E084DAB9
 | 
| 80 | 
 | 
| 81 |   # add the R 4.0 repo from CRAN -- adjust 'focal' to 'groovy' or 'bionic' as needed
 | 
| 82 | 
 | 
| 83 |   local ubuntu_version
 | 
| 84 |   ubuntu_version=$(lsb_release -cs)
 | 
| 85 |   add-apt-repository "deb https://cloud.r-project.org/bin/linux/ubuntu $ubuntu_version-cran40/"
 | 
| 86 | 
 | 
| 87 |   # Hm I had to run this manually and I got R 4.0
 | 
| 88 |   # 2021-04: Hm this had to be run twice
 | 
| 89 |   apt install --no-install-recommends r-base
 | 
| 90 | }
 | 
| 91 | 
 | 
| 92 | install-new-r() {
 | 
| 93 |   sudo $0 _install-new-r "$@"
 | 
| 94 | }
 | 
| 95 | 
 | 
| 96 | const-mypy-gen() {
 | 
| 97 |   local out=_devbuild/gen/id_kind_asdl.py
 | 
| 98 |   frontend/consts_gen.py mypy > $out
 | 
| 99 |   log "  (frontend/consts_gen) -> $out"
 | 
| 100 | 
 | 
| 101 |   out=_devbuild/gen/id_kind.py
 | 
| 102 |   frontend/consts_gen.py py-consts > $out
 | 
| 103 |   log "  (frontend/consts_gen) -> $out"
 | 
| 104 | }
 | 
| 105 | 
 | 
| 106 | option-mypy-gen() {
 | 
| 107 |   local out=_devbuild/gen/option_asdl.py
 | 
| 108 |   frontend/option_gen.py mypy > $out
 | 
| 109 |   log "  (frontend/option_gen) -> $out"
 | 
| 110 | }
 | 
| 111 | 
 | 
| 112 | flag-gen-mypy() {
 | 
| 113 |   local out=_devbuild/gen/arg_types.py
 | 
| 114 |   frontend/flag_gen.py mypy > $out
 | 
| 115 |   log "  (frontend/flag_gen) -> $out"
 | 
| 116 | }
 | 
| 117 | 
 | 
| 118 | # Helper
 | 
| 119 | gen-asdl-py() {
 | 
| 120 |   local asdl_path=$1  # e.g. osh/osh.asdl
 | 
| 121 | 
 | 
| 122 |   local name
 | 
| 123 |   name=$(basename $asdl_path .asdl)
 | 
| 124 | 
 | 
| 125 |   local tmp=_tmp/${name}_asdl.py
 | 
| 126 |   local out=_devbuild/gen/${name}_asdl.py
 | 
| 127 | 
 | 
| 128 |   # abbrev module is optional
 | 
| 129 |   asdl/asdl_main.py mypy "$@" > $tmp
 | 
| 130 | 
 | 
| 131 |   # BUG: MUST BE DONE ATOMICALLY; otherwise the Python interpreter can
 | 
| 132 |   # import an empty file!
 | 
| 133 |   mv $tmp $out
 | 
| 134 | 
 | 
| 135 |   log "$asdl_path -> (asdl_main) -> $out"
 | 
| 136 | }
 | 
| 137 | 
 | 
| 138 | py-codegen() {
 | 
| 139 |   # note: filename must come first
 | 
| 140 |   # hnode.asdl has REQUIRED fields so it's --py-init-N
 | 
| 141 |   gen-asdl-py 'asdl/hnode.asdl' --no-pretty-print-methods --py-init-N 
 | 
| 142 | 
 | 
| 143 |   gen-asdl-py 'frontend/types.asdl'
 | 
| 144 |   # depends on syntax.asdl
 | 
| 145 |   gen-asdl-py 'core/runtime.asdl'
 | 
| 146 |   gen-asdl-py 'core/value.asdl'
 | 
| 147 |   gen-asdl-py 'data_lang/nil8.asdl'
 | 
| 148 |   gen-asdl-py 'data_lang/pretty.asdl'
 | 
| 149 | 
 | 
| 150 |   gen-asdl-py 'tools/find/find.asdl'
 | 
| 151 | 
 | 
| 152 |   const-mypy-gen  # depends on bool_arg_type_e, generates Id_t
 | 
| 153 | 
 | 
| 154 |   # does __import__ of syntax_abbrev.py, which depends on Id.  We could use the
 | 
| 155 |   # AST module later?
 | 
| 156 |   # depends on syntax_asdl
 | 
| 157 |   gen-asdl-py 'frontend/syntax.asdl' 'frontend.syntax_abbrev'
 | 
| 158 | 
 | 
| 159 |   option-mypy-gen
 | 
| 160 |   flag-gen-mypy
 | 
| 161 | 
 | 
| 162 |   # Experiment
 | 
| 163 |   gen-asdl-py 'yaks/yaks.asdl'
 | 
| 164 | 
 | 
| 165 |   # For tests
 | 
| 166 |   gen-asdl-py 'mycpp/examples/expr.asdl'
 | 
| 167 | }
 | 
| 168 | 
 | 
| 169 | py-asdl-examples() {
 | 
| 170 |   # dependency of typed_demo
 | 
| 171 |   gen-asdl-py 'asdl/examples/demo_lib.asdl'
 | 
| 172 |   gen-asdl-py 'asdl/examples/typed_demo.asdl'
 | 
| 173 | 
 | 
| 174 |   gen-asdl-py 'asdl/examples/shared_variant.asdl'
 | 
| 175 |   gen-asdl-py 'asdl/examples/typed_arith.asdl' 'asdl.examples.typed_arith_abbrev'
 | 
| 176 | }
 | 
| 177 | 
 | 
| 178 | oil-cpp() {
 | 
| 179 |   ### STUB for backward compatibility
 | 
| 180 | 
 | 
| 181 |   build/cpp.sh all
 | 
| 182 | }
 | 
| 183 | 
 | 
| 184 | py-ext() {
 | 
| 185 |   ### Build a Python extension
 | 
| 186 | 
 | 
| 187 |   local name=$1
 | 
| 188 |   local setup_script=$2
 | 
| 189 | 
 | 
| 190 |   log "  ($setup_script) -> $name.so"
 | 
| 191 | 
 | 
| 192 |   local arch
 | 
| 193 |   arch=$(uname -m)
 | 
| 194 | 
 | 
| 195 |   # global opts come first
 | 
| 196 |   $setup_script --quiet build_ext --inplace
 | 
| 197 | 
 | 
| 198 |   #file $name.so
 | 
| 199 | }
 | 
| 200 | 
 | 
| 201 | py-ext-test() {
 | 
| 202 |   ### Run a test and log it
 | 
| 203 | 
 | 
| 204 |   # TODO: Fold this into some kind of Ninja test runner?
 | 
| 205 |   # Or just rely on test/unit.sh all?
 | 
| 206 | 
 | 
| 207 |   local test_path=$1  # Or a function
 | 
| 208 |   shift
 | 
| 209 | 
 | 
| 210 |   local log_path=_test/unit/$test_path.log
 | 
| 211 |   mkdir -p $(dirname $log_path)
 | 
| 212 | 
 | 
| 213 |   set +o errexit
 | 
| 214 |   $test_path "$@" >$log_path 2>&1
 | 
| 215 |   local status=$?
 | 
| 216 |   set -o errexit
 | 
| 217 | 
 | 
| 218 |   if test $status -eq 0; then
 | 
| 219 |     log "OK $log_path"
 | 
| 220 |   else
 | 
| 221 |     echo
 | 
| 222 |     cat $log_path
 | 
| 223 |     echo
 | 
| 224 |     die "FAIL $log_path"
 | 
| 225 |   fi
 | 
| 226 | }
 | 
| 227 | 
 | 
| 228 | pylibc() {
 | 
| 229 |   rm -f libc.so
 | 
| 230 | 
 | 
| 231 |   py-ext libc pyext/setup_libc.py
 | 
| 232 | 
 | 
| 233 |   # Skip unit tests on Alpine for now
 | 
| 234 |   # musl libc doesn't have extended globs
 | 
| 235 |   if uname -a | grep -F Alpine; then
 | 
| 236 |     return
 | 
| 237 |   fi
 | 
| 238 | 
 | 
| 239 |   py-ext-test pyext/libc_test.py "$@"
 | 
| 240 | }
 | 
| 241 | 
 | 
| 242 | fanos() {
 | 
| 243 |   rm -f fanos.so
 | 
| 244 | 
 | 
| 245 |   py-ext fanos pyext/setup_fanos.py
 | 
| 246 |   py-ext-test pyext/fanos_test.py "$@"
 | 
| 247 | }
 | 
| 248 | 
 | 
| 249 | fastfunc() {
 | 
| 250 |   rm -f fastfunc.so
 | 
| 251 | 
 | 
| 252 |   py-ext fastfunc pyext/setup_fastfunc.py
 | 
| 253 |   py-ext-test pyext/fastfunc_test.py "$@"
 | 
| 254 | }
 | 
| 255 | 
 | 
| 256 | #
 | 
| 257 | # For frontend/match.py
 | 
| 258 | #
 | 
| 259 | 
 | 
| 260 | lexer-gen() { frontend/lexer_gen.py "$@"; }
 | 
| 261 | 
 | 
| 262 | print-regex() { lexer-gen print-regex; }
 | 
| 263 | print-all() { lexer-gen print-all; }
 | 
| 264 | 
 | 
| 265 | # Structure:
 | 
| 266 | #
 | 
| 267 | # _gen
 | 
| 268 | #   frontend/
 | 
| 269 | #     id.asdl_c.h
 | 
| 270 | #     types.asdl_c.h
 | 
| 271 | #     match.re2c.h
 | 
| 272 | # _build/
 | 
| 273 | #   tmp/
 | 
| 274 | #     frontend/
 | 
| 275 | #       match.re2c.in
 | 
| 276 | #     bin/
 | 
| 277 | #       oils_for_unix_raw.mycpp.cc
 | 
| 278 | 
 | 
| 279 | # re2c native.
 | 
| 280 | osh-lex-gen-native() {
 | 
| 281 |   local in=$1
 | 
| 282 |   local out=$2
 | 
| 283 |   # Turn on all warnings and make them native.
 | 
| 284 |   # The COMMENT state can match an empty string at the end of a line, e.g.
 | 
| 285 |   # '#\n'.  So we have to turn that warning off.
 | 
| 286 |   re2c -W -Wno-match-empty-string -Werror -o $out $in
 | 
| 287 | }
 | 
| 288 | 
 | 
| 289 | fastmatch() {
 | 
| 290 |   local gen_dir=_gen/frontend
 | 
| 291 |   mkdir -p _gen/_tmp $gen_dir
 | 
| 292 | 
 | 
| 293 |   # C version of frontend/types.asdl
 | 
| 294 |   local out=$gen_dir/types.asdl_c.h
 | 
| 295 |   asdl/asdl_main.py c frontend/types.asdl "$@" > $out
 | 
| 296 |   log "  (asdl_main c) -> $out"
 | 
| 297 | 
 | 
| 298 |   # C version of id_kind
 | 
| 299 |   local out=$gen_dir/id_kind.asdl_c.h
 | 
| 300 |   frontend/consts_gen.py c > $out
 | 
| 301 |   log "  (frontend/consts_gen c) -> $out"
 | 
| 302 | 
 | 
| 303 |   # Fast matcher
 | 
| 304 |   local tmp=_gen/_tmp/match.re2c-input.h
 | 
| 305 |   local out=_gen/frontend/match.re2c.h
 | 
| 306 |   lexer-gen c > $tmp
 | 
| 307 |   log "  (lexer_gen) -> $tmp"
 | 
| 308 | 
 | 
| 309 |   osh-lex-gen-native $tmp $out
 | 
| 310 |   log "$tmp -> (re2c) -> $out"
 | 
| 311 | }
 | 
| 312 | 
 | 
| 313 | fastlex() {
 | 
| 314 |   fastmatch
 | 
| 315 | 
 | 
| 316 |   # Why do we need this?  It gets stale otherwise.
 | 
| 317 |   rm -f fastlex.so
 | 
| 318 | 
 | 
| 319 |   py-ext fastlex pyext/setup_fastlex.py
 | 
| 320 |   py-ext-test pyext/fastlex_test.py
 | 
| 321 | }
 | 
| 322 | 
 | 
| 323 | line-input() {
 | 
| 324 |   # Why do we need this?  It gets stale otherwise.
 | 
| 325 |   rm -f line_input.so
 | 
| 326 | 
 | 
| 327 |   py-ext line_input pyext/setup_line_input.py
 | 
| 328 |   py-ext-test pyext/line_input_test.py
 | 
| 329 | }
 | 
| 330 | 
 | 
| 331 | posix_() {
 | 
| 332 |   rm -f posix_.so
 | 
| 333 | 
 | 
| 334 |   py-ext posix_ pyext/setup_posix.py
 | 
| 335 |   py-ext-test pyext/posix_test.py
 | 
| 336 | }
 | 
| 337 | 
 | 
| 338 | py-source() {
 | 
| 339 |   ### Generate Python source code
 | 
| 340 | 
 | 
| 341 |   mkdir -p _tmp _devbuild/gen
 | 
| 342 | 
 | 
| 343 |   # need -r because Python 3 puts a __pycache__ here
 | 
| 344 |   log 'Removing _devbuild/gen/*'
 | 
| 345 |   rm -r -f _devbuild/gen/*
 | 
| 346 | 
 | 
| 347 |   # So modules are importable.
 | 
| 348 |   touch _devbuild/__init__.py  _devbuild/gen/__init__.py
 | 
| 349 | 
 | 
| 350 |   py-codegen  # depends on Id
 | 
| 351 | 
 | 
| 352 |   # Only for testing.
 | 
| 353 |   py-asdl-examples
 | 
| 354 | 
 | 
| 355 |   # Needed on Travis.
 | 
| 356 |   ysh-grammar
 | 
| 357 |   find-grammar
 | 
| 358 |   demo-grammar  # for mycpp/examples/pgen2_demo
 | 
| 359 | }
 | 
| 360 | 
 | 
| 361 | # No fastlex, because we don't want to require re2c installation.
 | 
| 362 | py-extensions() {
 | 
| 363 |   pylibc
 | 
| 364 |   line-input
 | 
| 365 |   posix_
 | 
| 366 |   fanos
 | 
| 367 |   fastfunc
 | 
| 368 | }
 | 
| 369 | 
 | 
| 370 | minimal() {
 | 
| 371 |   build/stamp.sh write-git-commit
 | 
| 372 | 
 | 
| 373 |   py-source
 | 
| 374 |   py-extensions
 | 
| 375 | 
 | 
| 376 |   cat <<EOF
 | 
| 377 | 
 | 
| 378 | *****
 | 
| 379 | '$0 minimal' succeeded
 | 
| 380 | 
 | 
| 381 |   It allows you to run and modify Oil quickly, but the lexer will be slow and
 | 
| 382 |   the help builtin won't work.
 | 
| 383 | 
 | 
| 384 | '$0 all' requires re2c and libcmark.so.  (Issue #513 is related, ask
 | 
| 385 | on #oil-dev)
 | 
| 386 | *****
 | 
| 387 | EOF
 | 
| 388 | }
 | 
| 389 | 
 | 
| 390 | ysh-grammar() {
 | 
| 391 |   mkdir -p _gen/ysh
 | 
| 392 |   touch _gen/__init__.py _gen/ysh/__init__.py
 | 
| 393 | 
 | 
| 394 |   ysh/grammar_gen.py py ysh/grammar.pgen2 _devbuild/gen
 | 
| 395 | }
 | 
| 396 | 
 | 
| 397 | find-grammar() {
 | 
| 398 |   ysh/grammar_gen.py py tools/find/find.pgen2 _devbuild/gen
 | 
| 399 | }
 | 
| 400 | 
 | 
| 401 | demo-grammar() {
 | 
| 402 |   ysh/grammar_gen.py py mycpp/examples/arith.pgen2 _devbuild/gen
 | 
| 403 | }
 | 
| 404 | 
 | 
| 405 | time-helper() {
 | 
| 406 |   local out=${1:-_devbuild/bin/time-helper}
 | 
| 407 |   local in=benchmarks/time-helper.c
 | 
| 408 | 
 | 
| 409 |   mkdir -p $(dirname $out)
 | 
| 410 | 
 | 
| 411 |   cc -std=c99 -Wall -o $out $in
 | 
| 412 |   log "  CC $in"
 | 
| 413 | }
 | 
| 414 | 
 | 
| 415 | all() {
 | 
| 416 |   rm -f *.so  # 12/2019: to clear old symlinks, maybe get rid of
 | 
| 417 | 
 | 
| 418 |   build/stamp.sh write-git-commit
 | 
| 419 | 
 | 
| 420 |   py-source
 | 
| 421 |   py-extensions  # no re2c
 | 
| 422 | 
 | 
| 423 |   # requires re2c: deps/from-tar.sh layer-re2c
 | 
| 424 |   fastlex
 | 
| 425 |   time-helper
 | 
| 426 | 
 | 
| 427 |   # help topics and chapter links are extracted from doc/ref
 | 
| 428 |   build/doc.sh all-ref
 | 
| 429 | }
 | 
| 430 | 
 | 
| 431 | gitpod-minimal() {
 | 
| 432 |   ubuntu-deps '-y'  # skip prompt
 | 
| 433 |   minimal 
 | 
| 434 |   test/spec.sh smoke
 | 
| 435 | 
 | 
| 436 |   set -x
 | 
| 437 |   bin/osh -c 'echo hi'
 | 
| 438 | }
 | 
| 439 | 
 | 
| 440 | if test $(basename $0) = 'py.sh'; then
 | 
| 441 |   run-task "$@"
 | 
| 442 | fi
 |