1
0
mirror of https://github.com/SAP/jenkins-library.git synced 2025-04-27 12:32:19 +02:00

65 lines
1.5 KiB
Markdown
Raw Normal View History

2017-07-11 15:12:03 +02:00
# FileUtils
## Description
Provides file system related utility functions.
## Constructor
Since there are only static utility methods there is no need for instantiating objects.
2017-07-11 15:12:03 +02:00
## Method Details
### validateDirectory(dir)
#### Description
Checks whether a file exists and is a directory.
#### Parameters
* `dir` - The directory to be checked. In case it is relative path it is checked against the
2017-07-11 15:12:03 +02:00
current working directory. In case of doubt use the absolute path (prefix the directory with `pwd`).
#### Return value
none
#### Side effects
none
#### Exceptions
* `IllegalArgumentException`:
* If the parameter `dir` is null or empty.
* `AbortException`:
* If the directory does not exist or is not a directory.
2017-07-11 15:12:03 +02:00
#### Example
```groovy
FileUtils.validateDirectory('/path/to/dir')
```
2017-07-11 15:12:03 +02:00
### validateDirectoryIsNotEmpty(dir)
#### Description
Check whether a directory is not empty. Before the directory is checked, `validateDirectory(dir)` is executed.
#### Parameters
* `dir` - The directory to be checked. In case it is relative path it is checked against the
2017-07-11 15:12:03 +02:00
current working directory. In case of doubt use the absolute path (prefix the directory with `pwd`).
#### Return value
none
#### Side effects
none
#### Exceptions
* `IllegalArgumentException`:
* If the parameter `dir` is null or empty.
* `AbortException`:
* If the directory does not exist or is not a directory or the directory is empty.
2017-07-11 15:12:03 +02:00
#### Example
```groovy
FileUtils.validateDirectoryIsNotEmpty('/path/to/dir')
```