conduit_test

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

conduit_test provides a suite of utilities to simplify writing automated tests for Conduit applications. It offers helpers for setting up test servers, managing database connections, and simulating HTTP requests and responses. Designed specifically for the Conduit framework, it enables developers to verify application logic, authentication flows, and API endpoints with ease. The package integrates seamlessly into Flutter and Dart projects, supporting cross-platform testing on macOS, Windows, and Linux. It enhances test reliability and reduces boilerplate code in test suites.

Use cases

Testing API endpoints
Validating authentication workflows
Simulating HTTP requests
Database integration testing
Verifying server behavior
Automated regression testing

Key features

Test server setup utilities
HTTP request simulation
Database connection management
Cross-platform support
Minimal boilerplate
Integration with Conduit framework

Suitable for

Conduit backend developers
API testing specialists
CI/CD pipeline integrators
Full-stack Dart developers
Test automation engineers

Considerations

Requires Conduit framework
Limited to server-side testing
Needs proper test environment setup
Not suitable for UI testing
Dependent on Conduit's architecture
Best used in dedicated test environments

Original README snapshot from the linked source repository. Visit the repository for the latest content.

Conduit is a fork of Stablekernel's Aqueduct, a modern Dart HTTP server framework.

Getting Started

Install Dart.
Activate Conduit.

dart pub global activate conduit

Create a new project.

conduit create my_project

Serve the project.

cd my_project
conduit serve

Building from Source

If you want to contribute to Conduit or build it from source, you will need Melos.

Install Melos:

dart pub global activate melos

Bootstrap the project:

melos bootstrap

Run tests:

[!IMPORTANT] Tests require a running PostgreSQL instance and specific environment variables. You can start the database using Docker: docker-compose -f ci/docker-compose.yaml up -d

export POSTGRES_USER=conduit_test_user
export POSTGRES_PASSWORD=conduit!
export POSTGRES_DB=conduit_test_db
export POSTGRES_PORT=15432
export POSTGRES_HOST=localhost

melos run test-unit

Tutorials, Documentation and Examples

We are currently in the process of collating helpful resources for your edification. Our main docs live here.

Conduit is a close fork to Aqueduct, so Aqueduct examples can be tweaked to work with Conduit here. The major concern is updating the code to use null-safety.