##Installation #####Install from CLI (Recommended)

$ cf add-plugin-repo CF-Community http://plugins.cloudfoundry.org/
$ cf install-plugin cf-download -r CF-Community

1. download binary (See Download Section below)
2. cd path/to/downloaded/binary
3. If you've already installed the plugin and are updating, you must first run cf uninstall-plugin cf-download
4. Then install the plugin with cf install-plugin cf-download
   • If you get a permission error run: chmod +x cf-download on the binary
5. Verify the plugin installed by looking for it with cf plugins

cf download APP_NAME [PATH] [--overwrite] [--verbose] [--omit omitted_path] [-i instance]

The downloaded app files will put put in a new directory "APP_NAME-download" that's created within your working directory.

The path argument is optional but if included, should come immediately after the app name. It determines the starting directory that all the files will be downloaded from. By default, the entire app is downloaded starting from the root. However if desired, one could use some/starting/path to only download files within the some/starting/path directory. Additionally, the path can point to a single file to be downloaded. Note: this works similarly to "cf files [path]".

1. The --overwrite flag is needed if the download directory, "APP_NAME-download", is already taken. Using the flag, that directory will be overwritten.
2. The --verbose flag is used to see more detailed output as the downloads are happening.
3. The --omit [omitted_path] flag is useful when certain files or directories are not wanted. You can exclude a file by typing --omit path/to/file. Multiple things can be omitted by delimiting the paths with semicolons and putting quotes around the entire parameter like so: --omit "path/to/file; another/path/to/file"
4. The -i [instance] flag will download from the given app instance. By default, the instance number is 0.

Projects usually have a enormous amount of dependencies installed by package managers, we highly recommend not downloading these dependencies. Using the --omit flag, you can avoid downloading these dependencies and significantly reduce download times.

We highly reccomend you not download the app/.java and app/.liberty directories in your java/liberty projects. They are very large and contain many permission issues the prevent proper downloads. It is best to omit them.

npm will download dependencies to the node_modules folder in the app directory. By omitting app/node_modules you will greatly decrease download times. You can run npm install locally on your package.json after completing a download.

Composer is a popular PHP package manager that installs dependencies to a folder called vendors. It is reccomended you omit this folder from the download to ensure a quick and error free download. example: --omit <path_to_vendors>/vendors

All directories and files within the .cfignore file will be omitted. Each entry should be on its own line and that the .cfignore file must be in the same working directory. Instead of using many --omit parameters, it's easier to use the .cfignore file.

In case your download seems to be stuck, we recommend terminating and redownloading using the --verbose flag. When the download stalls you can see which files were being downloaded and what could be causing the issue.

Projects containing jar files can trigger antivirus software while being downloaded. you can either temporarily disable network antivirus protection or exclude directories containing jar files.

On rare occasions the cf cli api that the plugin uses can get overburdened by the plugin. This will display a lot of 502 error messages to the command line. The best thing to do in this case is wait a couple minutes and try again later. The Api will hopefully return to full capacity and allow downloads to complete. In the unlikely case that you experience this often, create an issue on this repo and we can explore solutions.

This error is caused when the cf cli api fails. Best solution is to wait and try again, when the api recovers.