mono2repo 0.1.2

create a standalone repo from a monorepo subdir.

This package (and related script) extracts the content of a subdirectory in a monorepo and it creates a stand alone repo (copying the related history).

Let say you have a monorepo with multiple projects (project1, project2 etc.) and we wan to make project1 a stand alone repo (retaining the project1 history):

monorepo/
├── README.TXT
├── misc
│   └── more
└── subfolder
    ├── project1           # <-- we want to extract this
    │   └── a
    │       ├── hello.txt
    │       └── subtree
    ├── project2
    └── project3

Using mono2repo to extract project1:

mono2repo init -v project1 monorepo/subfolder/project1

Will generate:

monorepo/
├── README.TXT
├── misc
...
project1/
└── a
    ├── hello.txt
    └── subtree

Installation

You can install mono2repo via pip from PyPI:

$ pip install mono2repo

Example

For this example we first create the summary repo from the main pelican monorepo, then we update the summary with the new upstream changes:

https://github.com/getpelican/pelican-plugins.git
....
└ summary/
 ├── Readme.rst
 └── summary.py

Create a new repo

First we create a new repo:

mono2repo init summary-extracted \
    https://github.com/getpelican/pelican-plugins.git/summary

Note

summary-extracted has two branches master and the migrate (leave this alone!). It is not time to merge the changes into master:

> cd summary-extracted
> git checkout master
> git merge migrate

Update the repo

Update the summary-extracted with the latest summary related changes:

mono2repo update summary-extracted