Vridlo/types/Exercise: Difference between revisions

Latest revision as of 18:22, 24 December 2019

Exercise is a secondary structure that represents Exercise model, which is used for describing a subtask of the Assembler's task. It is described as:

no is natural mandatory write-once

Number of subtask in the task. Is unique per task in the context of the current assembler.

kind is string mandatory write-once

Kind of the subtask. Is one of repo, srpm, delete, copy.

app_slug is string mandatory write-once

Unique name of the application, which the RPM belongs to.

committer_slug is string mandatory write-once

The subtask committer slug in the context of the current assembler. The slug represents User structure, which is defined by a user's Recital record placed with the kind of login.

task_no is natural mandatory write-once

Task identifier in the context of the current assembler.

source_path_slug is string mandatory write-once

Slug of the source path, which the parent task belongs to.

resource is string optional write-once

Name of the source build or resource for the task. If kind is copy, resource is the source for copying the package, and must be in format of <repo_name>:<package_name>, for example sisyphus:GeoIP-ASNum. If kind is repo, the resourse is external git repo URI, which must match one of the values of repo's filename field. If kind is srpm,  the resourse is RPM file name, which must match to one of the presented in the RPM field filename. If kind is delete, the resourse must be blank.

sha is string[56] optional write-once

SHA2 224 40-byted checksum over the referenced object matching the field sha in the repo. It must be blank unless the kind is repo.

approver_slugs is string array optional

Array of slugs of the subtask approver people in the context of the current assembler. The slug represents User structure, which is defined by a user's Recital record placed with the kind of login.

@@ Line 1: / Line 1: @@
-'''Assembler''' is read-only structure that represents RPM assembler model. It is described as:
+'''Exercise''' is a '''''secondary''''' structure that represents Exercise model, which is used for describing a subtask of the [[Vridlo/types/Assembler|Assembler]]'s [[Vridlo/types/Task|task]]. It is described as:
-* '''slug''' is ''string '''mandatory write-once'''''
+* '''no''' is ''natural '''mandatory write-once'''''
-  Unique internal identifier of the file representing by a string. Can contain only letters and underscores.
+  Number of subtask in the task. Is unique per task in the context of the current assembler.
-* '''name''' is ''string '''optional'''''
+* '''kind''' is ''string '''mandatory write-once'''''
-  Name of the assembler.
+  Kind of the subtask. Is one of ''repo'', ''srpm'', ''delete'', ''copy''.
-* '''host''' is ''string '''optional'''''
+* '''app_slug''' is ''string '''mandatory write-once'''''
-  Host URI of of the assembler.
+  Unique name of the [[Vridlo/types/App|application]], which the RPM belongs to.
-* '''export_path_base''' is ''string '''optional'''''
+* '''committer_slug''' is ''string '''mandatory write-once'''''
-  Internal export path base. The path base can be appended to ftp path for the assembler, and prepended to specific arch suffix in order, to read the RPM packages.
+  The subtask committer slug in the context of the current assembler. The slug represents [[Vridlo/types/User|User]] structure, which is defined by a user's [[Vridlo/types/Recital|Recital]] record placed with the kind of ''login''.
-* '''source_path_count''' is ''string '''read-only'''''
+* '''task_no''' is ''natural '''mandatory write-once'''''
-  Count of held [[Vridlo/types/SourcePath|RPM source paths]] in the assembler.
+  Task identifier in the context of the current assembler.
-    t.integer "no", null: false, comment: "Число задачи в задании"
+* '''source_path_slug''' is ''string '''mandatory write-once'''''
-    t.string "kind", null: false, comment: "Вид задания"
+ Slug of the [[Vridlo/types/SourcePath|source path]], which the parent task belongs to.
-    t.string "pkgname", null: false, comment: "Имя пакета для задания"
-    t.string "resource", comment: "Имя исходного сбора или ресурс исходников для задания"
+* '''resource''' is ''string '''optional write-once'''''
-    t.string "sha", comment: "Хеш соборочный для задания"
+ Name of the source build or resource for the task. If '''kind''' is ''copy'', '''resource''' is the source for copying the package, and must be in format of ''<repo_name>:<package_name>'', for example ''sisyphus:GeoIP-ASNum''. If '''kind''' is ''repo'', the '''resourse''' is external git repo URI, which must match one of the values of [[Vridlo/types/Vcs|repo's]] '''filename''' field. If '''kind''' is ''srpm'',  the '''resourse''' is RPM file name, which must match to one of the presented in the [[Vridlo/types/Rpm|RPM]] field '''filename'''. If '''kind''' is ''delete'', the '''resourse''' must be blank.
-    t.string "committer_slug", null: false, comment: "Автор воплета задания"
-    t.bigint "task_id", null: false, comment: "Ссылка на задачу"
+* '''sha''' is ''string[56] '''optional write-once'''''
-    t.string "approver_slugs", null: false, comment: "Ссылка на заверщика задания"
+ [https://en.wikipedia.org/wiki/SHA-2 SHA2 224] 40-byted checksum over the [[Vridlo/types/Ref|referenced object]] matching the field '''sha''' in the [[Vridlo/types/Vcs|repo]]. It must be blank unless the '''kind''' is '''repo'''.
+* '''approver_slugs''' is ''string array '''optional'''''
+ Array of slugs of the subtask approver people in the context of the current assembler. The slug represents [[Vridlo/types/User|User]] structure, which is defined by a user's [[Vridlo/types/Recital|Recital]] record placed with the kind of ''login''.