meta is a tool for managing multi-project systems and libraries. It answers the conundrum of choosing between a mono repo or many repos by saying "both", with a meta repo!
meta is powered by plugins that wrap common commands, letting you execute them against some or all of the repos in your solution at once. meta is built on loop, and as such inherits loops ability to easily target a particular set of directories for executing a common command.
npm i -g meta will install a
meta command on your system.
To create a new meta project:
cd my-meta-repo && git init
meta will have created a .meta file to hold references to any child repositories you add.
meta project add [folder] [repo url]
for each project added, meta will update your .gitignore file and the .meta file with references to the new child repo
To clone an existing meta repo, you need only execute
meta git clone [meta repo url]. meta will clone your meta repo and all child repositories at once.
Because meta plugins wrap common commands, you shouldn't have much new syntax to memorize for some crazy new utilities nobody knows about. For instance, if you want to check the
git status of all your repositories at once, you can just type
meta git status:
View what branches exist on all your repos with
meta git branch:
Creating a new feature that cross-cuts a number of services, a site, and an API? Create new branches on all your repos at once with
meta git checkout -b [branch-name]. Or, revert all modified files to their remote status with
meta git checkout .:
Track your progress on all branches at once with
meta git status:
Remove unwanted untracked files on all repos with
meta git clean -fd:
All meta functionality is contributed by plugins - node modules that begin with
meta- and are either installed globally or in your meta repo's node_modules directory. We recommend you install them as devDependencies in your meta repo's package.json. Plugins add additional sub commands to meta, and can leverage loop or meta-loop to easily execute a common command against your meta repo and all child repos.
Here's how easy it is to install
meta-npm as a plugin, and gain the ability to
meta npm install all your repos at once:
And if you prefer the speediness of yarn, try
npm install --save-dave meta-yarn:
The best way to get started is to do the following:
npm i -g metameta git clone email@example.com:mateodelnorte/meta.gitcd ./metanpm installmeta npm installmeta npm link --allnpm link
This will clone the meta project,
meta, enter the directory, and then use
meta to perform
npm link --all in each directory listed in
projects of the
.meta JSON configuration file, and link meta itself to be used as a global command.
You can then write your command and test using
./bin/meta git gh [subcommand].
You can run the above as a single command:
meta git clone firstname.lastname@example.org:mateodelnorte/meta.git && cd ./meta && npm i && meta npm install && meta npm link --all && npm link
Yarn lovers can do the same:
npm i -g metameta git clone email@example.com:mateodelnorte/meta.gitcd ./metayarnmeta yarn installmeta yarn link --allyarn link
meta git clone firstname.lastname@example.org:mateodelnorte/meta.git && cd ./meta && yarn && meta yarn install && meta yarn link --all && yarn link
See discussion here for more details