# Relative Path Converter
A simple CFC to translate an absolute path into a relative path for a given context.
The easiest way to install is using CommandBox. Simply type `box install relative-path-converter` to get going.
Alternatively, you can download a zip of the module and add it to your project. Only the `RelativePathConverter.cfc` file is needed.
There is a WireBox mapping out of the box. Simply inject `RelativePathConverter` to use in your WireBox/ColdBox projects.
Create a new instance of the `RelativePathConverter`. You can pass in an optional context. (It defaults to the directory it is called in.) You can change the context at any time by calling `setContext` passing in the new context. The context you pass in will be ran through `ExpandPath`, so relative paths are okay here.
Convert an absolute path into a relative one by calling `convert` on the `RelativePathConverter` instance, passing in your absolute path. If the absolute path doesn't exist, an exception will be thrown. If a relative path is given, an exception will be thrown.