System Utilities Documentation

Introduction

Retrieving system-related properties and file paths is essential for managing applications effectively. Whether you need to access the user's home directory, temporary files, or system properties, the file-worker library provides robust tools for working with system-level information.

Imagine building an application that dynamically configures itself based on the user's environment. This library makes accessing such system details seamless.

Features Overview

• Retrieve user-specific directories such as home, temp, and downloads.
• Fetch system properties like OS name, Java version, and file separators.
• Work with platform-independent system paths.

Getting Started

For installation and dependencies, refer to the Getting Started guide.

---

Retrieving System File Paths with SystemFileExtensions

The SystemFileExtensions class provides methods for retrieving system-related file paths.

Example: Getting the User's Home Directory

File homeDir = SystemFileExtensions.getUserHomeDir();
System.out.println("User Home Directory: " + homeDir.getAbsolutePath());

Example: Getting the System Temp Directory

File tempDir = SystemFileExtensions.getTempDir();
System.out.println("Temporary Directory: " + tempDir.getAbsolutePath());

Unit Test Coverage

The SystemFileExtensionsTest class ensures correctness:

@Test
public void testGetUserHomeDir() {
    File homeDir = SystemFileExtensions.getUserHomeDir();
    assertNotNull(homeDir);
}

---

Retrieving System Properties with SystemPropertiesExtensions

The SystemPropertiesExtensions class provides methods for retrieving system properties.

Example: Getting OS and Java Information

String osName = SystemPropertiesExtensions.getOsName();
String javaVersion = SystemPropertiesExtensions.getJavaVersion();

System.out.println("Operating System: " + osName);
System.out.println("Java Version: " + javaVersion);

Example: Fetching the System File Separator

String separator = SystemPropertiesExtensions.getFileSeparator();
System.out.println("File Separator: " + separator);

Unit Test Coverage

The SystemPropertiesExtensionsTest class ensures property retrieval works:

@Test
public void testGetJavaVersion() {
    String javaVersion = SystemPropertiesExtensions.getJavaVersion();
    assertNotNull(javaVersion);
}

---

Working with System Paths

The library allows retrieving and working with platform-independent system paths.

Example: Getting the User Downloads Directory

File downloadsDir = SystemFileExtensions.getUserDownloadsDir();
System.out.println("Downloads Directory: " + downloadsDir.getAbsolutePath());

Example: Getting the Root Directory

File rootDir = SystemFileExtensions.getRootDir();
System.out.println("Root Directory: " + rootDir.getAbsolutePath());

Unit Test Coverage

@Test
public void testGetRootDir() {
    File rootDir = SystemFileExtensions.getRootDir();
    assertNotNull(rootDir);
}

---

Setting System Properties

The library allows modifying system properties dynamically.

Example: Setting a Custom System Property

Properties properties = new Properties();
properties.setProperty("app.mode", "debug");

SystemPropertiesExtensions.setSystemProperties(properties);

System.out.println("App Mode: " + System.getProperty("app.mode"));

Unit Test Coverage

@Test
public void testSetSystemProperties() {
    Properties props = new Properties();
    props.setProperty("test.prop", "value");

    SystemPropertiesExtensions.setSystemProperties(props);
    assertEquals("value", System.getProperty("test.prop"));
}

---

Conclusion

The file-worker library provides efficient utilities for accessing system-related directories and properties, making it a valuable tool for platform-independent development.

Start using it today to enhance your application's system interactions!