kkrunner.projects.Project

class kkrunner.projects.Project(id, generation, name, parent_id=None, directory=None)[source]

Bases: object

One immutable project snapshot.

Projects provide the namespace for tracked KKRunner runs independently of any user interface. Local editing methods return another snapshot at the same generation; ProjectRepository advances generation only after a successful persistent save.

Parameters:
  • id (str)

  • generation (int)

  • name (str)

  • parent_id (str | None)

  • directory (str | None)

id: str
generation: int
name: str
parent_id: str | None = None
directory: str | None = None
modify(*, name=<object object>, parent_id=<object object>, directory=<object object>)[source]

Return an edited snapshot without changing its generation.

Omitted arguments preserve their current values. Pass None to clear parent_id or directory. The same validation as for a newly constructed project applies to every supplied attribute.

Return type:

Project