microsoft / task-scheduler Goto Github PK
View Code? Open in Web Editor NEWSchedule tasks in a monorepo
License: MIT License
Schedule tasks in a monorepo
License: MIT License
This is an API proposal. The goal is to break away from the concept of "steps" and truly use the graph to calculate the execution plan given the proper graph and scope:
const { createPipeline } = require("@microsoft/task-scheduler");
// this graph describes a topological graph, e.g. package dependencies
const graph = getDependencyGraph(); // e.g. { foo: {location: 'packages/foo', dependencies: ['bar']}, bar: { ... }}
const pipeline = await createPipeline(graph)
// defining a task with NO task dependencies
.addTask({
name: "prepare",
run: prepare
})
// defining a task with task dependencies as well as the topological deps
.addTask({
name: "build",
run: build,
deps: ["prepare"],
topologicalDeps: ["build"]
})
.addTask({
name: "test",
run: test,
deps: ["build"]
})
.addTask({
name: "bundle",
run: bundle,
deps: ["build"]
})
// allow here to scope the pipeline run - think of this as a way to use entry points to pick out the task graph for a traversal of task deps
.scope(["foo", "bar"])
// specify which of the tasks to run
.go(["test", "bundle"]);
async function prepare(cwd, stdout, stderr) {
...
}
async function build(cwd, stdout, stderr) {
...
}
async function test(cwd, stdout, stderr) {
...
}
async function bundle(cwd, stdout, stderr) {
...
}
Now that we've created p-graph - we can take advantage of it inside task-scheduler.
I believe from looking at the code, the go()
is where we will replace much of the code. There is also a bunch of step api -> the p-graph inputs:
const { default: pGraph } = require("p-graph"); // ES6 import also works: import pGraph from 'p-graph';
const putOnShirt = () => Promise.resolve("put on your shirt");
const putOnShorts = () => Promise.resolve("put on your shorts");
const putOnJacket = () => Promise.resolve("put on your jacket");
const putOnShoes = () => Promise.resolve("put on your shoes");
const tieShoes = () => Promise.resolve("tie your shoes");
const graph = [
[putOnShoes, tieShoes],
[putOnShirt, putOnJacket],
[putOnShorts, putOnJacket],
[putOnShorts, putOnShoes],
];
await pGraph(graph, { concurrency: 3 }).run();
Basically the add*Step() api should create that promise-function-edge array.
This task is linked to microsoft/lage#104.
Currently lage only gives a package graph and task graph separately, so task-scheduler doesn't know when some packages do not contain the tasks in the package.json.
Because of how the final combined package-task is generated, we might over-aggressively run tasks because of this missing info.
For example, if A depends on B and B depends on C:
A -> B -> C
and if only C has the task of special-C-build, when this following is called:
lage special-C-build --scope A
Nothing should be run because "A" doesn't have that task. The expected result is that nothing is run.
This task is to modify the api to accept the info for if a task can be run inside package
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.