Add encoding parameter to readlines method signature

- Update Fs abstract method to accept encoding parameter with utf-8 default
- Update PathFs and RecordFs implementations to support encoding parameter
- Maintains backward compatibility with default utf-8 encoding
- Addresses PR feedback for Python 3.9 and earlier compatibility

Author: cpyle0819

aws_doc_sdk_examples_tools/fs.py

@@ -28,7 +28,7 @@ def read(self, path: Path) -> str:
         pass
 
     @abstractmethod
-    def readlines(self, path: Path) -> List[str]:
+    def readlines(self, path: Path, encoding: str = "utf-8") -> List[str]:
         pass
 
     @abstractmethod
@@ -56,8 +56,8 @@ def read(self, path: Path) -> str:
         with path.open("r", encoding="utf-8") as file:
             return file.read()
 
-    def readlines(self, path: Path) -> List[str]:
-        with path.open("r", encoding="utf-8") as file:
+    def readlines(self, path: Path, encoding: str = "utf-8") -> List[str]:
+        with path.open("r", encoding=encoding) as file:
             return file.readlines()
 
     def write(self, path: Path, content: str):
@@ -95,7 +95,7 @@ def glob(self, path: Path, glob: str) -> Generator[Path, None, None]:
     def read(self, path: Path) -> str:
         return self.fs[path]
 
-    def readlines(self, path: Path) -> List[str]:
+    def readlines(self, path: Path, encoding: str = "utf-8") -> List[str]:
         content = self.fs[path]
         return content.splitlines(keepends=True)