Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
'headers': {
 	"linux_username": "string",
	"gitubgithub_username": "string" 
},
'body': {
	"caterNumber": "string"
	"component": "string"
	"issueTracker": "string", // OPTIONAL, typically provided in the component DB
}

Behavior/FlowUser see's cater → calls CLI '$ bs create issue' → CLI asks user for cater ID, and component → CLI passes in api request above → backend creates issue using information on the cater

  1. Given the input information, the backend creates an issue on the appropriate issueTracker.
  2. Typically the issueTracker is contained in the component DB, but the user can specify issueTracker to override.
  3. Using information on the cater backend returns a link to new issue.
  4. Ideally a comment is added to both the cater and the new issue cross-referencing each other

Return

Code Block
{
	"error": "string"
	"issueUrl": "string"
}


Add new version for active development on component - TBD:

Code Block
'headers': {
 	"linux_username": "string",
	"gitubgithub_username": "string" 
},
'body': {
	"component": "string"
	"version": "string"
}

TBD

Create new branch

Code Block
'headers': {
 	"linux_username": "string",
	"gitubgithub_username": "string" 
},
'body': {
	"component": "string"
	"branch": "string" 		// Name of newly created branch
}

Behavior/Flow

  1. User creates the new branch using the CLI
  2. CLI notifies the backend that the branch has been created
  3. Backend records to branches_in_development_schema

Returns 

Code Block
{
	"error": "string"
}


Checkout component

Code Block
'headers': {
 	"linux_username": "string",
	"gitubgithub_username": "string" 
},
'body': {
	"component": "string"
	"branch": "string"
}

Behavior/Flow

  1. Not clear that this is actually needed - but if we need 'eco' like functionality, we might implement this

Returns nothing

Push 

Code Block
// Any reason we can't use git directly?

Behavior/Flow

  1. Not clear that this is actually needed

Returns nothing

Mark complete (use when a dev is done, to notify backend the development is considered done)

Code Block
'headers': {
 	"linux_username": "string",
	"gitubgithub_username": "string" 
},
'body': {
	"component": "string"
	"branch": "string"
	"isComplete": bool
}

Behavior/Flow

  1. Using the input information, the backend sets the developmentComplete field on the branches_in_development_schema appropriately.

Returns

Code Block
{
	"error": "string"
}


Start Build (called by runner / cli)

Code Block
'headers': {
 	"linux_username": "string",
	"gitubgithub_username": "string" 
},
'body': {
  	"component": "string"
	"branch": "string"   
}

Behavior/Flow

  1. User creates the new branch using the CLI
  2. CLI notifies the backend that the branch has been created
  3. Backend records to branches_in_development_schema

Returns