[vistart]

Description

Aligns this backend with the core execution-logging contract introduced in rhosocial/python-activerecord#137.

• execute_many accepts keyword-only options: ExecutionOptions | None and forwards it to the shared helpers; backends without overrides inherit the core implementation.
• Single and batch executions use log_execution_start, log_batch_start, log_execution_summary, log_batch_summary and log_execution_error from core. Raw SQL/parameter logging and duplicate batch summaries are removed.
• Sync and async backends share the canonical rhosocial.activerecord.backend.<type> logger.
• Narrow backend log() overrides that dropped extra= are removed where present; CLI modules use the configured library logger.
• INFO SQL and lifecycle chatter is downgraded to DEBUG; ERROR records logged immediately before a re-raise are downgraded to DEBUG, while swallowed recovery failures stay WARNING.
• Adds the four shared-contract bridges: ordered-has-many, find-one-or-create, read-only models, keyless models.
• Backend-specific test/schema gaps exposed by those contracts are fixed in this branch (for example orderable text columns and integrity-error normalization).

Depends on the core branch feature/logging-execution (PR rhosocial/python-activerecord#137); the temporary CI core reference points there.

No tracking issue.

Type of change

• feat: A new feature
• changed: A change in existing functionality
• docs: Documentation only changes
• test: Adding missing tests or correcting existing tests
• perf: A code change that improves performance
• chore: Changes to the build process or auxiliary tools and libraries
• ci: Changes to our CI core reference
• build: Changes that affect the build system or external dependencies
• revert: Reverts a previous commit

Breaking Change

• Yes, for end-users
• Yes, for backend developers
• No breaking changes

Impact on End-Users:

INFO output no longer contains raw SQL or parameter values; the backend now emits the core dml.* / dql.* / ddl.* / transaction.* summaries.

Impact on Backend Developers (Custom Implementations):

Custom overrides of execute_many, fetch_all or fetch_one must accept the new options / log_context keywords.

Applicable rhosocial-activerecord Version Range:

rhosocial-activerecord>=1.0.0.dev30,<2.0.0 once the core PR is released; CI currently tracks the core branch.

Related Repositories/Packages

• feat(logging): backend execution summaries and query log removal python-activerecord#137 (core execution logging)
• Testsuite release/v1.0.0.dev17

Testing

• I have added new tests to cover my changes.
• I have updated existing tests to reflect my changes.
• All existing tests pass in CI.
• This change has been tested on the backend's CI matrix.

Test Plan:

pytest tests/rhosocial/activerecord_bigquery_test/feature/relation/ordering/test_has_many_order_by.py
pytest tests/rhosocial/activerecord_bigquery_test/feature/query/basic/test_find_one_or_create.py
pytest tests/rhosocial/activerecord_bigquery_test/feature/basic/readonly/test_readonly_models.py
pytest tests/rhosocial/activerecord_bigquery_test/feature/basic/nopk/test_keyless_models.py

BigQuery emulator runs with a fresh container per module: 132 wrapper tests passed.

Checklist

• My code follows the project's code style guidelines.
• I have performed a self-review of my own code.
• I have commented my code, particularly in hard-to-understand areas.
• I have made corresponding changes to the documentation where needed.
• My changes generate no new warnings.
• I have added a changelog fragment (changelog.d/<issue_number>.<type>.md).
• I have verified that my changes do not introduce SQL injection vulnerabilities.
• I have checked for potential performance regressions.

Additional Notes

The changelog fragment is added after the PR number is known. The CI core reference will be switched to the next core release after PR rhosocial/python-activerecord#137 merges.

[codecov]

Codecov Report

❌ Patch coverage is 82.14286% with 10 lines in your changes missing coverage. Please review.
✅ Project coverage is 80.31%. Comparing base (2b84cde) to head (0f709e4).

Files with missing lines	Patch %	Lines
...ord/backend/impl/bigquery/backend/async_backend.py	76.00%	6 Missing ⚠️
...iverecord/backend/impl/bigquery/backend/backend.py	85.18%	4 Missing ⚠️

Additional details and impacted files

@@                   Coverage Diff                   @@
##           release/v1.0.0.dev1       #9      +/-   ##
=======================================================
+ Coverage                75.11%   80.31%   +5.19%     
=======================================================
  Files                       44       44              
  Lines                     3203     3225      +22     
  Branches                   419      421       +2     
=======================================================
+ Hits                      2406     2590     +184     
+ Misses                     708      534     -174     
- Partials                    89      101      +12     

Flag	Coverage Δ
python-3.12	80.31% <82.14%> (+5.19%)	⬆️
unittests	80.31% <82.14%> (+5.19%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[sonarqubecloud]

Quality Gate failed

Failed conditions
3.3% Duplication on New Code (required ≤ 3%)

See analysis details on SonarQube Cloud