The smallest unit that is managed by Karma is a Module. A module is a directory structure, containing source code, unit tests, documentation, configuration and the like. Nothing new here. Modules are stored in a version control repository (like CVS, Subversion, Clearcase and Perforce) and identified by a 'location', defining which type of version control system, host, port etc should be used to connect to the vcs and get the module.
Karma uses the concept of a Manifest to group software modules. A group of software modules can be called a component, but we have chosen to refrain from the academic discussion about the definition of a software component. Karma doesn't care! A manifest is an XML definition for modules and other manifests (the so-called manifest-includes). Manifests are covered in much more detail in the Reference Documentation, but here's what it looks like:
<manifest name="oracle-10g-dev" type="development" version="1-0"> <modules> <module name="enterprise-manager" version="9-0" location="us-boston-01"/> <module name="sql-plus-client" version="1-6" location="us-boston-01"/> </modules> <include-manifest name="database-server-8i-stable"/> </manifest>
What is shown here is how Oracle would (aim high ...) manage their database server product with Karma.
A manifest is the container for a component. A manifest contains modules, and it is good practice to logically group modules that form a component in a manifest. This way, manifests can easily be used as building blocks for software applications.
Obviously, Karma has not implemented its own version control system. Karma uses version control systems like CVS, Subversion, etc. Note that Karma R1.0 only supports CVS.
On top of what version control systems offer, Karma has implemented layer that is missing in most software development environments. A lot of software development organizations commit code after having run their unit tests and when a release is made, there is a 'code freeze', a period in which developers cannot commit code, because the release manager has to be sure that his checks were worth the effort and no code is added to the repository while he is tagging the release.
Karma has implemented a promotion strategy for modules where a developer can promote a module when it is stable enough. This additional layer is very useful, because Karma uses a concept of 'module state' (see the next section) to distinguish between stable modules and non-stable modules. Instead of other users depending on your committed work, they have the option to depend on stable modules.
Modules in a manifest are managed on a users harddisk. Normal working procedures in a software development company is that developers update the working set of code to integrate with others people's work. Karma fully supports that concept, because it is great, but more than that, Karma supports modules in different states.
A module should be designated
STATIC when the developer
wishes to use a fixed version of a module. This can best be compared with
Maven project dependencies, which are all of a static nature. Whatever
happens in terms of development for that module, you won't be able to use
it, unless you upgrade the module version in your manifest.
DYNAMIC module is monitored by Karma continuously to check
for newer versions. It will show the latest promoted version of the module
and the user can easily upgrade to that version. This mechanism is
powerfull in that a user can choose to have stable versions of
modules all the time, instead of having to pray for stable source code.
A module is
WORKING when the user has checked out the module
locally and called a
start-work command for
WORKING state means that the user has indicated that
he/she wants to actually develop on the module. In version control
terminology, the HEAD of a branch is checked out.
The concept of
WORKING modules applies only within the context of a
manifest. It is not stored in the version control system as such.
Modules as collections of files mean nothing much. By building them, we
can create artifacts that can be used : applications, components,
libraries. A good example is a Java web application that can be deployed
war-file to a web application server and run to do
Karma is capable of building modules. Karma R1.0 only supports the Java
programming language. Ant is used to implement the build system. Modules
can be packaged as
Improving efficiency of the software release process is an area where
Karma can be very helpfull. Next to the promotion strategy for modules,
manifests can be 'released' by automatically creating 'release
manifests'. This type of manifest only contains
modules, increasing the chances of stable software. A release manager has
full control over the module versions that should be released.
The working set of modules, manifests, etc for a developer is logically grouped in a 'working context'. A working context is used by Karma to check out modules and manage manifests within a logical context. Suppose you work for two different clients. For each client, you can easily configure a working context and separate every client-specific setting from the other.