What Makes Agenix Different

1. Intelligent Marshalling & Serialization Architecture

• Multi-Protocol Marshalling: Agenix provides sophisticated object marshalling capabilities with automatic type detection and resolution
• Pluggable Serializers: Support for multiple serialization formats (JSON, XML, Binary) with automatic serializer selection
• Dynamic Content Resolution: Built-in variable substitution and dynamic content generation during test execution

2. Enterprise-Grade Resource Management

• Resource Path Type Resolution: Unique that can dynamically resolve types and properties from assembly resources ResourcePathTypeResolver
• Cached Type Resolution: Intelligent caching system for type lookups to improve performance in large test suites
• Flexible Resource Loading: Support for loading configuration and types from embedded resources with fallback mechanisms

3. Comprehensive Validation Ecosystem

• Multi-Format Validation: Dedicated validation modules for JSON, XML, Text, and Binary data
• NHamcrest Integration: Fluent assertion syntax with composable matchers
• Context-Aware Validation: Validation contexts that understand the testing environment and can adapt accordingly

4. Advanced Message Building Pattern

• Polymorphic Payload Builders: Support for different payload building strategies (marshalling, serialization, static content)
• Header Data Builders: Specialized builders for message headers with marshalling support
• Type-Safe Message Construction: Strong typing throughout the message building process

5. Modular Protocol Support

• Protocol Abstraction: Clean separation between protocol implementations (HTTP, GraphQL, SQL, etc.)
• Endpoint Configuration: Flexible endpoint configuration system that supports multiple communication protocols
• Producer/Consumer Pattern: Consistent messaging patterns across different protocols

6. Intelligent Reference Resolution

• Dependency Injection: Built-in reference resolver that acts as a lightweight DI container
• Auto-Detection: Automatic detection of available services and marshallers
• Named Resolution: Support for named instances and type-specific resolution

7. Enterprise Integration Features

• Session Management: Built-in session handling for complex enterprise workflows
• Context Propagation: Test context that maintains state across test steps
• Transaction Support: Database transaction management for data integrity

8. BDD Integration Excellence

• Reqnroll Plugin: Deep integration with Reqnroll (SpecFlow successor) for modern BDD testing
• Gherkin Support: Native support for Gherkin syntax with step definition automation
• Business-Readable Tests: Framework designed to bridge technical implementation and business requirements

9. Test Execution Engine

• Action-Based Architecture: Test actions as first-class citizens with lifecycle management
• Sequence Management: Before/after test sequences with dependency resolution
• Listener Pattern: Extensible test action listeners for custom behavior

10. Developer Experience Focus

• Fluent APIs: Consistent fluent interface design across all modules
• Type Safety: Strong typing throughout the framework to catch errors at compile time
• IntelliSense Support: Rich metadata and documentation for IDE integration

The framework's architecture demonstrates a sophisticated approach to test automation that goes beyond simple API testing, providing a comprehensive platform for complex enterprise testing scenarios with emphasis on maintainability, readability, and extensibility.

️ Framework Origins

This framework is based on the Citrus Framework, originally developed for Java-based integration testing. Key portions of this .NET implementation were derived from and inspired by the Citrus Framework codebase.

• Original Citrus Framework: Copyright (C) 2006-2024 the original author or authors
• License: Both projects are licensed under Apache License 2.0
• Agenix Implementation: Copyright (C) 2025 Agenix

We extend our gratitude to the Citrus Framework maintainers and contributors for their excellent work that served as the foundation for this .NET adaptation.

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

This project includes software derived from the Citrus Framework - see the NOTICE file for additional attribution details.

Related Projects

• Citrus Framework (Java) - The original framework that inspired this implementation

Table of Contents

• Overview
• Prerequisites
• Getting Started
• Module overview
• Development Guidelines

Overview

Agenix.ATF is a comprehensive test framework built on .NET 8.0, designed to provide robust testing capabilities with modern testing patterns and practices.

Technologies Used

• .NET 8.0 - Target framework
• C# 12.0 - Programming language
• NUnit 3.x-4.x - Testing framework
• NSubstitute - Mocking library

Prerequisites

Before you begin, ensure you have the following installed:

• .NET 8.0 SDK or later
• JetBrains Rider (recommended) or Visual Studio 2022+
• Git for version control

Getting Started

1. Clone the Repository

Module Overview

🏗️ Core Framework Modules

🌐 Protocol & Communication Modules

🎭 Testing Pattern Implementations

🔌 Framework Integration Modules

✅ Validation & Assertion Modules

🧪 Unit Test Project Modules

📋 Configuration & Support Files

🎯 Framework Capabilities