Skip to content

Email Integration fixes, MySQL Docker generation, and Microservices enhancements

Choose a tag to compare

View all tags
@pandeyn pandeyn released this 08 Jan 09:29
· 141 commits to main since this release
v0.7.8
4d03795

Release Notes - v0.7.8

Overview

JHipster Rust Blueprint v0.7.8 includes bug fixes and improvements for MySQL Docker support and email integration across all database types.

What's New in v0.7.8

MySQL Docker Support

  • MySQL Docker Template: Added mysql.yml Docker Compose template for MySQL projects
  • MySQL 8.4: Uses MySQL 8.4 container with proper health checks
  • Consistent Credentials: MySQL Docker, .env, and test_utils.rs all use the same credentials (root:root)

Email Integration Improvements

  • Smart Base URL Resolution: For monolith apps with SERVE_STATIC_FILES=true, email links now automatically use the server's host and port (e.g., http://localhost:8080) instead of requiring manual configuration
  • Configurable Override: MAIL_BASE_URL can still be set explicitly to override auto-detection (useful for reverse proxy setups)
  • Email Template Fixes: Renamed email templates to .html.ejs for proper EJS processing with dynamic app name

Code Quality

  • Cargo Clippy Fixes: Resolved minor Clippy warnings in generated templates
  • DTO Improvements: Enhanced DTO serialization with #[serde(skip_serializing_if)] for optional fields
  • Handler Improvements: Better error handling and response formatting in entity handlers

Microservices Documentation

  • MICROSERVICES.md Guide: New comprehensive documentation for microservice deployment
  • Architecture Overview: Diagrams and explanations for microservices architecture
  • Inter-Service Communication: Token propagation and HTTP client patterns
  • Docker Compose Examples: Multi-service deployment configurations
  • Health Checks: Kubernetes-ready liveness and readiness probes

Documentation

  • Test Snapshots: Updated test snapshots to include new docs/ files
  • README Updates: Added microservices deployment section and feature documentation

Upgrade Notes

Email Configuration for Monolith Apps

If you have an existing monolith project with SERVE_STATIC_FILES=true, you can now remove or comment out MAIL_BASE_URL from your .env file. The server will automatically construct the correct URL from APP_HOST and APP_PORT.

Before:

SERVE_STATIC_FILES=true
MAIL_BASE_URL=http://localhost:8080

After:

SERVE_STATIC_FILES=true
# MAIL_BASE_URL is auto-detected when SERVE_STATIC_FILES=true

MySQL Projects

For MySQL projects, ensure you have the new docker/mysql.yml file. If upgrading an existing project, you may need to regenerate or manually create this file.

Release Notes - v0.7.4

Overview

JHipster Rust Blueprint v0.7.4 is a comprehensive release that generates production-ready Rust backends using the Axum web framework. This release includes full support for multiple databases, authentication methods, email integration, and API documentation.

What's New in v0.7.4

Email Integration

  • SMTP Email Service: Full email support using Lettre crate with Tera templates
  • Account Activation: Email verification flow for new user registration
  • Password Reset: Forgot password functionality with secure reset tokens
  • MailHog Support: Local development email testing with Docker

API Documentation

  • Swagger UI: Interactive API explorer at /swagger-ui
  • Scalar UI: Modern API documentation at /scalar
  • OpenAPI 3.0: JSON specification at /v3/api-docs

Static UI Hosting

  • Monolithic Deployment: Serve SPA (Angular/React/Vue) directly from Rust backend
  • SPA Routing: Automatic fallback to index.html for client-side routing
  • Cache Headers: Optimized caching for static assets

Documentation

  • Comprehensive documentation included in generated projects
  • Database-specific guides (SQLite, PostgreSQL, MySQL, MongoDB)
  • Security and authentication guides
  • Testing documentation for unit, integration, and E2E tests

Features

Backend Framework

  • Axum web framework with async HTTP server
  • Tokio async runtime for high-performance I/O
  • Tower middleware stack
  • Structured logging with tracing

Database Support

Database ORM/Driver Features
SQLite Diesel File-based, no external server needed
PostgreSQL Diesel Full SQL support with migrations
MySQL Diesel Full SQL support with migrations
MongoDB Native driver ObjectId, embedded docs, aggregations

Authentication

Method Features
JWT Stateless auth, configurable expiry, Argon2
OAuth2/OIDC Keycloak support, JWKS validation

Entity Generation

  • Full CRUD operations (GET, POST, PUT, DELETE)
  • Field types: String, Integer, Long, Float, Double, Boolean, Date, Blob, UUID
  • Validations: required, min/max length, pattern, min/max values
  • Pagination and sorting
  • Relationships: ManyToOne, OneToMany, OneToOne, ManyToMany

Frontend Support

  • Angular (full JHipster client)
  • React (full JHipster client)
  • Vue (full JHipster client)

Testing

  • Rust unit tests for services and handlers
  • Integration tests with test database
  • Cypress E2E tests for UI testing

Deployment

  • Multi-stage Dockerfile for optimized images
  • Docker Compose for full stack deployment
  • Monolithic mode for single-server deployment

Installation

npm install -g generator-jhipster-rust

Usage

# Create a new project
mkdir myapp && cd myapp
jhipster-rust

# Generate an entity
jhipster-rust entity Product

Requirements

  • Node.js ^18.19.0 or >= 20.6.1
  • JHipster 8.11.0
  • Rust 1.75.0 or later
  • Diesel CLI (for SQL databases)

Breaking Changes

None in this release.

Known Issues

  • SQLite is not recognized by JHipster core's getDatabaseData function; blueprint handles this internally

Future Roadmap

Feature Status
Redis Caching Planned
Rate Limiting Planned
API Versioning Planned
GraphQL Planned
WebSocket Planned
Embedded Assets Planned

Contributors

License

Apache-2.0

Links

Assets 2
Loading