-
Notifications
You must be signed in to change notification settings - Fork 12
A simple dependency management system for your projects.
License
nathanmarz/nanny
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
Nanny is a dependency management tool for managing dependencies between your projects. Unlike tools like Maven, Nanny can be used for arbitrary dependencies and is easy to use. Nanny lets you specify dependencies to your project, and Nanny will go ahead and pull in all the dependencies (and everything those dependencies are dependent on) into the _deps folder in your project. Nanny makes it easy to create dependencies and manage dependency versions. Nanny has a minimum of configuration. We use Nanny at BackType to manage all of our jars (external and internal), distribute custom software builds (like hadoop confs, cassandra), and manage dependencies between our python projects (instead of something like svn externals or git submodules). ------------------------------ SETTING UP YOUR FIRST DEPENDENCY After you follow the installation instructions below, you'll have an empty folder on your repository host ready to be used. Let's create the "hello world" of nanny dependency management: 1. Create a folder on your local drive somewhere. Say, "/tmp/helloworld" 2. cd /tmp/helloworld 3. echo "hello" > hello.txt 4. echo "world" > world.txt 5. echo "helloworld" > CHILD 6. echo "cp *.txt \$1" > CHILDMAKER 7. chmod a x CHILDMAKER 8. nanny push 1.0.0 "first revision" 9. Create a new folder on your local drive. Say, "/tmp/dependentproject" 10. cd "/tmp/dependentproject" 11. echo "helloworld" > NANNY 12. nanny deps 13. cat _deps/helloworld/* That should be enough for you to get started. Type "nanny help" to see all the commands. More detailed instructions below. ------------------------------ INSTALLATION: 1. Install Python if you don't already have it 2. From within the source code directory do the following: python setup.py install 3. Create a .nanny config file in your home directory that looks something like this: [nanny] REPOSITORY_HOST = {HOST WITH THE REPOSITORY} REPOSITORY_USER = {USERNAME TO LOG IN AS} REPOSITORY_PATH = {PATH TO THE REPOSITORY ON THE HOST} You need to make sure you can ssh to that machine as that user without typing any passwords (check out public/private keys to accomplish this) 4. Make the REPOSITORY_PATH on REPOSITORY_HOST and make sure REPOSITORY_USER has permissions to read/write from it ------------------------------ GUIDE ------------------------------ Specifying dependencies: To create dependencies to Nanny packages from your project, create a NANNY file in the root directory of your project. Each line of the NANNY file specifies a dependency, like so: thriftjava 1.0.0 The first field specifies what package you want to pull in as a dependency, and the second field indicates the specific version you want to pull in. If you omit the second field, like so: thriftjava Nanny will pull in the latest version. Run "nanny deps" to pull in all dependencies into _deps. Nanny will also pull in any dependencies of the dependencies you specify, and the dependencies of those dependencies, and so on. ------------------------------ Creating Nanny packages: To turn a project into a Nanny package, you need to do two things: name the package and provide a script to package the project up. For example, let's say you have a project "utils" that you want to package up. To do so, you would create a file called CHILD in the root of your project and create one line with "utils" in it. echo "utils" > CHILD Then, you would create an executable script called CHILDMAKER to package your project up. Your script will receive one argument which indicates the directory you should place any files. For example, here's a CHILDMAKER which packages up the jars of a Java project built by ant: #!/bin/sh ant jar cp build/*.jar $1 Once that's setup, type in "nanny push {VERSION}" to push the package to the repository. The version you specify must be of the format {major.minor.revision} and must be greater than what already exists in the repository. To see what's currently in the repository, type in "nanny remote-version" ------------------------------ Getting information about Nanny packages: Pushing a revision requires you to tag the version with a message. Additionally, if your project is under version control with svn or git, Nanny will automatically tag each pushed package version with the first 100 lines of "svn log" or "git log". Use the "info" command to see the message and version control logs associated with a version of a package, and use "history" to see the messages for all the versions of a package. See "nanny help" for detailed information about how to use those "info" and "history". ------------------------------ Non-fatal Issues with Nanny that should be resolved one day: 1. Nanny's operations are not atomic and the repository is not locked during operations. So if issues come up you'll have to deal with it manually. I haven't run into any problems, but the repository structure is really simple so fixing any problems should be straightforward. 2. Nanny doesn't integrate with other dependency management systems (except for leiningen - nanny will call lein deps if you have a project.clj file in the directory). I manually install our external dependencies (i.e., maven ones) into nanny packages to unify how we manage things internally. It's a little bit of work that could be eliminated if Nanny was able to communicate with other systems, but not too much of a time investment. 3. Fault tolerance pretty limited: Nanny doesn't detect when your CHILDMAKER script fails. Patches welcome! ------------------------------ FAQ: Why is the project called Nanny? You hire a nanny to look after your dependents.
About
A simple dependency management system for your projects.
Resources
License
Stars
Watchers
Forks
Releases
No releases published
Packages 0
No packages published