You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Julian Noble
e25537bb50
|
3 weeks ago | |
|---|---|---|
| .. | ||
| assets/logo | 4 weeks ago | |
| bin | ||
| bootsupport | 3 weeks ago | |
| buildsuites | 3 weeks ago | |
| decktemplates | 1 month ago | |
| defaultconfigs | ||
| doc | ||
| embedded | ||
| lib | 3 weeks ago | |
| lib_tcl8 | ||
| lib_tcl9 | ||
| modules | 3 weeks ago | |
| modules_tcl8 | 2 months ago | |
| modules_tcl9 | 2 months ago | |
| project_layouts | 3 weeks ago | |
| runtime | 3 weeks ago | |
| scriptapps | 3 weeks ago | |
| testansi | ||
| testdata | ||
| tests | 3 weeks ago | |
| text | ||
| tools | 3 weeks ago | |
| vendorlib | 3 weeks ago | |
| vendorlib_tcl8 | 4 weeks ago | |
| vendorlib_tcl9 | 4 weeks ago | |
| vendormodules | 3 weeks ago | |
| vendormodules_tcl8 | 1 month ago | |
| vendormodules_tcl9 | 3 months ago | |
| vfs | 3 weeks ago | |
| AGENTS.md | 3 weeks ago | |
| README.md | 3 weeks ago | |
| Tcl9icon.six | ||
| Tcl9icon.svg | ||
| build.cmd | ||
| build.ps1 | ||
| build.tcl | ||
| error_overtype.txt | ||
| make.tcl | 3 weeks ago | |
| test.txt | ||
README.md
punk shell
Runtimes
#run from project root:
./bin/punk-runtime.cmd list -remote
# This is a cross-platform polyglot wrapper that should run from bash, or with tclsh or in windows directly in powershell/cmd.exe
./bin/punk-runtime.cmd fetch
#if no retrievable runtime for your platform, you'll need a vfs capable tclkit or a zipfs capable tclsh with an attached vfs
#todo: exact notes on creating suitable runtimes (plain tclsh will likely be missing zipfs vfs to mount)
Make Instructions (mint / promote / bake)
- Use
tclsh|<punkruntime> make.tcl <commandname>to mint .tm modules and rebake the punk executables In normal use it should be called from the project root. e.g
tclsh src/make.tcl vendorupdate ;# if needed
tclsh src/make.tcl packages ;# mint the libs / modules from src to <projectroot> (version-stamped)
# or separately:
# tclsh src/make.tcl modules ;# src/modules -> /modules (etc)
# tclsh src/make.tcl libs ;# src/lib -> /lib (etc)
tclsh src/make.tcl vfscommonupdate ;copy the libs/modules that are now in <projectroot>/modules to vfs system for inclusion in the binary.
# If make.tcl dependencies are modified:
# tclsh src/make.tcl bootsupport ;# src/modules -> src/bootsupport/modules, src/lib -> src/bootsupport/lib (etc)
tclsh src/make.tcl bake ;# assemble kit/zipkit executables from the promoted vfs payload + runtimes
# (consumer path from a CLEAN checkout: 'tclsh src/make.tcl bakehouse' = packages + bake in one run;
# 'make.tcl workflow' prints the full data-flow overview.)
A common interactive test scenario (after running src/tests/runtests.tcl to test the unversioned source)
is to run 'tclsh src/make.tcl modules'
Then '<punkexecutable> dev'
This will source modules/libs from <projectroot>/modules and <projectroot>/lib intead of from the executable's vfs.
- Then Use tclsh|punk build.tcl to run the 'kettle' system to build doc files,
or - use thepmix KettleShellcommand from within the punk shell to perform kettle operations. Confirm with user or ask user to manually run.
(The name 'build.tcl' is the standard name used by the Kettle system - it is not for building the punk project.)