tuddy
v1.1.8
Published
Import, export, synchronize Pivotal Tracker, GitHub Issues, Trello, JIRA, Sprintly, Teuxdeux, and all Super Common Story Format compatible mapped systems
Downloads
7
Readme
Tuddy
EXPERIMENTAL
Export, import, synchronize, stories, tasks, todos, such as Trello, Pivotal Tracker, JIRA, Github, Sprintly, Teuxdeux, etc.
var client = tuddy();
client.addIntegration({ name: 'myTello', type: 'trello', key: '', token: '', board_id: ''});
client.addIntegration({ name: 'myGithub', type: 'github', user: '', repo: '', access_token: ''});
client.addIntegration({ name: 'myJira', type: 'jira', host: '', username: '', password: ''});
client.addIntegration({ name: 'myPivotal', type: 'pivotal', project: '', token: ''});
client.addIntegration({ name: 'myTeuxdeux', type: 'teuxdeux', username: '', password: ''})
client.addIntegration({ name: 'mySprintly', type: 'sprintly', product: '', email: '', key: ''})
If you would like to pull data from an integration:
client.pull('myTrello').then((stories) => {
console.log(stories);
});
client.pull('myGithub').then((stories) => {
console.log(stories);
});
client.pull('myJira').then((stories) => {
console.log(stories);
});
client.pull('myPivotal').then((stories) => {
console.log(stories);
});
client.pull('myTeuxdeux').then((stories) => {
console.log(stories);
});
client.pull('mySprintly').then((stories) => {
console.log(stories);
});
If you would like to push data to an integration:
var stories = [
{
name: 'I love creating Trello cards',
description: 'Writing cards to any system using the same format is fun.'
}
];
client.push('myTrello', stories).then((result) => {
console.log(result);
});
Super Common Story Format
Super Common Story Format (SCSF) is an experimental attempt to unify task systems such that a common container format can be used as an interchange format between different systems.
EXPERIMENTAL
| Field | Description | Example | JIRA | Trello | Pivotal | GitHub | Teuxdeux | | ------ | ------ | ------ | ------ | ------ | ------ | ------ | ------ | | meta.source.name | A text identifier of the source service | trello | | "trello" | | | | | meta.source.data | Array of data from source | | | | | | | | data.id | unique identifier | 237623762 | id | id | id | id | id | | data.self | API url for item | http://example.com/api/item/5 | self | - | - | url | - | | data.key | alternate unique identifier | TSK-01 | key | idShort | | number | uuid | | data.name | summary of the item | do a thing | fields.summary | name | name | title | text | | data.description | full description of the item | We want do a thing not because it is easy but because it is hard. | fields.description | desc | | body | - | | data.project.id | parent identifier | 347632746 | fields.project.id | idBoard | project_id | this.integration.repo | | | data.type | type of item | task | issue | bug | feature | story | issuetype.name | - | kind | | | | data.url | url for item in it's native UI | http://example.com/item/5 | | url | urk | html_url | | | data.archived | is item archived indicator | yes | no | | | - | | | | data.status | working status of item | open | closed | backlog | current | | | current_state | state | done | | data.date.start | datetime and item should begin | | | | | | | | data.date.end | synonomous to date.due | | | | | | | | data.date.due | datetime item is due | 2015-08-14T15:05:55+00:00 | fields.duedate | due | | | | | data.date.completed | datetime item was completed | 2015-08-14T15:05:55+00:00 | | | | closed_at | | | data.date.created | datetime item was created | 2015-08-14T15:05:55+00:00 | fields.created | dateLastActivity | created_at | created_at | | | data.date.updated | datetime item was last updated | 2015-08-14T15:05:55+00:00 | fields.updated | dateLastActivity | updated_at | updated_at | deletedAt | | data.date.deleted | datetime and item was deleted | | | | | | start_date | | data.lists | array of lists/columns to which the story belongs | | | | | | | | data.lists.list.id | | | | | | | | | data.lists.list.position | | | | | | | | | data.labels | | | | | | | | | data.email | | | | | | | | | data.shortUrl | | | | | | | |