[JGamboa]

📑 Description

Part of goravel/goravel#1000 (section D). Follows #1575. Roadmap: goravel/goravel#1015

Adds Increment(column string, value ...uint64) error and Decrement(...) to orm.Query, with the same signatures as db.Query. The amount defaults to 1, and the column is quoted by the grammar (UPDATE ... SET `votes` = `votes` + ?).

facades.Orm().Query().Model(&Post{}).Where("id", 1).Increment("views")
facades.Orm().Query().Model(&user).Decrement("credits", 5) // also updates user.Credits in memory

Semantics. Both are built on Update, so they behave like any other ORM update rather than the raw db.Query version:

• Conditions, scopes and soft deletes: conditions, global scopes and soft deletes are applied. WithoutGlobalScopes() and WithTrashed() lift them as usual.
• Timestamps: updated_at is touched.
• Events: like Update, Saving/Updating/Updated/Saved fire only when the query has a model with a primary key (Model(&user).Increment(...)).
  • Query-level increments fire no events, matching Laravel's query builder.
  • WithoutEvents() is the equivalent of incrementQuietly.
• In-memory struct: Model(&user).Increment(...) also syncs the field of the loaded struct and its UpdatedAt, as Laravel does. This only happens when a row was actually updated and no event replaced the expression.

Happy to change any of these choices if you prefer them closer to the DB module.

✅ Checks

• Added test cases for my code
  • Unit: TestIncrementAndDecrement and TestIncrementAndDecrementTouchUpdatedAt.
  • Integration: TestIncrementAndDecrement, covering conditions, Table, a loaded model with updated_at, and soft deletes. It passes on Postgres, MySQL, SQLite and SQL Server.

[codecov]

Codecov Report

❌ Patch coverage is 92.50000% with 3 lines in your changes missing coverage. Please review.
✅ Project coverage is 73.49%. Comparing base (84af91f) to head (5232491).

Files with missing lines	Patch %	Lines
database/gorm/query.go	92.50%	3 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #1578      +/-   ##
==========================================
+ Coverage   72.85%   73.49%   +0.63%     
==========================================
  Files         412      412              
  Lines       26820    26860      +40     
==========================================
+ Hits        19541    19742     +201     
+ Misses       7278     7117     -161     
  Partials        1        1              

☔ 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.

[JGamboa]

Review Ready