From 14b447fa4ba0ecec1a61701f9651dbae2a1f1878 Mon Sep 17 00:00:00 2001 From: WSO2 Builder Date: Thu, 12 Dec 2019 05:07:06 +0000 Subject: [PATCH] [WSO2-Release] [Release 2.0.5] update documentation for release 2.0.5 --- README.md | 32 +- docs/api/2.0.5.md | 1047 ++++++++++++++++++++++++++++++++++++++++++++ docs/api/latest.md | 34 +- docs/index.md | 32 +- mkdocs.yml | 1 + 5 files changed, 1097 insertions(+), 49 deletions(-) create mode 100644 docs/api/2.0.5.md diff --git a/README.md b/README.md index ffbdbfb3..a11e7423 100644 --- a/README.md +++ b/README.md @@ -19,25 +19,25 @@ For information on Siddhi and i ## Latest API Docs -Latest API Docs is 2.0.4. +Latest API Docs is 2.0.5. ## Features -* isDirectory *(Function)*

This function checks for a given file path points to a directory

-* isExist *(Function)*

This function checks whether a file or a folder exists in a given path

-* isFile *(Function)*

This function checks for a given file path points to a file

-* lastModifiedTime *(Function)*

Checks for the last modified time for a given file path

-* size *(Function)*

This function checks for a given file's size

-* archive *(Stream Function)*

Archives files and folders as a zip or in tar format that are available in the given file uri.

-* copy *(Stream Function)*

This function performs copying file from one directory to another.

-* create *(Stream Function)*

Create a file or a folder in the given location

-* delete *(Stream Function)*

Deletes file/files in a particular path

-* move *(Stream Function)*

This function performs copying file from one directory to another.

-* search *(Stream Function)*

Searches files in a given folder and lists.

-* searchInArchive *(Stream Function)*

This.

-* unarchive *(Stream Function)*

This function decompresses a given file

-* file *(Sink)*

File Sink can be used to publish (write) event data which is processed within siddhi to files.
Siddhi-io-file sink provides support to write both textual and binary data into files

-* file *(Source)*

File Source provides the functionality for user to feed data to siddhi from files. Both text and binary files are supported by file source.

+* isDirectory *(Function)*

This function checks for a given file path points to a directory

+* isExist *(Function)*

This function checks whether a file or a folder exists in a given path

+* isFile *(Function)*

This function checks for a given file path points to a file

+* lastModifiedTime *(Function)*

Checks for the last modified time for a given file path

+* size *(Function)*

This function checks for a given file's size

+* archive *(Stream Function)*

Archives files and folders as a zip or in tar format that are available in the given file uri.

+* copy *(Stream Function)*

This function performs copying file from one directory to another.

+* create *(Stream Function)*

Create a file or a folder in the given location

+* delete *(Stream Function)*

Deletes file/files in a particular path

+* move *(Stream Function)*

This function performs copying file from one directory to another.

+* search *(Stream Function)*

Searches files in a given folder and lists.

+* searchInArchive *(Stream Function)*

This.

+* unarchive *(Stream Function)*

This function decompresses a given file

+* file *(Sink)*

File Sink can be used to publish (write) event data which is processed within siddhi to files.
Siddhi-io-file sink provides support to write both textual and binary data into files

+* file *(Source)*

File Source provides the functionality for user to feed data to siddhi from files. Both text and binary files are supported by file source.

## Dependencies diff --git a/docs/api/2.0.5.md b/docs/api/2.0.5.md new file mode 100644 index 00000000..1f64beba --- /dev/null +++ b/docs/api/2.0.5.md @@ -0,0 +1,1047 @@ +# API Docs - v2.0.5 + +!!! Info "Tested Siddhi Core version: *5.1.5*" + It could also support other Siddhi Core minor versions. + +## File + +### isDirectory *(Function)* +

+

This function checks for a given file path points to a directory

+

+Syntax + +``` + file:isDirectory( uri) +``` + +QUERY PARAMETERS + + + + + + + + + + + + + + + + + +
NameDescriptionDefault ValuePossible Data TypesOptionalDynamic
uri

The path to be checked for a directory.

STRINGNoYes
+ +Examples +EXAMPLE 1 +``` +file:isDirectory(filePath) as isDirectory +``` +

+

Checks whether the given path is a directory. Result will be returned as an boolean.

+

+### isExist *(Function)* +

+

This function checks whether a file or a folder exists in a given path

+

+Syntax + +``` + file:isExist( uri) +``` + +QUERY PARAMETERS + + + + + + + + + + + + + + + + + +
NameDescriptionDefault ValuePossible Data TypesOptionalDynamic
uri

File path to check for existence.

STRINGNoYes
+ +Examples +EXAMPLE 1 +``` +file:isExist('/User/wso2/source/test.txt') as exists +``` +

+

Checks existence of a file in the given path. Result will be returned as an boolean .

+

+EXAMPLE 2 +``` +file:isExist('/User/wso2/source/') as exists +``` +

+

Checks existence of a folder in the given path. Result will be returned as an boolean .

+

+### isFile *(Function)* +

+

This function checks for a given file path points to a file

+

+Syntax + +``` + file:isFile( file.path) +``` + +QUERY PARAMETERS + + + + + + + + + + + + + + + + + +
NameDescriptionDefault ValuePossible Data TypesOptionalDynamic
file.path

The path to be checked for a file.

STRINGNoYes
+ +Examples +EXAMPLE 1 +``` +file:isFile(filePath) as isFile +``` +

+

Checks whether the given path is a file. Result will be returned as an boolean.

+

+### lastModifiedTime *(Function)* +

+

Checks for the last modified time for a given file path

+

+Syntax + +``` + file:lastModifiedTime( uri) + file:lastModifiedTime( uri, datetime.format) +``` + +QUERY PARAMETERS + + + + + + + + + + + + + + + + + + + + + + + + + +
NameDescriptionDefault ValuePossible Data TypesOptionalDynamic
uri

File path to be checked for te last modified time.

STRINGNoYes
datetime.format

Format of the last modified datetime to be returned.

MM/dd/yyyy HH:mm:ssSTRINGYesNo
+ +Examples +EXAMPLE 1 +``` +file:lastModifiedTime(filePath) as lastModifiedTime +``` +

+

Last modified datetime of a file will be returned as an string in MM/dd/yyyy HH:mm:ss.

+

+EXAMPLE 2 +``` +file:lastModifiedTime(filePath, dd/MM/yyyy HH:mm:ss) as lastModifiedTime +``` +

+

Last modified datetime of a file will be returned as an string in 'dd/MM/yyyy HH:mm:ss' format.

+

+### size *(Function)* +

+

This function checks for a given file's size

+

+Syntax + +``` + file:size( uri) +``` + +QUERY PARAMETERS + + + + + + + + + + + + + + + + + +
NameDescriptionDefault ValuePossible Data TypesOptionalDynamic
uri

Absolute path to the file or directory to be checked for the size.

STRINGNoYes
+ +Examples +EXAMPLE 1 +``` +file:size('/User/wso2/source/test.txt') as fileSize +``` +

+

Size of a file in a given path will be returned.

+

+### archive *(Stream Function)* +

+

Archives files and folders as a zip or in tar format that are available in the given file uri.

+

+Syntax + +``` +file:archive( uri, destination.dir.uri) +file:archive( uri, destination.dir.uri, archive.type) +file:archive( uri, destination.dir.uri, archive.type, include.by.regexp) +file:archive( uri, destination.dir.uri, archive.type, include.by.regexp, exclude.subdirectories) +``` + +QUERY PARAMETERS + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameDescriptionDefault ValuePossible Data TypesOptionalDynamic
uri

Absolute path of the file or the directory

STRINGNoYes
destination.dir.uri

Absolute directory path of the the archived file.

STRINGNoYes
archive.type

Archive type can be zip or tar

zipSTRINGYesNo
include.by.regexp

Only the files matching the patterns will be archived.
Note: Add an empty string to match all files

STRINGYesNo
exclude.subdirectories

This flag is used to exclude the subdirectories and its files without archiving.

falseBOOLYesNo
+ +Examples +EXAMPLE 1 +``` +InputStream#file:archive('/User/wso2/to_be_archived', '/User/wso2/archive_destination/file.zip') +``` +

+

Archives to_be_archived folder in zip format and stores archive_destination folder as file.zip.

+

+EXAMPLE 2 +``` +InputStream#file:archive('/User/wso2/to_be_archived', '/User/wso2/archive_destination/file', 'tar') +``` +

+

Archives to_be_archived folder in tar format and stores in archive_destination folder as file.tar.

+

+EXAMPLE 3 +``` +InputStream#file:archive('/User/wso2/to_be_archived', '/User/wso2/archive_destination/file', 'tar', '.*test3.txt$') +``` +

+

Archives files which adheres to '.*test3.txt$' regex in to_be_archived folder in tar format and stores in archive_destination folder as file.tar.

+

+EXAMPLE 4 +``` +InputStream#file:archive('/User/wso2/to_be_archived', '/User/wso2/archive_destination/file', '', '', 'false') +``` +

+

Archives to_be_archived folder excluding the sub-folders in zip format and stores in archive_destination folder as file.tar.

+

+### copy *(Stream Function)* +

+

This function performs copying file from one directory to another.

+

+Syntax + +``` +file:copy( uri, destination.dir.uri) +file:copy( uri, destination.dir.uri, include.by.regexp) +file:copy( uri, destination.dir.uri, include.by.regexp, exclude.root.dir) +``` + +QUERY PARAMETERS + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameDescriptionDefault ValuePossible Data TypesOptionalDynamic
uri

Absolute path of the File or the directory.

STRINGNoYes
destination.dir.uri

Absolute path of the destination directory.
Note: Parent folder structure will be created if it does not exist.

STRINGNoYes
include.by.regexp

Only the files matching the patterns will be copied.
Note: Add an empty string to match all files

STRINGYesNo
exclude.root.dir

This flag is used to exclude parent folder when copying the content.

falseBOOLYesNo
+Extra Return Attributes + + + + + + + + + + + +
NameDescriptionPossible Types
isSuccess

Status of the file copying operation (true if success)

BOOL
+ +Examples +EXAMPLE 1 +``` +InputStream#file:copy('/User/wso2/source/test.txt', 'User/wso2/destination/') +``` +

+

Copies 'test.txt' in 'source' folder to the 'destination' folder.

+

+EXAMPLE 2 +``` +InputStream#file:copy('/User/wso2/source/', 'User/wso2/destination/') +``` +

+

Copies 'source' folder to the 'destination' folder with all its content

+

+EXAMPLE 3 +``` +InputStream#file:copy('/User/wso2/source/', 'User/wso2/destination/', '.*test3.txt$') +``` +

+

Copies 'source' folder to the 'destination' folder ignoring files doesnt adhere to the given regex.

+

+EXAMPLE 4 +``` +InputStream#file:copy('/User/wso2/source/', 'User/wso2/destination/', '', true) +``` +

+

Copies only the files resides in 'source' folder to 'destination' folder.

+

+### create *(Stream Function)* +

+

Create a file or a folder in the given location

+

+Syntax + +``` +file:create( uri, is.directory) +``` + +QUERY PARAMETERS + + + + + + + + + + + + + + + + + + + + + + + + + +
NameDescriptionDefault ValuePossible Data TypesOptionalDynamic
uri

Absolute file path which needs to be created.

STRINGNoYes
is.directory

This flag is used when creating file path is a directory

STRINGNoYes
+ +Examples +EXAMPLE 1 +``` +from CreateFileStream#file:create('/User/wso2/source/test.txt', false) +``` +

+

Creates a file in the given path with the name of 'test.txt'.

+

+EXAMPLE 2 +``` +from CreateFileStream#file:create('/User/wso2/source/', true) +``` +

+

Creates a folder in the given path with the name of 'source'.

+

+### delete *(Stream Function)* +

+

Deletes file/files in a particular path

+

+Syntax + +``` +file:delete( uri) +``` + +QUERY PARAMETERS + + + + + + + + + + + + + + + + + +
NameDescriptionDefault ValuePossible Data TypesOptionalDynamic
uri

Absolute path of the file or the directory to be deleted.

STRINGNoYes
+ +Examples +EXAMPLE 1 +``` +from DeleteFileStream#file:delete('/User/wso2/source/test.txt') +``` +

+

Deletes the file in the given path.

+

+EXAMPLE 2 +``` +from DeleteFileStream#file:delete('/User/wso2/source/') +``` +

+

Deletes the folder in the given path.

+

+### move *(Stream Function)* +

+

This function performs copying file from one directory to another.

+

+Syntax + +``` +file:move( uri, destination.dir.uri) +file:move( uri, destination.dir.uri, include.by.regexp) +file:move( uri, destination.dir.uri, include.by.regexp, exclude.root.dir) +``` + +QUERY PARAMETERS + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameDescriptionDefault ValuePossible Data TypesOptionalDynamic
uri

Absolute file or directory path.

STRINGNoYes
destination.dir.uri

Absolute file path to the destination directory.
Note: Parent folder structure will be created if it does not exist.

STRINGNoYes
include.by.regexp

Only the files matching the patterns will be moved.
Note: Add an empty string to match all files

STRINGYesNo
exclude.root.dir

Exclude parent folder when moving the content.

falseBOOLYesNo
+Extra Return Attributes + + + + + + + + + + + +
NameDescriptionPossible Types
isSuccess

Status of the file moving operation (true if success)

BOOL
+ +Examples +EXAMPLE 1 +``` +InputStream#file:move('/User/wso2/source/test.txt', 'User/wso2/destination/') +``` +

+

Moves 'test.txt' in 'source' folder to the 'destination' folder.

+

+EXAMPLE 2 +``` +InputStream#file:move('/User/wso2/source/', 'User/wso2/destination/') +``` +

+

Moves 'source' folder to the 'destination' folder with all its content

+

+EXAMPLE 3 +``` +InputStream#file:move('/User/wso2/source/', 'User/wso2/destination/', '.*test3.txt$') +``` +

+

Moves 'source' folder to the 'destination' folder excluding files doesnt adhere to the given regex.

+

+EXAMPLE 4 +``` +InputStream#file:move('/User/wso2/source/', 'User/wso2/destination/', '', true) +``` +

+

Moves only the files resides in 'source' folder to 'destination' folder.

+

+### search *(Stream Function)* +

+

Searches files in a given folder and lists.

+

+Syntax + +``` +file:search( uri) +file:search( uri, include.by.regexp) +file:search( uri, include.by.regexp, exclude.subdirectories) +``` + +QUERY PARAMETERS + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameDescriptionDefault ValuePossible Data TypesOptionalDynamic
uri

Absolute file path of the directory.

STRINGNoYes
include.by.regexp

Only the files matching the patterns will be searched.
Note: Add an empty string to match all files

STRINGYesYes
exclude.subdirectories

This flag is used to exclude the files un subdirectories when listing.

falseBOOLYesNo
+Extra Return Attributes + + + + + + + + + + + +
NameDescriptionPossible Types
fileNameList

The lit file name matches in the directory.

OBJECT
+ +Examples +EXAMPLE 1 +``` +ListFileStream#file:search(filePath) +``` +

+

This will list all the files (also in sub-folders) in a given path.

+

+EXAMPLE 2 +``` +ListFileStream#file:search(filePath, '.*test3.txt$') +``` +

+

This will list all the files (also in sub-folders) which adheres to a given regex file pattern in a given path.

+

+EXAMPLE 3 +``` +ListFileStream#file:search(filePath, '.*test3.txt$', true) +``` +

+

This will list all the files excluding the files in sub-folders which adheres to a given regex file pattern in a given path.

+

+### searchInArchive *(Stream Function)* +

+

This.

+

+Syntax + +``` +file:searchInArchive( uri) +file:searchInArchive( uri, include.by.regexp) +``` + +QUERY PARAMETERS + + + + + + + + + + + + + + + + + + + + + + + + + +
NameDescriptionDefault ValuePossible Data TypesOptionalDynamic
uri

Absolute file path of the zip or tar file.

STRINGNoYes
include.by.regexp

Only the files matching the patterns will be searched.
Note: Add an empty string to match all files

STRINGYesNo
+Extra Return Attributes + + + + + + + + + + + +
NameDescriptionPossible Types
fileNameList

The list file names in the archived file.

OBJECT
+ +Examples +EXAMPLE 1 +``` +ListArchivedFileStream#file:listFilesInArchive(filePath) +``` +

+

Lists the files inside the compressed file in the given path.

+

+EXAMPLE 2 +``` +ListArchivedFileStream#file:listFilesInArchive(filePath, '.*test3.txt$') +``` +

+

Filters file names adheres to the given regex and lists the files inside the compressed file in the given path.

+

+### unarchive *(Stream Function)* +

+

This function decompresses a given file

+

+Syntax + +``` +file:unarchive( uri, destination.dir.uri) +file:unarchive( uri, destination.dir.uri, exclude.root.dir) +``` + +QUERY PARAMETERS + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameDescriptionDefault ValuePossible Data TypesOptionalDynamic
uri

Absolute path of the file to be decompressed in the format of zip or tar.

STRINGNoYes
destination.dir.uri

Absolute path of the destination directory.
Note: If the folder structure does not exist, it will be created.

STRINGNoYes
exclude.root.dir

This flag excludes parent folder when extracting the content.

falseBOOLYesNo
+ +Examples +EXAMPLE 1 +``` +file:unarchive('/User/wso2/source/test.zip', '/User/wso2/destination') +``` +

+

Unarchive a zip file in a given path to a given destination.

+

+EXAMPLE 2 +``` +file:unarchive('/User/wso2/source/test.tar', '/User/wso2/destination') +``` +

+

Unarchive a tar file in a given path to a given destination.

+

+EXAMPLE 3 +``` +file:unarchive('/User/wso2/source/test.tar', '/User/wso2/destination', true) +``` +

+

Unarchive a tar file in a given path to a given destination excluding the root folder.

+

+## Sink + +### file *(Sink)* +

+

File Sink can be used to publish (write) event data which is processed within siddhi to files.
Siddhi-io-file sink provides support to write both textual and binary data into files

+

+Syntax + +``` +@sink(type="file", file.uri="", append="", add.line.separator="", @map(...))) +``` + +QUERY PARAMETERS + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameDescriptionDefault ValuePossible Data TypesOptionalDynamic
file.uri

Used to specify the file for data to be written.

STRINGNoYes
append

This parameter is used to specify whether the data should be append to the file or not.
If append = 'true', data will be write at the end of the file without changing the existing content.
If file does not exist, a new fill will be crated and then data will be written.
If append append = 'false',
If given file exists, existing content will be deleted and then data will be written back to the file.
If given file does not exist, a new file will be created and then data will be written on it.

trueBOOLYesNo
add.line.separator

This parameter is used to specify whether events added to the file should be separated by a newline.
If add.event.separator= 'true',then a newline will be added after data is added to the file.

true. (However, if csv mapper is used, it is false)BOOLYesNo
+ +Examples +EXAMPLE 1 +``` +@sink(type='file', @map(type='json'), append='false', file.uri='/abc/{{symbol}}.txt') define stream BarStream (symbol string, price float, volume long); +``` +

+

Under above configuration, for each event, a file will be generated if there's no such a file,and then data will be written to that file as json messagesoutput will looks like below.
{
    "event":{
        "symbol":"WSO2",
        "price":55.6,
        "volume":100
    }
}

+

+## Source + +### file *(Source)* +

+

File Source provides the functionality for user to feed data to siddhi from files. Both text and binary files are supported by file source.

+

+Syntax + +``` +@source(type="file", dir.uri="", file.uri="", mode="", tailing="", action.after.process="", action.after.failure="", move.after.process="", move.after.failure="", begin.regex="", end.regex="", file.polling.interval="", dir.polling.interval="", timeout="", file.read.wait.timeout="", @map(...))) +``` + +QUERY PARAMETERS + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameDescriptionDefault ValuePossible Data TypesOptionalDynamic
dir.uri

Used to specify a directory to be processed.
All the files inside this directory will be processed.
Only one of 'dir.uri' and 'file.uri' should be provided.
This uri MUST have the respective protocol specified.

STRINGNoNo
file.uri

Used to specify a file to be processed.
 Only one of 'dir.uri' and 'file.uri' should be provided.
This uri MUST have the respective protocol specified.

STRINGNoNo
mode

This parameter is used to specify how files in given directory should.Possible values for this parameter are,
1. TEXT.FULL : to read a text file completely at once.
2. BINARY.FULL : to read a binary file completely at once.
3. LINE : to read a text file line by line.
4. REGEX : to read a text file and extract data using a regex.

lineSTRINGYesNo
tailing

This can either have value true or false. By default it will be true.
This attribute allows user to specify whether the file should be tailed or not.
If tailing is enabled, the first file of the directory will be tailed.
Also tailing should not be enabled in 'binary.full' or 'text.full' modes.

trueBOOLYesNo
action.after.process

This parameter is used to specify the action which should be carried out
after processing a file in the given directory.
It can be either DELETE or MOVE and default value will be 'DELETE'.
If the action.after.process is MOVE, user must specify the location to move consumed files using 'move.after.process' parameter.

deleteSTRINGYesNo
action.after.failure

This parameter is used to specify the action which should be carried out if a failure occurred during the process.
It can be either DELETE or MOVE and default value will be 'DELETE'.
If the action.after.failure is MOVE, user must specify the location to move consumed files using 'move.after.failure' parameter.

deleteSTRINGYesNo
move.after.process

If action.after.process is MOVE, user must specify the location to move consumed files using 'move.after.process' parameter.
This should be the absolute path of the file that going to be created after moving is done.
This uri MUST have the respective protocol specified.

STRINGNoNo
move.after.failure

If action.after.failure is MOVE, user must specify the location to move consumed files using 'move.after.failure' parameter.
This should be the absolute path of the file that going to be created after moving is done.
This uri MUST have the respective protocol specified.

STRINGNoNo
begin.regex

This will define the regex to be matched at the beginning of the retrieved content.

NoneSTRINGYesNo
end.regex

This will define the regex to be matched at the end of the retrieved content.

NoneSTRINGYesNo
file.polling.interval

This parameter is used to specify the time period (in milliseconds) of a polling cycle for a file.

1000STRINGYesNo
dir.polling.interval

This parameter is used to specify the time period (in milliseconds) of a polling cycle for a directory.

1000STRINGYesNo
timeout

This parameter is used to specify the maximum time period (in milliseconds) for waiting until a file is processed.

5000STRINGYesNo
file.read.wait.timeout

This parameter is used to specify the maximum time period (in milliseconds) till it waits before retrying to read the full file content.

1000STRINGYesNo
+ +Examples +EXAMPLE 1 +``` +@source(type='file', +mode='text.full', +tailing='false' + dir.uri='file://abc/xyz', +action.after.process='delete', +@map(type='json')) +define stream FooStream (symbol string, price float, volume long); + +``` +

+

Under above configuration, all the files in directory will be picked and read one by one.
In this case, it's assumed that all the files contains json valid json strings with keys 'symbol','price' and 'volume'.
Once a file is read, its content will be converted to an event using siddhi-map-json extension and then, that event will be received to the FooStream.
Finally, after reading is finished, the file will be deleted.

+

+EXAMPLE 2 +``` +@source(type='file', +mode='files.repo.line', +tailing='true', +dir.uri='file://abc/xyz', +@map(type='json')) +define stream FooStream (symbol string, price float, volume long); + +``` +

+

Under above configuration, the first file in directory '/abc/xyz' will be picked and read line by line.
In this case, it is assumed that the file contains lines json strings.
For each line, line content will be converted to an event using siddhi-map-json extension and then, that event will be received to the FooStream.
Once file content is completely read, it will keep checking whether a new entry is added to the file or not.
If such entry is added, it will be immediately picked up and processed.

+

diff --git a/docs/api/latest.md b/docs/api/latest.md index 269cf37e..1f64beba 100644 --- a/docs/api/latest.md +++ b/docs/api/latest.md @@ -1,4 +1,4 @@ -# API Docs - v2.0.4 +# API Docs - v2.0.5 !!! Info "Tested Siddhi Core version: *5.1.5*" It could also support other Siddhi Core minor versions. @@ -31,7 +31,7 @@ STRING No - No + Yes @@ -69,7 +69,7 @@ file:isDirectory(filePath) as isDirectory STRING No - No + Yes @@ -114,7 +114,7 @@ file:isExist('/User/wso2/source/') as exists STRING No - No + Yes @@ -153,7 +153,7 @@ file:isFile(filePath) as isFile STRING No - No + Yes datetime.format @@ -206,7 +206,7 @@ file:lastModifiedTime(filePath, dd/MM/yyyy HH:mm:ss) as lastModifiedTime STRING No - No + Yes @@ -247,7 +247,7 @@ file:archive( uri, destination.dir.uri, archive.type, STRING No - No + Yes destination.dir.uri @@ -255,7 +255,7 @@ file:archive( uri, destination.dir.uri, archive.type, STRING No - No + Yes archive.type @@ -340,7 +340,7 @@ file:copy( uri, destination.dir.uri, include.by.regexp STRING No - No + Yes destination.dir.uri @@ -348,7 +348,7 @@ file:copy( uri, destination.dir.uri, include.by.regexp STRING No - No + Yes include.by.regexp @@ -436,7 +436,7 @@ file:create( uri, is.directory) STRING No - No + Yes is.directory @@ -444,7 +444,7 @@ file:create( uri, is.directory) STRING No - No + Yes @@ -489,7 +489,7 @@ file:delete( uri) STRING No - No + Yes @@ -536,7 +536,7 @@ file:move( uri, destination.dir.uri, include.by.regexp STRING No - No + Yes destination.dir.uri @@ -544,7 +544,7 @@ file:move( uri, destination.dir.uri, include.by.regexp STRING No - No + Yes include.by.regexp @@ -783,7 +783,7 @@ file:unarchive( uri, destination.dir.uri, exclude.root.d STRING No - No + Yes destination.dir.uri @@ -791,7 +791,7 @@ file:unarchive( uri, destination.dir.uri, exclude.root.d STRING No - No + Yes exclude.root.dir diff --git a/docs/index.md b/docs/index.md index ffbdbfb3..a11e7423 100644 --- a/docs/index.md +++ b/docs/index.md @@ -19,25 +19,25 @@ For information on Siddhi and i ## Latest API Docs -Latest API Docs is 2.0.4. +Latest API Docs is 2.0.5. ## Features -* isDirectory *(Function)*

This function checks for a given file path points to a directory

-* isExist *(Function)*

This function checks whether a file or a folder exists in a given path

-* isFile *(Function)*

This function checks for a given file path points to a file

-* lastModifiedTime *(Function)*

Checks for the last modified time for a given file path

-* size *(Function)*

This function checks for a given file's size

-* archive *(Stream Function)*

Archives files and folders as a zip or in tar format that are available in the given file uri.

-* copy *(Stream Function)*

This function performs copying file from one directory to another.

-* create *(Stream Function)*

Create a file or a folder in the given location

-* delete *(Stream Function)*

Deletes file/files in a particular path

-* move *(Stream Function)*

This function performs copying file from one directory to another.

-* search *(Stream Function)*

Searches files in a given folder and lists.

-* searchInArchive *(Stream Function)*

This.

-* unarchive *(Stream Function)*

This function decompresses a given file

-* file *(Sink)*

File Sink can be used to publish (write) event data which is processed within siddhi to files.
Siddhi-io-file sink provides support to write both textual and binary data into files

-* file *(Source)*

File Source provides the functionality for user to feed data to siddhi from files. Both text and binary files are supported by file source.

+* isDirectory *(Function)*

This function checks for a given file path points to a directory

+* isExist *(Function)*

This function checks whether a file or a folder exists in a given path

+* isFile *(Function)*

This function checks for a given file path points to a file

+* lastModifiedTime *(Function)*

Checks for the last modified time for a given file path

+* size *(Function)*

This function checks for a given file's size

+* archive *(Stream Function)*

Archives files and folders as a zip or in tar format that are available in the given file uri.

+* copy *(Stream Function)*

This function performs copying file from one directory to another.

+* create *(Stream Function)*

Create a file or a folder in the given location

+* delete *(Stream Function)*

Deletes file/files in a particular path

+* move *(Stream Function)*

This function performs copying file from one directory to another.

+* search *(Stream Function)*

Searches files in a given folder and lists.

+* searchInArchive *(Stream Function)*

This.

+* unarchive *(Stream Function)*

This function decompresses a given file

+* file *(Sink)*

File Sink can be used to publish (write) event data which is processed within siddhi to files.
Siddhi-io-file sink provides support to write both textual and binary data into files

+* file *(Source)*

File Source provides the functionality for user to feed data to siddhi from files. Both text and binary files are supported by file source.

## Dependencies diff --git a/mkdocs.yml b/mkdocs.yml index 96fdb62a..4776dd11 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -38,6 +38,7 @@ pages: - Welcome: index.md - API Docs: - latest: api/latest.md + - 2.0.5: api/2.0.5.md - 2.0.4: api/2.0.4.md - 2.0.3: api/2.0.3.md - 2.0.2: api/2.0.2.md