VersaTul Documentation
  • Getting Started
    • What VersaTul Gives You
    • Quickstart Outcome
    • Prerequisites
    • Create A Sample App
    • Recommended First Path
    • Install A Package
    • Paste This Example
    • Run The App
    • What You Should See
    • Why This Is A Good First Step
    • Common Mistakes
    • How To Choose A First Package
    • Beginner Guidance
    • What This Documentation Does Not Cover
    • What To Read Next
  • Choosing Packages
    • Start With The Problem
      • Fast Recommendations
      • Application Foundation
      • Data Access And Data Movement
      • Output, Transformation, And Files
      • Logging, Mail, And Scheduling
    • Common Package Combinations
    • Decision Tables
    • Start Here If
    • Not The Best First Move If
    • Selection Rules That Usually Help
    • Selection Rules That Usually Hurt
    • For Advanced Users
    • What To Read Next
  • Scenario Guides
    • What These Guides Focus On
    • Recommended Order
    • What To Read Next
      • File Import Workflow
      • Data Export Workflow
      • Logging Setup Workflow
      • SQL Data Access Workflow
  • Recommended Paths
    • Console App Or Utility Tool
    • Service With Relational Data Access
    • SQL Server Import Pipeline
    • Reporting Or Export Workflow
    • Operational Logging Baseline
    • Notification Or Mail Workflow
    • Background Processing Or Scheduling
    • Selection Rules
    • What To Read Next
  • Compatibility And Support
    • Current Target Framework Baseline
    • Documented Package Surface
    • External Dependency Profile
    • Practical Compatibility Guidance
    • Compatibility Expectations By Package Style
    • What This Page Does Not Promise
    • What To Read Next
  • FAQ
    • Is VersaTul One Framework Or A Set Of Packages?
    • What Is The Best First Package To Try?
    • How Do I Know Which Package To Pick?
    • Do I Need To Adopt A Large Part Of The Ecosystem At Once?
    • Are The Packages Intended To Work Together?
    • Should I Start With Data.Sql Or Data.MsSql?
    • Should I Start With Logger Or A Concrete Logger Package?
    • What If My Main Need Is Import Or Export?
    • How Stable Is The Documentation Path For New Users?
    • What Should I Read After The First Successful Quickstart?
  • Package Catalog
    • How To Use This Page
    • Foundation Packages
    • Data And Storage Packages
    • File, Processing, And Transformation Packages
    • Operational Packages
    • Relationship Highlights
    • Recommended Browsing Paths
  • Configuration
    • Overview
    • Why Use This Package
    • When To Use This Package
    • Installation
    • Related Packages
    • Start Here If
    • Not The Right First Package If
    • Works Well With
    • Core Types And Concepts
    • Key Behaviors
    • Basic Example
    • Binding Example
    • Expected Result
    • Next Step
    • Notes
  • Configuration Defaults
    • Overview
    • When To Use This Package
    • Installation
    • Related Packages
    • Core Types And Concepts
    • Supported Builder Namespaces
    • Key Builder Features
    • Basic Example
    • Composed Example
    • Typical Default Keys
    • Notes
  • Contracts
    • Overview
    • When To Use This Package
    • Installation
    • Related Packages
    • Core Types And Concepts
    • Basic Example
    • Async Contract Example
    • Notes
  • Data Contracts
    • Overview
    • When To Use This Package
    • Installation
    • Related Packages
    • Core Types And Concepts
    • Key Capabilities
    • Repository Example
    • Paging Example
    • Notes
  • Object Converters
    • Overview
    • When To Use This Package
    • Installation
    • Related Packages
    • Core Types And Concepts
    • Key Capabilities
    • Basic Example
    • Flattening Example
    • Property Processing And Display Metadata
    • Notes
  • Extensions
    • Overview
    • When To Use This Package
    • Installation
    • Related Packages
    • Core Types And Concepts
    • Basic Example
    • Dictionary And Flattening Example
    • Currency Example
    • Notes
  • Utilities
    • Overview
    • When To Use This Package
    • Installation
    • Related Packages
    • Core Types And Concepts
    • Key Capabilities
    • Basic Example
    • Enum And Collection Example
    • Property Mapping Example
    • Notes
  • Caching
    • Overview
    • When To Use This Package
    • Installation
    • Related Packages
    • Core Types And Concepts
    • Key Capabilities
    • Basic Example
    • Expiration Example
    • Async And Eviction Example
    • Notes
  • Data Bulk
    • Overview
    • When To Use This Package
    • Installation
    • Related Packages
    • Core Types And Concepts
    • Key Capabilities
    • Basic Example
    • Async Progress Example
    • Mapping Options
    • Notes
  • Data Sql
    • Overview
    • Why Use This Package
    • When To Use This Package
    • Installation
    • Related Packages
    • Start Here If
    • Not The Right First Package If
    • Works Well With
    • Core Types And Concepts
    • Key Capabilities
    • Basic Example
    • Command And Mapping Example
    • Expected Result
    • Next Step
    • Provider Notes
    • Notes
  • Data MsSql
    • Overview
    • Why Use This Package
    • When To Use This Package
    • Installation
    • Related Packages
    • Start Here If
    • Not The Right First Package If
    • Works Well With
    • Core Types And Concepts
    • Key Capabilities
    • Basic Data-Service Example
    • Bulk Copy Example
    • Expected Result
    • Next Step
    • Notes
  • Data MongoDB
    • Overview
    • When To Use This Package
    • Installation
    • Related Packages
    • Core Types And Concepts
    • Key Capabilities
    • Basic Repository Example
    • Filtering Example
    • Connection Override Notes
    • Notes
  • EFCore
    • Overview
    • When To Use This Package
    • Installation
    • Related Packages
    • Core Types And Concepts
    • Key Capabilities
    • Basic Example
    • Specification Example
    • Notes
  • Data FileReader
    • Overview
    • Why Use This Package
    • When To Use This Package
    • Installation
    • Related Packages
    • Start Here If
    • Not The Right First Package If
    • Works Well With
    • Core Types And Concepts
    • Key Capabilities
    • Basic Example
    • Directory Example
    • Bulk Workflow Example
    • Expected Result
    • Next Step
    • Dependency Injection
    • Notes
  • Compression
    • Overview
    • When To Use This Package
    • Installation
    • Related Packages
    • Core Types And Concepts
    • Key Capabilities
    • Basic Example
    • Unzip Example
    • Notes
  • Collection Streamers
    • Overview
    • Why Use This Package
    • When To Use This Package
    • Installation
    • Related Packages
    • Start Here If
    • Not The Right First Package If
    • Works Well With
    • Core Types And Concepts
    • Key Capabilities
    • Basic CSV Example
    • IDataReader Example
    • Direct To Disk Example
    • IDataReader To Disk Example
    • Save To Disk Example
    • Expected Result
    • Next Step
    • Notes
  • Display Attributes
    • Overview
    • When To Use This Package
    • Installation
    • Related Packages
    • Core Types And Concepts
    • Key Capabilities
    • Attribute Example
    • Analyzer Example
    • Notes
  • Handler File
    • Overview
    • When To Use This Package
    • Installation
    • Related Packages
    • Core Types And Concepts
    • Key Capabilities
    • Save Text Example
    • Read Example
    • Save Stream Example
    • Notes
  • Pipeline Infrastructure
    • Overview
    • When To Use This Package
    • Installation
    • Related Packages
    • Core Types And Concepts
    • Key Capabilities
    • Step Example
    • Pipeline Example
    • Diagnostics Example
    • Notes
  • Logger
    • Overview
    • Why Use This Package
    • When To Use This Package
    • Installation
    • Related Packages
    • Start Here If
    • Not The Right First Package If
    • Works Well With
    • Core Types And Concepts
    • Key Capabilities
    • Basic Example
    • Parser Example
    • Expected Result
    • Next Step
    • Notes
  • Logger File
    • Overview
    • Why Use This Package
    • When To Use This Package
    • Installation
    • Related Packages
    • Start Here If
    • Not The Right First Package If
    • Works Well With
    • Core Types And Concepts
    • Key Capabilities
    • Basic Example
    • Expected Result
    • Next Step
    • Configuration Notes
    • Notes
  • Logger Mail
    • Overview
    • When To Use This Package
    • Installation
    • Related Packages
    • Core Types And Concepts
    • Key Capabilities
    • Basic Example
    • Operational Notes
    • Notes
  • Logger Web
    • Overview
    • When To Use This Package
    • Installation
    • Related Packages
    • Core Types And Concepts
    • Key Capabilities
    • Basic Example
    • Configuration Notes
    • Notes
  • Mailer
    • Overview
    • Why Use This Package
    • When To Use This Package
    • Installation
    • Related Packages
    • Start Here If
    • Not The Right First Package If
    • Works Well With
    • Core Types And Concepts
    • Key Capabilities
    • Basic Example
    • Template Example
    • Expected Result
    • Next Step
    • Notes
  • Scheduler
    • Overview
    • When To Use This Package
    • Installation
    • Core Types And Concepts
    • Key Capabilities
    • Basic Example
    • Scheduled Event Example
    • Notes
VersaTul Documentation
  • Recommended Paths
  • View page source

Recommended Paths

This page gives opinionated starting points for common application types so new adopters do not have to assemble a package set from scratch.

Use these as small starting sets, not as instructions to install everything at once.

Console App Or Utility Tool

Start with:

  1. Configuration

  2. Extensions or Utilities

  3. Logger File if operational visibility matters

Why this path works:

It gives a small application explicit settings, reusable helpers, and simple local logging without adding unnecessary infrastructure.

Service With Relational Data Access

Start with:

  1. Configuration

  2. Data Sql

  3. Data Contracts

  4. Logger and a sink such as Logger File

Then add:

  1. Data MsSql only if SQL Server-specific behavior becomes necessary.

Best next read:

  1. SQL Data Access Workflow

SQL Server Import Pipeline

Start with:

  1. Data FileReader

  2. Data Bulk

  3. Data MsSql

  4. Logger File

Why this path works:

It separates file parsing, schema mapping, upload execution, and diagnostics into clear package boundaries.

Best next read:

  1. File Import Workflow

Reporting Or Export Workflow

Start with:

  1. Collection Streamers

  2. Display Attributes

  3. Object Converters

  4. Compression when archive output matters

  5. Mailer when exported files need delivery

Why this path works:

It keeps export structure, formatting, and delivery concerns modular.

Best next read:

  1. Data Export Workflow

Operational Logging Baseline

Start with:

  1. Logger

  2. Logger File

Then expand to:

  1. Logger Mail for alerting by email

  2. Logger Web for remote endpoint delivery

Best next read:

  1. Logging Setup Workflow

Notification Or Mail Workflow

Start with:

  1. Configuration

  2. Mailer

  3. Collection Streamers when attachments are generated from exported data

Why this path works:

It keeps transport, settings, and attachment generation separate.

Background Processing Or Scheduling

Start with:

  1. Scheduler

  2. Logger File

  3. Configuration

Why this path works:

Recurring jobs are much easier to adopt safely when scheduling, settings, and diagnostics are in place from the start.

Selection Rules

  1. Start from the application problem, not the full package catalog.

  2. Prefer one workflow path at a time.

  3. Add sink or storage-specific packages only after the base workflow is working.

  4. Use scenario guides when two or more packages are likely to be adopted together.

What To Read Next

  1. Read Choosing Packages if your application type still maps to several possible starting sets.

  2. Read Scenario Guides if you want the end-to-end version of one of these paths.

  3. Read Compatibility And Support if framework support and dependency shape are still part of the evaluation.

Previous Next

© Copyright 2026, VersaTul.

Built with Sphinx using a theme provided by Read the Docs.