feat: create utility init a new File #90

Author: fugerit79

CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- FileIO.newFile() create utility init a new File <https://github.com/fugerit-org/fj-lib/issues/90>
+
+
 ## [8.6.7] - 2025-05-09
 
 ### Added

fj-core/src/main/java/org/fugerit/java/core/io/FileIO.java

@@ -28,6 +28,18 @@
 @Slf4j
 public class FileIO {
 
+    public static File newFile( String baseDir, String fileName ) {
+        return baseDir == null ?  new File( fileName ) :new File( baseDir, fileName );
+    }
+
+    public static File newFile( String baseDir, String fileName, boolean mustAlreadyExists ) throws IOException {
+        File file =  newFile( baseDir, fileName );
+        if ( mustAlreadyExists && !file.exists() ) {
+            throw new IOException( String.format( "File [%s] does not exist", file.getCanonicalPath() ) );
+        }
+        return file;
+    }
+
     public static boolean isInTmpFolder( File tempFile ) throws IOException {
         return isInTmpFolder( tempFile.getCanonicalPath() );
     }

fj-core/src/test/java/test/org/fugerit/java/core/io/TestFileIO.java

@@ -20,4 +20,16 @@ public void testIsInTmpFolderKo() throws IOException  {
         Assert.assertFalse(FileIO.isInTmpFolder( new File( "/" ) ));
     }
 
+    @Test
+    public void testNewFile() throws IOException {
+        String baseDir = "target/";
+        String fileName = "not-exists.txt";
+        String fileNameExists = "classes";
+        File file = FileIO.newFile( baseDir, fileName );
+        Assert.assertTrue( file.getPath().endsWith( fileName ) );
+        Assert.assertThrows( IOException.class, () -> FileIO.newFile( baseDir, fileName, Boolean.TRUE ) );
+        Assert.assertTrue( FileIO.newFile( baseDir, fileName, Boolean.FALSE ).getPath().endsWith( fileName ) );
+        Assert.assertTrue( FileIO.newFile( baseDir, fileNameExists, Boolean.TRUE ).getPath().endsWith( fileNameExists ) );
+    }
+
 }