The task library that just works
Перейти к файлу
Kenneth Chau 520225c867
Merge branch 'master' into fix-readme
2020-04-24 11:18:04 -07:00
.github Disable stale action bc it's not useful in current form (#347) 2020-04-13 08:55:29 -07:00
.vscode Add unit tests for tscTask (#183) 2019-07-18 11:02:11 -07:00
disabled/just-scenario-tests applying package updates 2020-04-24 17:42:34 +00:00
docs update docs 2019-09-26 16:37:51 +00:00
packages applying package updates 2020-04-24 17:48:46 +00:00
scripts API extractor task updates and other fixes (#336) 2020-04-13 08:53:50 -07:00
.dockerignore Scenario Testing - Part 1 (#55) 2019-04-03 12:43:26 -07:00
.eslintignore introduce eslint to the repo (#150) 2019-07-01 13:11:52 -07:00
.eslintrc.json introduce eslint to the repo (#150) 2019-07-01 13:11:52 -07:00
.gitignore fixing gitignore, and bumping stacks to major so semver ranges are fully working (#199) 2019-08-05 10:30:21 -07:00
.prettierignore Plop - just-stack switched to using plop for codegen (#194) 2019-08-04 23:06:02 -07:00
LICENSE microsoftify this repo 2019-01-25 15:02:11 -08:00
README.md adding more guidelines to how to make changes in the repo 2020-04-24 10:18:10 -07:00
TODO.md refactor lots of just-script 2019-01-20 18:19:57 -08:00
azure-pipelines.docs.yml pushing to master 2019-09-04 10:34:39 -07:00
azure-pipelines.pr.yml don't need PR builds for docs 2019-09-04 10:29:26 -07:00
azure-pipelines.yml don't trigger normal release with documentation 2019-09-04 10:32:25 -07:00
lerna.json fix typo and fix the build scripts 2019-06-26 10:47:38 -07:00
package.json get rid of docs builds 2020-03-06 11:40:40 -08:00
prettier.config.js Upgrade: now uses the diff-match-patch to upgrade stacks that has been realized (#60) 2019-04-10 13:26:15 -07:00
tsconfig.json introduce eslint to the repo (#150) 2019-07-01 13:11:52 -07:00
yarn.lock Switching to yargs-parser rather than yargs (#356) 2020-04-10 13:31:08 -07:00

README.md

Just

npm version NPM Downloads

Just is a library that organizes build tasks for your JS projects. It consists of

  • a build task build definition library
  • sane preset build flows for node and browser projects featuring TypeScript, Webpack and jest
  • project scaffold tool that generates no-ejection needed repos that tracks template changes

Documentation

All the documentation is online at https://microsoft.github.io/just/

Building

This README contains only the instructions on how to build and contribute to the project. This is a monorepo that uses the lerna monorepo management utility. To get started, simply run the following:

yarn

and build all the packages this way:

yarn build

Development is usually done one package at a time. So go into each package and develop with the innerloop npm script:

cd packages/just-task
yarn start

Tests are run with the test npm script:

cd packages/just-task
yarn test

Making Changes

When you make a meaningful change in this repo, make sure to create a "change file" by running:

yarn change

What this does is to ask you for a description of your change and a change type. You could specify a minor or patch change.

Minor changes are for backwards compatible new features while patches are for bug fixes with no API changes.

Packages

Package Description
create-just Invoked by npm init just, a tool that scaffolds project repos
just-task The task definition library that wraps undertaker and yargs libraries
just-scripts A reusable preset of frequently used tasks in node and browser projects
just-stack-* A set of templates to be used by the scaffold tool create-just
just-scripts-utils A set of utilities that are shared between just-scripts and create-just
just-task-logger A shared pretty logger used to display timestamps along with a message
documentation The Docusaurus site content and styles which generates the Github page for this library

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com. Please refer Contribution guide for more details

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.