feature: @putout/operator-filesystem: readDirectory: add

Author: coderaiser

packages/operator-filesystem/README.md

@@ -37,6 +37,22 @@ const [dirPath] = findFile(ast, 'hello');
 const newDirectoryPath = createDirectory(dirPath, 'world');
 ```
 
+### `readDirectory(directoryPath: DirectoryPath): (FilePath | DirectoryPath)[]`
+
+```js
+const {operator} = require('putout');
+const {
+    finedFiles,
+    findFile,
+    readDirectory,
+} = operator;
+
+const [dirPath] = findFile(ast, '/bin');
+readDirectory(dirPath);
+// returns list of files
+[];
+```
+
 ### `findFile(directoryPath: DirectoryPath, name: string | string[], exclude?: string[]): (FilePath | DirectoryPath)[]`
 
 ```js

packages/operator-filesystem/lib/filesystem.js

@@ -169,7 +169,7 @@ module.exports.moveFile = (filePath, dirPath) => {
 
     const dirname = getFilename(dirPath);
     const filename = getFilename(filePath);
-    const dirPathFiles = getProperty(dirPath, 'files');
+    const dirPathFiles = getFiles(dirPath);
     const filenamePath = getProperty(filePath, 'filename');
 
     const basename = filename
@@ -274,6 +274,15 @@ module.exports.createFile = (dirPath, name, content) => {
 
 const getFiles = (dirPath) => getProperty(dirPath, 'files');
 
+module.exports.readDirectory = (dirPath) => {
+    const fileType = getFileType(dirPath);
+    
+    if (fileType !== 'directory')
+        return [];
+    
+    return getFiles(dirPath).get('value.elements');
+};
+
 module.exports.createDirectory = (dirPath, name) => {
     const dirPathFiles = getFiles(dirPath);
     const parentFilename = getFilename(dirPath);

packages/operator-filesystem/lib/filesystem.spec.js

@@ -24,6 +24,7 @@ const {
     getFileContent,
     createFile,
     createDirectory,
+    readDirectory,
     getParentDirectory,
     readFileContent,
     writeFileContent,
@@ -1098,6 +1099,38 @@ test('putout: operator: filesystem: findFile: directory', (t) => {
     t.end();
 });
 
+test('putout: operator: filesystem: readDirectory: file', (t) => {
+    const ast = parseFilesystem(['/hello/', '/hello/world/', '/hello/world.txt']);
+    
+    const [helloDir] = findFile(ast, '/hello/world.txt');
+    const files = readDirectory(helloDir).map(getFilename);
+    
+    const expected = [];
+    
+    t.deepEqual(files, expected);
+    t.end();
+});
+
+test('putout: operator: filesystem: readDirectory', (t) => {
+    const ast = parseFilesystem([
+        '/hello/',
+        '/hello/world/',
+        '/hello/world/abc',
+        '/hello/world.txt',
+    ]);
+    
+    const [helloDir] = findFile(ast, '/hello');
+    const files = readDirectory(helloDir).map(getFilename);
+    
+    const expected = [
+        '/hello/world',
+        '/hello/world.txt',
+    ];
+    
+    t.deepEqual(files, expected);
+    t.end();
+});
+
 test('putout: operator: filesystem: moveFile: sameDirectory', (t) => {
     const ast = parseFilesystem(['/', '/hello/', '/hello/world.txt']);
     const [dirPath] = findFile(ast, '/');