ephemeris_bazi

Pre-release: 1.0.0-beta.6, kept in lockstep with the Dart ephemeris core package.

BaZi (八字) extension bindings for the Taiyin ephemeris, part of the dart-ephemeris monorepo. Mirrors packages/ephemeris-bazi in the Python binding.

dart pub add ephemeris
dart pub add ephemeris_bazi

Generated API reference: pub.dev/documentation/ephemeris_bazi/latest/

See the BaZi guide for local/instant birth inputs, custom calendar contexts, Qi-Yun, Da-Yun/Xiao-Yun, Ten Gods, relations, Shen Sha, and ownership.

Depends on the core ephemeris package. Importing this package adds context.bazi and context.createBazi() to EphemerisContext:

import 'package:ephemeris/ephemeris.dart';
import 'package:ephemeris_bazi/ephemeris_bazi.dart';

void main() {
  final ephemeris = Ephemeris.open();
  final context = ephemeris.createContext();
  try {
    final result = context.bazi.calculateLocal(
      AstroDateTime(2003, 3, 13, 14, 15),
      gender: BaziGender.male,
    );
    print(result.value.chart.dayPillar);
    print(result.value.qiyun.startCivilTime);
    print(result.flags.values);
  } finally {
    context.close();
  }
}

A BaZi context binds one ChineseCalendarContext at creation (the cached default calendar unless createBazi(calendar: ...) says otherwise) and resolves solar terms through it; the calendar must belong to the same EphemerisContext.

This package ships and lazily loads its own libtaiyin_bazi native module; the root ephemeris package does not contain BaZi symbols. Override the bundled module with TAIYIN_BAZI_LIBRARY_PATH or createBazi(libraryPath: ...). A missing module raises UnsupportedError while the core context remains usable.

For isolate parallelism, open the process runtime once, call Ephemeris.attach().createContext() in every worker, and create one BaZi context per worker. Do not send native-backed Dart objects between isolates.

dart test