The settings every contents write shares — the eight properties CreateFileOptions, UpdateFileOptions, DeleteFileOptions and ChangeFilesOptions all declare.
Split into its own type rather than repeated on four commands, so the wire spellings and the semantics live in one place. Rule 4 of com.worxbend.codeberg4s.codec.WireConventions is the same argument on the codec side.
==Branching==
branch says where to read the current state from; newBranch says to create a branch there first and commit onto that instead. Together they are how a caller opens a change for review without touching the default branch. forceOverwriteNewBranch is the escape hatch for the case where newBranch already exists — it force-pushes, and it is off by default because a silent force-push is not something a library should do on its own initiative.
Value parameters
- author
-
who the commit is attributed to — see CommitIdentity
- branch
-
the branch to base the change on. Absent means the repository's default branch
- committer
-
who applied it — see CommitIdentity
- dates
-
the commit's author and committer dates — see CommitDates
- forceOverwriteNewBranch
-
force-push when newBranch already exists. See the note above
- message
-
the commit message. Absent lets Forgejo compose its own, which names the operation and the path
- newBranch
-
a branch to create from branch and commit onto. Absent commits onto branch itself
- signoff
-
add a
Signed-off-bytrailer for the committer
Attributes
- Companion
- object
- Graph
-
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass Any