Package anchoring

Packages are stored in the /wraps folder in your project repository, in their compressed forms. Whenever in use, they get uncompressed in the /wraps/_cache folder that by default never gets checked-in source control.

Sometimes however, you want to commit the content of a package to source control, because you want access to the files in a known location, independent of the version of the package.

To do that, you can mark a dependency as anchored, by specifying the @-anchored@ input in the @add-wrap@ command, or you can specify a tag on the dependency line in your descriptor, by specifying @depends: packageName anchored@.

When encountering an anchored package, the folder containing the content in the package will be replicated in your wraps folder.

For example, let's say I add the openwrap-1.0.0.1.wrap package. With anchoring, the following folder structure will be created:

• wraps
  • _cache
    • openwrap-1.0.0.1
      • content of the package
  • openwrap
    • content of the package

The content by default uses a junction on windows. You can change that behaviour by using the use-symlinks:false line in your descriptor.