codepages: added get_codepage_name

decalage2
1 parent fdc77bfa
Showing 1 changed file with 13 additions and 0 deletions
oletools/common/codepages.py
@@ -3,6 +3,7 @@ codepages.py
 codepages is a python module to map code pages (numbers) to Python codecs,
 in order to decode bytes to unicode.
+It also provides the name/description of code pages.
 Author: Philippe Lagadec - http://www.decalage.info
 License: BSD, see source code or documentation
@@ -45,6 +46,8 @@ __version__ = &#39;0.54dev6&#39;
 # -----------------------------------------------------------------------------
 # TODO:
+# TODO: check also http://www.aivosto.com/articles/charsets-codepages.html
+# TODO: https://en.wikipedia.org/wiki/Code_page
 # -----------------------------------------------------------------------------
 # REFERENCES:
@@ -290,6 +293,16 @@ def codepage2codec(codepage):
         codec = 'utf8'
     return codec
+
+def get_codepage_name(codepage):
+    """
+    return the name of a codepage based on its number
+    :param codepage: int, codepage number
+    :return: str, codepage name
+    """
+    return CODEPAGE_NAME.get(codepage, 'Unknown code page')
+
+
 # === MAIN: TESTS ============================================================
 if __name__ == '__main__':