v5.0.0

[ddc]

Summary

fetchvalue now returns raw value instead of string.

[v5.0.0] Breaking Changes

• DBUtils.fetchvalue() and DBUtilsAsync.fetchvalue() now return the value with its
  native type. They previously coerced every result with str().

  # 4.x
  db.fetchvalue(select(func.count()).select_from(Model))   # "42"   (str)
  db.fetchvalue(select(Model.created_at))                  # "2026-08-12 15:04:05+00:00"
  
  # 5.0.0
  db.fetchvalue(select(func.count()).select_from(Model))   # 42     (int)
  db.fetchvalue(select(Model.created_at))                  # datetime(2026, 8, 12, ...)

  This is silent at import time: code that treated the result as a string (.startswith(),
  == "1", datetime.fromisoformat(...), string concatenation) will now fail at runtime or
  behave differently.

  Migration. Where a string is genuinely wanted, coerce at the call site — and note that
  a bare str() turns None into the string "None":

  value = db.fetchvalue(stmt)
  value = str(value) if value is not None else None

  Code that parsed the result back into a real type can now drop the parsing:

  # 4.x
  dt = datetime.fromisoformat(db.fetchvalue(select(Model.created_at)))
  # 5.0.0
  dt = db.fetchvalue(select(Model.created_at))

  fetchall() was already returning native types and is unaffected.

Type of Change

• Bug fix
• New feature
• Breaking change (existing functionality affected)
• Refactoring (no functional changes)
• Documentation
• CI/CD or build configuration
• Dependencies update
• Other

Testing

• Manual testing performed

Reviewer

• I understand that by approving this PR, I share responsibility for these changes

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.

Files with missing lines	Coverage Δ
ddcdatabases/core/configs.py	93.24% <100.00%> (ø)
ddcdatabases/core/constants.py	100.00% <100.00%> (ø)

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud