SimpleFiles 1.0.0

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. 
dotnet add package SimpleFiles --version 1.0.0                

                    
                

            
NuGet\Install-Package SimpleFiles -Version 1.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="SimpleFiles" Version="1.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add SimpleFiles --version 1.0.0                

                    
                

            
#r "nuget: SimpleFiles, 1.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install SimpleFiles as a Cake Addin
#addin nuget:?package=SimpleFiles&version=1.0.0

// Install SimpleFiles as a Cake Tool
#tool nuget:?package=SimpleFiles&version=1.0.0

🛠️ SimpleFiles Library

The SimpleFiles Library is a powerful and easy-to-use solution for handling file and folder operations in .NET. With built-in encryption and flexibility, it simplifies file management while keeping your data secure. 🔒

🚀 Features

File Management 📄

  • Read and Write Operations: Handle file content seamlessly.
  • Encryption Support: Secure files with AES or ChaCha20 encryption.
  • Customizable Options: Append, overwrite, or create files as needed.
  • Re-encrypt Files: Update encryption keys or parameters on existing files.
  • Rename, Delete, and Check Existence: Perform essential file operations effortlessly.

Folder Management 📁

  • Create, Delete, Rename: Manage folder structure programmatically.
  • Recursive Operations: Copy or move entire folder trees.
  • Get Folder Content: Retrieve files or subfolders with flexible filtering.
  • Check and Empty Folders: Validate and clean up folder contents.

Security 🛡️

  • Memory Safety: Sensitive data like keys and decrypted content are cleared after use.
  • Support for Secure Algorithms: Choose between AES and ChaCha20 for encryption.

📚 Installation

Install the library via NuGet:

dotnet add package SimpleFiles

📝 Usage

Reading a File

var content = File.Read("example.txt", decrypt: true, key: myKey, ivOrNonce: myIv, encryptionAlgorithm: EncryptionAlgorithm.Aes);

Writing to a File

File.Write("example.txt", new[] { "Line 1", "Line 2" }, encrypt: true, key: myKey, encryptionAlgorithm: EncryptionAlgorithm.ChaCha20);

Creating and Deleting a Folder

Folder.Create("myFolder");
Folder.Delete("myFolder", deleteRecursive: true);

📌 Why Choose SimpleFiles?

  • Focus on Security: Encryption support ensures your data stays safe.
  • Ease of Use: Simple APIs make file and folder operations intuitive.
  • Extensibility: Built with flexibility for a variety of use cases.
  • Performance: Efficient handling of large files and folders.

📦 Contributions

Contributions are welcome! Feel free to submit issues or pull requests.

🏷️ License

This project is licensed under the MIT License.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-android34.0 is compatible.  net8.0-browser was computed.  net8.0-browser1.0 is compatible.  net8.0-ios was computed.  net8.0-ios18.0 is compatible.  net8.0-maccatalyst was computed.  net8.0-maccatalyst18.0 is compatible.  net8.0-macos was computed.  net8.0-macos15.0 is compatible.  net8.0-tvos was computed.  net8.0-tvos18.0 is compatible.  net8.0-windows was computed.  net8.0-windows7.0 is compatible.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on SimpleFiles:

Package Downloads
SimpleDataCollections

SimpleDataCollections is your go-to solution for advanced data structures in .NET. It provides a variety of tree implementations that are optimized for flexibility, performance, and extensibility. Whether you need hierarchical data or lazy-loaded trees, we've got you covered! 🚀

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.0 51 1/24/2025

- 🎉 **File Management**:
- Read and write files with optional encryption (AES/ChaCha20).
- Re-encrypt existing files with new keys.
- Rename, delete, and check file existence.
- 📁 **Folder Management**:
- Create, delete, rename, and move folders.
- Copy folders recursively.
- Retrieve folder contents (files or subfolders).
- 🔒 **Security Enhancements**:
- Clear sensitive data from memory after use.
- Support for secure algorithms (AES, ChaCha20).
- 🚀 **Performance**:
- Efficient handling of large files and folders.