2022-06-11 16:27:14 +00:00
|
|
|
#-*-mode:makefile-gmake;indent-tabs-mode:t;tab-width:8;coding:utf-8-*-┐
|
|
|
|
|
#───vi: set et ft=make ts=8 tw=8 fenc=utf-8 :vi───────────────────────┘
|
|
|
|
|
#
|
|
|
|
|
# SYNOPSIS
|
|
|
|
|
#
|
|
|
|
|
# Actually Portable Python Tutorial
|
|
|
|
|
#
|
|
|
|
|
# DESCRIPTION
|
|
|
|
|
#
|
|
|
|
|
# This tutorial demonstrates how to compile Python apps as tiny
|
|
|
|
|
# static multiplatform APE executables as small as 1.9m in size
|
|
|
|
|
# using Cosmopolitan, which is a BSD-style multitenant codebase
|
|
|
|
|
#
|
|
|
|
|
# GETTING STARTED
|
|
|
|
|
#
|
|
|
|
|
# # run these commands after cloning the cosmo repo on linux
|
|
|
|
|
# $ make -j8 o//examples/pylife/pylife.com
|
|
|
|
|
# $ o//examples/pylife/pylife.com
|
|
|
|
|
# cosmopolitan is cool!
|
|
|
|
|
#
|
|
|
|
|
# HOW IT WORKS
|
|
|
|
|
#
|
|
|
|
|
# $ pyobj.com -m -o pylife.o pylife.py
|
|
|
|
|
# $ ld -static -nostdlib -T o//ape/ape.lds ape.o crt.o \
|
|
|
|
|
# pylife.o \
|
|
|
|
|
# cosmopolitan-python-stage2.a \
|
|
|
|
|
# cosmopolitan-sqlite3.a \
|
|
|
|
|
# cosmopolitan-linenoise.a \
|
|
|
|
|
# cosmopolitan-bzip2.a \
|
|
|
|
|
# cosmopolitan-python-stage1.a \
|
|
|
|
|
# cosmopolitan.a
|
|
|
|
|
# $ ./pylife.com
|
|
|
|
|
# cosmopolitan is cool!
|
|
|
|
|
#
|
|
|
|
|
# NOTES
|
|
|
|
|
#
|
|
|
|
|
# If you enjoy this tutorial, let us know jtunney@gmail.com. If
|
|
|
|
|
# you're building something cool, then we can we can add you to
|
|
|
|
|
# our .gitowners file which grants you commit access so you can
|
|
|
|
|
# indepnedently maintain your package, as part of the mono-repo
|
|
|
|
|
|
|
|
|
|
PKGS += PYLIFE
|
|
|
|
|
PYLIFE = $(PYLIFE_DEPS) o/$(MODE)/examples/pylife/pylife.a
|
|
|
|
|
PYLIFE_COMS = o/$(MODE)/examples/pylife/pylife.com
|
|
|
|
|
PYLIFE_BINS = $(PYLIFE_COMS) $(PYLIFE_COMS:%=%.dbg)
|
|
|
|
|
|
|
|
|
|
# Specify our Cosmopolitan library dependencies
|
|
|
|
|
#
|
|
|
|
|
# - THIRD_PARTY_PYTHON_STAGE1 plus THIRD_PARTY_PYTHON_STAGE2 will
|
|
|
|
|
# define the Python CAPI and supported standard library modules
|
|
|
|
|
#
|
|
|
|
|
PYLIFE_DIRECTDEPS = \
|
|
|
|
|
THIRD_PARTY_PYTHON_STAGE2
|
|
|
|
|
|
|
|
|
|
# Compute the transitive closure of dependencies. There's dozens of
|
|
|
|
|
# other static libraries we need, in order to build a static binary
|
|
|
|
|
# such as fmt.a, runtime.a, str.a etc. This magic statement figures
|
|
|
|
|
# them all out and arranges them in the correct order.
|
|
|
|
|
PYLIFE_DEPS := $(call uniq,$(foreach x,$(PYLIFE_DIRECTDEPS),$($(x))))
|
|
|
|
|
|
|
|
|
|
# # Asks PYOBJ.COM to turn our Python source into an ELF object which
|
|
|
|
|
# # contains (a) embedded zip file artifacts of our .py file and .pyc
|
|
|
|
|
# # which it it compiled; and (b) statically analyzed listings of our
|
|
|
|
|
# # python namespaces and imports that GNU ld will use for tree shake
|
|
|
|
|
# # NOTE: This code can be commented out since it's in build/rules.mk
|
|
|
|
|
# o/$(MODE)/examples/pylife/pylife.o: examples/pylife/pylife.py o/$(MODE)/third_party/python/pyobj
|
|
|
|
|
# o/$(MODE)/third_party/python/pyobj $(PYFLAGS) -o $@ $<
|
|
|
|
|
|
|
|
|
|
# We need to define how the repository source code path gets mapped
|
|
|
|
|
# into an APE ZIP file path. By convention, we place Python modules
|
|
|
|
|
# in `.python/` (which is accessible via open() system calls, using
|
|
|
|
|
# the synthetic path `"/zip/.python/"`) which means that if we want
|
|
|
|
|
# to turn `pylife/pylife.py` into `.python/pylife.py` so it's imported
|
|
|
|
|
# using `import pylife` then we can simply append to PYOBJ.COM flags
|
|
|
|
|
# flags above asking it to strip one directory component and prefix
|
|
|
|
|
# Lastly be sure that whenever you use this variable override trick
|
|
|
|
|
# you only do it to .o files, since otherwise it'll ruin everything
|
|
|
|
|
# Passing -m to PYOBJ.COM causes a C main() function to get yoinked
|
|
|
|
|
# and it means our Python module can no longer be used as a library
|
|
|
|
|
o/$(MODE)/examples/pylife/pylife.o: PYFLAGS += -m -C2 -P.python
|
|
|
|
|
|
|
|
|
|
# Asks PACKAGE.COM to sanity check our DIRECTDEPS and symbol graph.
|
|
|
|
|
# This program functions as an incremental linker. It also provides
|
|
|
|
|
# enhancements to the object code that GCC generated similar to LTO
|
|
|
|
|
# so be certain that your .com.dbg rule depends on the .pkg output!
|
|
|
|
|
o/$(MODE)/examples/pylife/pylife.pkg: \
|
|
|
|
|
o/$(MODE)/examples/pylife/pylife.o \
|
|
|
|
|
$(foreach x,$(PYLIFE_DIRECTDEPS),$($(x)_A).pkg)
|
|
|
|
|
|
|
|
|
|
# Ask GNU LD to link our APE executable within an ELF binary shell.
|
|
|
|
|
# The CRT and APE dependencies are special dependencies that define
|
|
|
|
|
# your _start() / WinMain() entrpoints as well as APE linker script
|
|
|
|
|
o/$(MODE)/examples/pylife/pylife.com.dbg: \
|
|
|
|
|
$(PYLIFE_DEPS) \
|
|
|
|
|
o/$(MODE)/examples/pylife/pylife.pkg \
|
|
|
|
|
o/$(MODE)/examples/pylife/pylife.o \
|
|
|
|
|
$(CRT) \
|
|
|
|
|
$(APE_NO_MODIFY_SELF)
|
Unbloat build config
- 10.5% reduction of o//depend dependency graph
- 8.8% reduction in latency of make command
- Fix issue with temporary file cleanup
There's a new -w option in compile.com that turns off the recent
Landlock output path workaround for "good commands" which do not
unlink() the output file like GNU tooling does.
Our new GNU Make unveil sandboxing appears to have zero overhead
in the grand scheme of things. Full builds are pretty fast since
the only thing that's actually slowed us down is probably libcxx
make -j16 MODE=rel
RL: took 85,732,063µs wall time
RL: ballooned to 323,612kb in size
RL: needed 828,560,521µs cpu (11% kernel)
RL: caused 39,080,670 page faults (99% memcpy)
RL: 350,073 context switches (72% consensual)
RL: performed 0 reads and 11,494,960 write i/o operations
pledge() and unveil() no longer consider ENOSYS to be an error.
These functions have also been added to Python's cosmo module.
This change also removes some WIN32 APIs and System Five magnums
which we're not using and it's doubtful anyone else would be too
2022-08-10 08:32:17 +00:00
|
|
|
@$(COMPILE) -ALINK.ape $(LINK) $(LINKARGS) -o $@
|
2022-06-11 16:27:14 +00:00
|
|
|
|
|
|
|
|
# # Unwrap the APE .COM binary, that's embedded within the linked file
|
|
|
|
|
# # NOTE: This line can be commented out, since it's in build/rules.mk
|
|
|
|
|
# o/$(MODE)/examples/pylife/pylife.com: \
|
|
|
|
|
# o/$(MODE)/examples/pylife/pylife.com.dbg
|
|
|
|
|
# $(OBJCOPY) -S -O binary $< $@
|
|
|
|
|
|
|
|
|
|
# Ensure that build config changes will invalidate build artifacts.
|
|
|
|
|
o/$(MODE)/examples/pylife/pylife.o: \
|
|
|
|
|
examples/pylife/pylife.mk
|
|
|
|
|
|
|
|
|
|
# By convention we want to be able to say `make -j8 o//examples/pylife`
|
|
|
|
|
# and have it build all targets the package defines.
|
|
|
|
|
.PHONY: o/$(MODE)/examples/pylife
|
|
|
|
|
o/$(MODE)/examples/pylife: \
|
|
|
|
|
o/$(MODE)/examples/pylife/pylife.com \
|
|
|
|
|
o/$(MODE)/examples/pylife/pylife.com.dbg
|