rwf

Rwf admin is a web application designed to provide real-time visibility and management capabilities for Rwf-based applications. It provides:

• A real-time overview of web activity.
• Insights into the background jobs queue.
• Tools to manipulate database models directly.

Rwf is a comprehensive MVC (Model-View-Controller) framework for Rust that includes:

• Core Web: HTTP server, WebSockets, static file hosting, and middleware support.
• Data & Persistence: User-friendly ORM for PostgreSQL, database migrations, and a built-in REST framework with JSON serialization.
• Application Logic: Authentication with built-in user sessions, background jobs, and scheduled jobs.
• Frontend & Templating: Dynamic templates and tight integration with Hotwired Turbo for backend-driven SPAs.
• DevOps & Tooling: Environment-specific configuration, logging, metrics, and a CLI.
• Migration Paths: WSGI server for Django/Flask migration and a Rack server for Rails migration.

rwf-ruby provides Rust bindings designed to run Ruby applications built on the Rack interface. Unlike generic Ruby-to-Rust bindings, this project specifically enables running arbitrary Ruby code within a Rust environment by wrapping ruby_exec_node directly.

Note: This project is currently experimental and requires additional testing before being used in production environments. The bindings are implemented in C.

Middleware is a component that runs before a request reaches a controller. It can be used to:

• Modify the request: Add custom headers or tags to the incoming request.
• Validate requests: Check for required conditions (e.g., presence of specific headers).
• Block requests: Stop a request from reaching the controller entirely by returning a response early.

By default, controllers have no middleware, meaning requests are processed in their original state.

Rwf supports complex data types that can be iterated or indexed.

Lists

Lists are 0-indexed arrays. You can iterate through them using for loops and access specific elements using dot (.) notation.

<% for item in [1, 2, "three"] %>
<%= item %>
<% end %>

<%# Accessing the second element %>
<%= list.1 %>

Hashes

Hashes (key/value pairs) allow you to access values using dot notation with the key name.

<p><%= user.name %></p>
<p><%= user.email %></p>

Rwf templates provide functions to manipulate constants and variables. Most functions are type-specific and are called using dot (.) notation on a value. For example, you can call string methods directly on a string object.

Available type-specific function groups include:

• String functions
• Integer functions
• Float functions
• Hash functions
• List functions

<%= "lowercase".upper %>

The Rwf + Turbo example demonstrates how to build a Single Page Application (SPA) by combining several technologies:

• Rwf + Turbo Integration: Tight coupling between the Rust Web Framework and Turbo for seamless updates.
• WebSockets: Real-time communication capabilities.
• Stimulus Controllers: Client-side JavaScript logic to enhance HTML.
• Rwf Controllers: Server-side request handling.
• Migrations: Database schema evolution.
• ORM Querying: Interacting with the PostgreSQL database using the Rwf ORM.

Expressions are combinations of terms and operators that evaluate to a single value. In Rwf templates, expressions are typically wrapped in <%= ... %> tags (ERB-style syntax) to output their evaluated result into the template.

<%= 5 * 2 / 10 %>

When using variables in conditional statements (like if), Rwf evaluates them for truthiness. The following values are considered falsy:

All other values evaluate to true.

Rwf template language supports evaluating complex expressions for truthiness within if statements. The language is nearly Turing-complete, allowing for string manipulation and arithmetic. However, it is recommended to keep template logic simple and delegate complex business logic to Rust views where possible.

<% if var.lower + "_" + bar.upper == "lo_HI" %>
  <!-- do something -->
<% end %>