habitat

Habitat is a lightweight command line tool to manage source and binary dependencies in monorepo, plus dependency integration in CI environment.

It is also easy to use for developers. No need to execute many commands manually, just run ./hab sync . to set up local development environment.

Usage

1. Generate habitat configuration file in the repo.

   ./hab config <repo remote uri>

   A .habitat file will be generated. it should look like this.

   solutions = [
       {
           'name': '.',
           'deps_file': 'DEPS',  # dependency list
           'url': '[email protected]:namespace/repo.git'  # main repo's remote url
       }
   ]

2. Add a dependency in DEPS file.

   deps = {
       'lib/example': {
           'type': 'git',
           'url': '[email protected]:namespace/lib.git',
           'branch': 'dev'
       }
   }

3. Track habitat wrapper script and configuration files.

   git add hab .habitat DEPS && git commit -m "Add habitat to manage dependencies."

4. Integrate the dev branch of dependency to path lib/example.

   ./hab sync .

Development

Recommend to develop with Python higher than 3.9.

python3 -m venv _venv
source _venv/bin/activate
make install_dev

Running tests after making any changes is strongly recommended.

make check

Contributing

See the contributing file!

License

Apache License 2.0