Merge 0ebc631 into ee3e335

.gitignore

@@ -94,3 +94,4 @@ ENV/
 #PyCharm
 
 .idea/
+/tmp/

fs/_fscompat.py

@@ -5,40 +5,8 @@
 try:
     from os import fsencode, fsdecode
 except ImportError:
-    def _fscodec():
-        encoding = sys.getfilesystemencoding()
-        errors = 'strict' if encoding == 'mbcs' else 'surrogateescape'
+    from backports.os import fsencode, fsdecode
 
-        def fsencode(filename):
-            """
-            Encode filename to the filesystem encoding with 'surrogateescape' error
-            handler, return bytes unchanged. On Windows, use 'strict' error handler if
-            the file system encoding is 'mbcs' (which is the default encoding).
-            """
-            if isinstance(filename, bytes):
-                return filename
-            elif isinstance(filename, six.text_type):
-                return filename.encode(encoding, errors)
-            else:
-                raise TypeError("expect string type, not %s" % type(filename).__name__)
-
-        def fsdecode(filename):
-            """
-            Decode filename from the filesystem encoding with 'surrogateescape' error
-            handler, return str unchanged. On Windows, use 'strict' error handler if
-            the file system encoding is 'mbcs' (which is the default encoding).
-            """
-            if isinstance(filename, six.text_type):
-                return filename
-            elif isinstance(filename, bytes):
-                return filename.decode(encoding, errors)
-            else:
-                raise TypeError("expect string type, not %s" % type(filename).__name__)
-
-        return fsencode, fsdecode
-
-    fsencode, fsdecode = _fscodec()
-    del _fscodec
 
 try:
     from os import fspath

fs/base.py

@@ -599,14 +599,14 @@ def getsize(self, path):
         size = self.getdetails(path).size
         return size
 
-    def getsyspath(self, path):
+    def getsyspath(self, path, as_bytes=False):
         """Get the *system path* of a resource.
 
         Parameters:
             path (str): A path on the filesystem.
 
         Returns:
-            str: the *system path* of the resource, if any.
+            str: the *system path* of the resource, if any, always as Unicode.
 
         Raises:
             fs.errors.NoSysPath: If there is no corresponding system path.
@@ -629,6 +629,14 @@ def getsyspath(self, path):
             resource is referenced by that path -- as long as it can
             be certain what that system path would be.
 
+        Note:
+            The returned value is always Unicode. Some filesystems 
+            such as on Linux only deal with bytes. If you need to use
+            a path outside of Python, or if you are running Python 2
+            on Linux, you can get a proper byte value from a Unicode
+            path using the os.fsencode function on Python 3 or its
+            Pythyon 2 backport available here.
+
         """
         raise errors.NoSysPath(path=path)