Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Assemble Git repos into a deployable tree of code.

Project Description

Provides a way to assemble various Git repositories into one. It’s like submodules that don’t suck.

Use case: stitch together Wordpress with some themes and plugins before deploying.

Usage

First, you need to create your Castor repository. The following command will create an new Git repository containing an empty Castorfile and a pre-initialized .gitignore.

castor init my-proj

Then, you need to edit your Castorfile. It might look like

Note

post_freeze array is optional. It must be an array, each command will be executed on the target directory after executing castor freeze.

{
    "lodge": [
        {
            "target": "/",
            "version": "1.6.1.0",
            "repo": "https://github.com/PrestaShop/PrestaShop.git",
            "type": "git"
        },
        {
            "target": "/themes/my-prestashop-theme",
            "version": "e0e7c15789e6ff674cd75cb24981155441c3df09",
            "repo": "git@bitbucket.org:activkonnect/my-prestashop-theme.git",
            "type": "git",
            "post_freeze": [
                "composer update --no-dev"
            ]
        },
        {
            "target": "/.htaccess",
            "type": "file",
            "source": "files/htaccess"
        }
    ]
}

Your Castorfile being filled up, you can now apply it

castor apply

This will automatically create your repositories hierarchy, checkout submodules, etc. The root of this hierarchy will be the lodge directory.

If you want to execute post freeze commands on apply add the --exec-post-freeze argument like so :

castor apply --exec-post-freeze

Now you can freeze your project into a git-free, commitable and deployable tree of source code. This will go into the dam directory.

If you want to execute post freeze commands on apply add the --exec-post-freeze argument like so :

castor apply --exec-post-freeze
castor freeze

You can use the lodge as your working directory during development. If you make updates to the code, you can commit in the git repos. If you simply want to update upstream code, check out the new tag/commit you want to use. Then you can use castor freeze again, and it will update the Castorfile automatically with the latest Git HEADs, as well as the dam directory.

Release History

Release History

This version
History Node

0.2.3

History Node

0.2.2

History Node

0.2.1

History Node

0.2.0

History Node

0.1.5

History Node

0.1.4

History Node

0.1.3

History Node

0.1.2

History Node

0.1.1

History Node

0.1.0

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
castor-0.2.3.tar.gz (7.4 kB) Copy SHA256 Checksum SHA256 Source Mar 4, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting