refactor: extract ACL related functionality (#913)

Remove the ACL-Features from the interfaces and instead implement them as extension methods implemented in "TestableIO.System.IO.Abstractions.Wrappers".

This removes the dependency on `System.IO.FileSystem.AccessControl` from the interface project.

This is part of the approach discussed in #883

BREAKING CHANGE: This refactoring removes ACL-related methods from the interface project and replaces them with extension methods in `TestableIO.System.IO.Abstractions.Wrappers`.

Author: vbreuss

src/TestableIO.System.IO.Abstractions.TestingHelpers/MockDirectory.cs

@@ -1,9 +1,6 @@
 using System.Collections.Generic;
-using System.ComponentModel;
 using System.Globalization;
 using System.Linq;
-using System.Runtime.Versioning;
-using System.Security.AccessControl;
 using System.Text.RegularExpressions;
 
 namespace System.IO.Abstractions.TestingHelpers
@@ -39,17 +36,10 @@ public MockDirectory(IMockFileDataAccessor mockFileDataAccessor, string currentD
         /// <inheritdoc />
         public override IDirectoryInfo CreateDirectory(string path)
         {
-            return CreateDirectoryInternal(path, null);
+            return CreateDirectoryInternal(path);
         }
 
-
-        /// <inheritdoc />
-        public override IDirectoryInfo CreateDirectory(string path, DirectorySecurity directorySecurity)
-        {
-            return CreateDirectoryInternal(path, directorySecurity);
-        }
-
-        private IDirectoryInfo CreateDirectoryInternal(string path, DirectorySecurity directorySecurity)
+        private IDirectoryInfo CreateDirectoryInternal(string path)
         {
             if (path == null)
             {
@@ -80,11 +70,6 @@ private IDirectoryInfo CreateDirectoryInternal(string path, DirectorySecurity di
 
             var created = new MockDirectoryInfo(mockFileDataAccessor, path);
 
-            if (directorySecurity != null)
-            {
-                created.SetAccessControl(directorySecurity);
-            }
-
             return created;
         }
 
@@ -173,31 +158,6 @@ public override bool Exists(string path)
         }
 
 
-        /// <inheritdoc />
-        [SupportedOSPlatform("windows")]
-        public override DirectorySecurity GetAccessControl(string path)
-        {
-            mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");
-            path = path.TrimSlashes();
-
-            if (!mockFileDataAccessor.Directory.Exists(path))
-            {
-                throw CommonExceptions.CouldNotFindPartOfPath(path);
-            }
-
-            var directoryData = (MockDirectoryData)mockFileDataAccessor.GetFile(path);
-            return directoryData.AccessControl;
-        }
-
-
-        /// <inheritdoc />
-        [SupportedOSPlatform("windows")]
-        public override DirectorySecurity GetAccessControl(string path, AccessControlSections includeSections)
-        {
-            return GetAccessControl(path);
-        }
-
-
         /// <inheritdoc />
         public override DateTime GetCreationTime(string path)
         {
@@ -559,22 +519,6 @@ public override IFileSystemInfo ResolveLinkTarget(string linkPath, bool returnFi
 
 #endif
 
-        /// <inheritdoc />
-        [SupportedOSPlatform("windows")]
-        public override void SetAccessControl(string path, DirectorySecurity directorySecurity)
-        {
-            mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");
-            path = path.TrimSlashes();
-
-            if (!mockFileDataAccessor.Directory.Exists(path))
-            {
-                throw CommonExceptions.CouldNotFindPartOfPath(path);
-            }
-
-            var directoryData = (MockDirectoryData)mockFileDataAccessor.GetFile(path);
-            directoryData.AccessControl = directorySecurity;
-        }
-
         /// <inheritdoc />
         public override void SetCreationTime(string path, DateTime creationTime)
         {

src/TestableIO.System.IO.Abstractions.TestingHelpers/MockDirectoryInfo.cs

@@ -1,5 +1,6 @@
 using System.Collections.Generic;
 using System.Linq;
+using System.Runtime.Versioning;
 using System.Security.AccessControl;
 
 namespace System.IO.Abstractions.TestingHelpers
@@ -8,7 +9,7 @@ namespace System.IO.Abstractions.TestingHelpers
 
     /// <inheritdoc />
     [Serializable]
-    public class MockDirectoryInfo : DirectoryInfoBase
+    public class MockDirectoryInfo : DirectoryInfoBase, IFileSystemAclSupport
     {
         private readonly IMockFileDataAccessor mockFileDataAccessor;
         private readonly string directoryPath;
@@ -26,6 +27,15 @@ public MockDirectoryInfo(IMockFileDataAccessor mockFileDataAccessor, string dire
         {
             this.mockFileDataAccessor = mockFileDataAccessor ?? throw new ArgumentNullException(nameof(mockFileDataAccessor));
 
+            if (directoryPath == null)
+            {
+                throw new ArgumentNullException("path", StringResources.Manager.GetString("VALUE_CANNOT_BE_NULL"));
+            }
+            if (directoryPath.Trim() == string.Empty)
+            {
+                throw CommonExceptions.PathIsNotOfALegalForm("path");
+            }
+            
             originalPath = directoryPath;
             directoryPath = mockFileDataAccessor.Path.GetFullPath(directoryPath);
 
@@ -179,14 +189,7 @@ public override void Create()
             mockFileDataAccessor.Directory.CreateDirectory(FullName);
             refreshOnNextRead = true;
         }
-
-        /// <inheritdoc />
-        public override void Create(DirectorySecurity directorySecurity)
-        {
-            mockFileDataAccessor.Directory.CreateDirectory(FullName, directorySecurity);
-            refreshOnNextRead = true;
-        }
-
+        
         /// <inheritdoc />
         public override IDirectoryInfo CreateSubdirectory(string path)
         {
@@ -277,19 +280,7 @@ public override IEnumerable<IFileSystemInfo> EnumerateFileSystemInfos(string sea
             return GetFileSystemInfos(searchPattern, enumerationOptions);
         }
 #endif
-
-        /// <inheritdoc />
-        public override DirectorySecurity GetAccessControl()
-        {
-            return mockFileDataAccessor.Directory.GetAccessControl(directoryPath);
-        }
-
-        /// <inheritdoc />
-        public override DirectorySecurity GetAccessControl(AccessControlSections includeSections)
-        {
-            return mockFileDataAccessor.Directory.GetAccessControl(directoryPath, includeSections);
-        }
-
+        
         /// <inheritdoc />
         public override IDirectoryInfo[] GetDirectories()
         {
@@ -388,13 +379,7 @@ public override void MoveTo(string destDirName)
         {
             mockFileDataAccessor.Directory.Move(directoryPath, destDirName);
         }
-
-        /// <inheritdoc />
-        public override void SetAccessControl(DirectorySecurity directorySecurity)
-        {
-            mockFileDataAccessor.Directory.SetAccessControl(directoryPath, directorySecurity);
-        }
-
+        
         /// <inheritdoc />
         public override IDirectoryInfo Parent
         {
@@ -435,5 +420,32 @@ public override string ToString()
         {
             return originalPath;
         }
+
+        /// <inheritdoc cref="IFileSystemAclSupport.GetAccessControl()" />
+        [SupportedOSPlatform("windows")]
+        public object GetAccessControl()
+        {
+            return GetMockDirectoryData().AccessControl;
+        }
+
+        /// <inheritdoc cref="IFileSystemAclSupport.GetAccessControl(IFileSystemAclSupport.AccessControlSections)" />
+        [SupportedOSPlatform("windows")]
+        public object GetAccessControl(IFileSystemAclSupport.AccessControlSections includeSections)
+        {
+            return GetMockDirectoryData().AccessControl;
+        }
+
+        /// <inheritdoc cref="IFileSystemAclSupport.SetAccessControl(object)" />
+        [SupportedOSPlatform("windows")]
+        public void SetAccessControl(object value)
+        {
+            GetMockDirectoryData().AccessControl = value as DirectorySecurity;
+        }
+        
+        private MockDirectoryData GetMockDirectoryData()
+        {
+            return mockFileDataAccessor.GetFile(directoryPath) as MockDirectoryData
+                ?? throw CommonExceptions.CouldNotFindPartOfPath(directoryPath);
+        }
     }
 }

src/TestableIO.System.IO.Abstractions.TestingHelpers/MockFile.cs

@@ -1,8 +1,6 @@
 using System.Collections.Generic;
 using System.Globalization;
 using System.Linq;
-using System.Runtime.Versioning;
-using System.Security.AccessControl;
 using System.Text;
 
 namespace System.IO.Abstractions.TestingHelpers
@@ -268,28 +266,6 @@ public override bool Exists(string path)
             return false;
         }
 
-        /// <inheritdoc />
-        [SupportedOSPlatform("windows")]
-        public override FileSecurity GetAccessControl(string path)
-        {
-            mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");
-
-            if (!mockFileDataAccessor.FileExists(path))
-            {
-                throw CommonExceptions.FileNotFound(path);
-            }
-
-            var fileData = mockFileDataAccessor.GetFile(path);
-            return fileData.AccessControl;
-        }
-
-        /// <inheritdoc />
-        [SupportedOSPlatform("windows")]
-        public override FileSecurity GetAccessControl(string path, AccessControlSections includeSections)
-        {
-            return GetAccessControl(path);
-        }
-
         /// <summary>
         /// Gets the <see cref="FileAttributes"/> of the file on the path.
         /// </summary>
@@ -732,22 +708,6 @@ public override IFileSystemInfo ResolveLinkTarget(string linkPath, bool returnFi
         }
 #endif
 
-        /// <inheritdoc />
-        [SupportedOSPlatform("windows")]
-        public override void SetAccessControl(string path, FileSecurity fileSecurity)
-        {
-            mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");
-
-            if (!mockFileDataAccessor.FileExists(path))
-            {
-                throw CommonExceptions.FileNotFound(path);
-            }
-
-            var fileData = mockFileDataAccessor.GetFile(path);
-            mockFileDataAccessor.AdjustTimes(fileData, TimeAdjustments.LastAccessTime);
-            fileData.AccessControl = fileSecurity;
-        }
-
         /// <inheritdoc />
         public override void SetAttributes(string path, FileAttributes fileAttributes)
         {

src/TestableIO.System.IO.Abstractions.TestingHelpers/MockFileData.cs

@@ -133,7 +133,7 @@ public string TextContents
         public DateTimeOffset CreationTime
         {
             get { return creationTime; }
-            set{ creationTime = value.ToUniversalTime(); }
+            set { creationTime = value.ToUniversalTime(); }
         }
         private DateTimeOffset creationTime;
 
@@ -179,7 +179,7 @@ public static implicit operator MockFileData(string s)
         public FileAttributes Attributes { get; set; } = FileAttributes.Normal;
 
         /// <summary>
-        /// Gets or sets <see cref="FileSecurity"/> of the <see cref="MockFileData"/>. This is the object that is returned for this <see cref="MockFileData"/> when calling <see cref="FileBase.GetAccessControl(string)"/>.
+        /// Gets or sets <see cref="FileSecurity"/> of the <see cref="MockFileData"/>.
         /// </summary>
         [SupportedOSPlatform("windows")]
         public FileSecurity AccessControl

src/TestableIO.System.IO.Abstractions.TestingHelpers/MockFileInfo.cs

@@ -5,7 +5,7 @@ namespace System.IO.Abstractions.TestingHelpers
 {
     /// <inheritdoc />
     [Serializable]
-    public class MockFileInfo : FileInfoBase
+    public class MockFileInfo : FileInfoBase, IFileSystemAclSupport
     {
         private readonly IMockFileDataAccessor mockFileSystem;
         private string path;
@@ -18,7 +18,8 @@ public class MockFileInfo : FileInfoBase
         public MockFileInfo(IMockFileDataAccessor mockFileSystem, string path) : base(mockFileSystem?.FileSystem)
         {
             this.mockFileSystem = mockFileSystem ?? throw new ArgumentNullException(nameof(mockFileSystem));
-            this.originalPath = path ?? throw new ArgumentNullException(nameof(path));
+            mockFileSystem.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");
+            this.originalPath = path;
             this.path = mockFileSystem.Path.GetFullPath(path);
             this.mockFile = new MockFile(mockFileSystem);
             Refresh();
@@ -256,21 +257,7 @@ public override void Encrypt()
             var mockFileData = GetMockFileDataForWrite();
             mockFileData.Attributes |= FileAttributes.Encrypted;
         }
-
-        /// <inheritdoc />
-        [SupportedOSPlatform("windows")]
-        public override FileSecurity GetAccessControl()
-        {
-            return mockFileSystem.File.GetAccessControl(this.path);
-        }
-
-        /// <inheritdoc />
-        [SupportedOSPlatform("windows")]
-        public override FileSecurity GetAccessControl(AccessControlSections includeSections)
-        {
-            return mockFileSystem.File.GetAccessControl(this.path, includeSections);
-        }
-
+        
         /// <inheritdoc />
         public override void MoveTo(string destFileName)
         {
@@ -334,14 +321,7 @@ public override IFileInfo Replace(string destinationFileName, string destination
             mockFile.Replace(path, destinationFileName, destinationBackupFileName, ignoreMetadataErrors);
             return mockFileSystem.FileInfo.New(destinationFileName);
         }
-
-        /// <inheritdoc />
-        [SupportedOSPlatform("windows")]
-        public override void SetAccessControl(FileSecurity fileSecurity)
-        {
-            mockFile.SetAccessControl(this.path, fileSecurity);
-        }
-
+        
         /// <inheritdoc />
         public override IDirectoryInfo Directory
         {
@@ -404,6 +384,33 @@ public override string ToString()
             return originalPath;
         }
 
+        /// <inheritdoc cref="IFileSystemAclSupport.GetAccessControl()" />
+        [SupportedOSPlatform("windows")]
+        public object GetAccessControl()
+        {
+            return GetMockFileData().AccessControl;
+        }
+
+        /// <inheritdoc cref="IFileSystemAclSupport.GetAccessControl(IFileSystemAclSupport.AccessControlSections)" />
+        [SupportedOSPlatform("windows")]
+        public object GetAccessControl(IFileSystemAclSupport.AccessControlSections includeSections)
+        {
+            return GetMockFileData().AccessControl;
+        }
+
+        /// <inheritdoc cref="IFileSystemAclSupport.SetAccessControl(object)" />
+        [SupportedOSPlatform("windows")]
+        public void SetAccessControl(object value)
+        {
+            GetMockFileData().AccessControl = value as FileSecurity;
+        }
+
+        private MockFileData GetMockFileData()
+        {
+            return mockFileSystem.GetFile(path)
+                   ?? throw CommonExceptions.FileNotFound(path);
+        }
+
         private static DateTime AdjustUnspecifiedKind(DateTime time, DateTimeKind fallbackKind)
         {
             if (time.Kind == DateTimeKind.Unspecified)