Wapp

Wapp is a versatile framework and interpreter designed for creating both command-line and web applications using Tcl. This single-binary, statically built solution incorporates a Tcl 9 interpreter, a robust Wapp framework, an SQLite3 interface, and capabilities for adding additional Tcl scripts. Its design allows it to operate seamlessly in various environments, including those with limited access, by eliminating external dependencies.

Key Features

• Single, Statically Built Binary: Everything needed to run applications is contained within one executable, making deployment straightforward and efficient.
• Interactive Shell: The wapptclsh command launches an interactive shell (REPL), allowing users to execute Tcl commands instantly. It also supports CLI scripting, making it a flexible alternative to traditional Tcl shells.
• CGI Interpreter: Wapp functions as a CGI interpreter, enabling the development of dynamic web applications with ease.
• Built-in SQLite Support: Access and manipulate SQLite databases directly within the Wapp environment, allowing for rapid data-driven application development.

Usage Example

Here’s a quick demonstration of how to use the Wapp interpreter:

$: wapptclsh
 _ _ _
| | | |___ ___ ___
| | | | .'| . | . |
|_____|__,|  _|  _|
          |_| |_|

Wapp 1.0 shell using SQLite version 3.50.0 and TCL 9.0
% Markdown::convert "# Heading1"
<h1>Heading1</h1>
% sqlite3 db :memory:
% db one {select strftime("%Y-%m-%d %H:%M:%S")}
2025-02-19 21:12:42
% 

Enhanced Functionality

The project includes optional files such as markdown.tcl for Markdown processing without external dependencies and app.tcl for consolidating application logic within the interpreter. Using app.tcl, developers can package web application code elegantly, enhancing portability and deployment simplicity.

API Enhancements

Wapp extends its functionality with features like wapp-set-cookie, allowing for cookie management with support for expiry time and secure flags:

wapp-set-cookie session val
wapp-set-cookie session-secure val 0 secure
wapp-clear-cookie session

Available Commands

Wapp provides an extensive list of commands to facilitate Tcl scripting, including control structures, string manipulations, array handling, and database interactions, ensuring a rich programming experience.

Wapp is a powerful framework for Tcl developers looking to build efficient and portable applications, combining the simplicity of a single binary with the flexibility of a comprehensive scripting environment.