aboutsummaryrefslogtreecommitdiffstats
path: root/config_file/abstract_parser.py
diff options
context:
space:
mode:
authorEugene Triguba <eugenetriguba@gmail.com>2020-08-05 20:39:28 -0500
committerEugene Triguba <eugenetriguba@gmail.com>2020-08-05 20:39:28 -0500
commit59eeb1321fbad41dce7c971778e37ac1943fda3b (patch)
tree0ccb143e1094784e9b149977d6f0cabf6f6220b2 /config_file/abstract_parser.py
parentAdd ConfigFilePath to refactor out file specific code (diff)
downloadconfig-file-59eeb1321fbad41dce7c971778e37ac1943fda3b.zip
Redo package to have a flat package structure
By having a flat package structure like this, it'll avoid exposing packages and things we don't want to be exposed.
Diffstat (limited to 'config_file/abstract_parser.py')
-rw-r--r--config_file/abstract_parser.py117
1 files changed, 117 insertions, 0 deletions
diff --git a/config_file/abstract_parser.py b/config_file/abstract_parser.py
new file mode 100644
index 0000000..ed9430b
--- /dev/null
+++ b/config_file/abstract_parser.py
@@ -0,0 +1,117 @@
+from abc import ABC, abstractmethod
+from typing import Any
+
+
+class AbstractParser(ABC):
+ """Abstract Parser is the API contract for all parsers.
+
+ Every parser in ConfigFile implements this parser, and
+ any user created parsers must implement this parser in
+ order for this package to be able to use it.
+
+ Every key is specified in a dot (.) syntax
+ e.g. retrieving.some.deeply.nested.value
+
+ If there is no dot in the key, it is assumed we are
+ performing an action on a top level key, which could
+ be an entire section.
+
+ Args:
+ file_contents: The stringified version of a file.
+
+ Attributes:
+ file_contents: The stringified version of a file.
+ """
+
+ @abstractmethod
+ def __init__(self, file_contents: str) -> None:
+ self.file_contents = file_contents
+
+ @abstractmethod
+ def reset_internal_contents(self, file_contents: str) -> None:
+ """Reset the state of this parser to a new file.
+
+ When restoring to the original file in ConfigFile,
+ we need a way to reset the internal contents to this
+ new file.
+
+ While this may be as simple as setting the file_contents
+ attribute value to the passed in file_contents argument,
+ it likely would not be. This is because the initial
+ passed in file contents would likely be parsed into some
+ special form for the parser to work with more easily.
+
+ Args:
+ file_contents: The file contents of the new file.
+ """
+ raise NotImplementedError
+
+ @abstractmethod
+ def get(self, key: str) -> Any:
+ """Retrieve the value of a key from the working file.
+
+ Args:
+ key: The key to retrieve.
+
+ Returns:
+ Whatever value the given key happens to contain.
+
+ Raises:
+ MissingKeyError: If the key to retrieve does not exist.
+ """
+ raise NotImplementedError
+
+ @abstractmethod
+ def set(self, key: str, value: Any) -> None:
+ """Set the value of a key in the working file.
+
+ If the key does not exist, it should be created.
+
+ Args:
+ key: The key to set.
+ value: The value to set the key to.
+ """
+ raise NotImplementedError
+
+ @abstractmethod
+ def delete(self, key: str) -> None:
+ """Deletes a key from the working file.
+
+ Args:
+ key: The key we would like to remove.
+
+ Raises:
+ MissingKeyError: If the key to remove does not exist.
+ """
+ raise NotImplementedError
+
+ @abstractmethod
+ def stringify(self) -> str:
+ """Stringify the working file.
+
+ Since the ConfigFile does not write out to disk
+ after every operation, this method is what is
+ used as the output for saving the file again.
+ This parser should never write out to the disk.
+
+ Returns:
+ The file we are working with as a string.
+ """
+ raise NotImplementedError
+
+ @abstractmethod
+ def has(self, key: str) -> bool:
+ """Check whether the given key is in the parsed working file.
+
+ This should not behave like a wild card, as in check
+ if the key exists anywhere in the working file. Instead,
+ if a key is given without a dot, it should be assumed we
+ are checking the top level.
+
+ Args:
+ key: The key to search for.
+
+ Returns:
+ True if the working file has the key. False otherwise.
+ """
+ raise NotImplementedError