MapleX 2.2.0a2__tar.gz → 2.2.0b1__tar.gz

{maplex-2.2.0a2 → maplex-2.2.0b1}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: MapleX
-Version: 2.2.0a2
-Summary: # MapleX
-Author: Ryuji Hazama
+Version: 2.2.0b1
+Summary: A Python library for Maple file format operations, with logging and console color utilities
+Author: RyujiHazama
 Project-URL: PyPI, https://pypi.org/project/MapleX/
 Project-URL: Homepage, https://github.com/Ryuji-Hazama
 Project-URL: Repository, https://github.com/Ryuji-Hazama/MapleTree
@@ -26,9 +26,18 @@ Dynamic: license-file
     ***You can install the package from pip with the following command.***
 
 ```bash
-pip install maplex
+pip install MapleX
 ```
 
+## Table of Contents
+
+> - [Maple File](#maple-file)
+> - [MapleTree Class](#mapletree-class)
+> - [Logger Class](#logger-class)
+> - [Exceptions](#exceptions)
+> - [Console Colors](#console-colors)
+> - [Install MapleX](#install-maplex)
+
 ## Maple File
 
     Maple is a file system that I created when I was a child. It's like a combination of the INI file and the Jason file. I made this format that is easy to read and write for both humans and machines.
@@ -314,6 +323,8 @@ EOF
     If `encrypt=True`, the instance decrypts data when it is read, and encrypts data when it is saved.  
     You need to specify the byte key when you use encryption, and the file must be encrypted.
 
+:warning: **The key must be 32 url-safe base64-encoded bytes**
+
 ```python
 mapleFile = MapleTree("FileName.mpl", encrypt=True, key=key)
 ```
@@ -385,7 +396,32 @@ def saveTagLine(
 |**`willSave`**|\*|Save to file flag|
 |**`headers`**||Target headers|
 
-    `saveTagLine` saves a value with a tag in a header block specified by the parameter.
+    Outdated from `v2.2.0`
+
+### `saveValue()`
+
+    `v2.2.0` or newer
+
+```python
+def saveValue(
+    tag: str,
+    valueString: any,
+    *headers: str,
+    **kwargs
+) -> bool
+```
+
+|Property|Required|Value|
+|--------|--------|-----|
+|**`tag`**|\*|Target tag|
+|**`value`**|\*|Value to save|
+|**`headers`**||Target headers|
+|**`kwargs`**||Keyword arguments|
+
+    `saveValue` saves a value with a tag in a header block specified by the parameter.
+
+- Set `save=True` to save changes to the file.
+  - Default: `save=False`
 
 E.g.:
 
@@ -393,7 +429,7 @@ E.g.:
 from maplex import MapleTree
 
 mapleFile = MapleTree("SampleData.mpl", createBaseFile=True)
-mapleFile.saveTagLine("TAG", "VALUE", True, "FOO")
+mapleFile.saveTagLine("TAG", "VALUE", "FOO", save=True)
 
 ```
 
@@ -409,12 +445,12 @@ EOF
 
 #### Update a Buffer Content
 
-    If `willSave=False`, the buffer content will be updated, but no update on physical file content.
+    If `save=False` (or not specified), the buffer content will be updated, but no update on physical file content.
 
 E.g.:
 
 ```python
-mapleFile.saveTagLine("TAG", "NEW VALUE", False, "FOO")
+mapleFile.saveTagLine("TAG", "NEW VALUE", "FOO")
 ```
 
     This code changes the contents on buffer like:
@@ -439,10 +475,10 @@ EOF
 
 #### Update and Save Changes
 
-    If `willSave=True`, all the changes to the buffer will be saved.
+    If `save=True`, all the changes to the buffer will be saved.
 
 ```python
-mapleFile.saveTagLine("BAR", "ANOTHER VALUE", True, "FOO")
+mapleFile.saveTagLine("BAR", "ANOTHER VALUE", "FOO", save=True)
 ```
 
     This code changes the contents in the file like:
@@ -461,10 +497,10 @@ EOF
     If the block and/or the header(s) specified with the parameters do not exist in the data, the function creates the new header block(s) and the tag and saves the value.
 
 ```python
-mapleFile.saveTagLine("TAZ", "NEW HEADER AND TAG", False, "NEW_HEADER")
+mapleFile.saveTagLine("TAZ", "NEW HEADER AND TAG", "NEW_HEADER")
 ```
 
-    This code will change the data like:
+    This code will change the buffer data like:
 
 ```text
 MAPLE
@@ -478,48 +514,47 @@ E
 EOF
 ```
 
-### `saveValue()`
-
-    `v2.2.0` or newer
+### `deleteTag()`
 
 ```python
-def saveValue(
-    tag: str,
-    valueString: any,
-    *headers: str,
-    **kwargs
+def deleteTag(
+    delTag: str,
+    willSave: bool = False,
+    *headers: str
 ) -> bool
 ```
 
 |Property|Required|Value|
 |--------|--------|-----|
-|**`tag`**|\*|Tag to delete|
-|**`value`**|\*|Value to save|
+|**`delTag`**|\*|Tag to delete|
+|**`willSave`**||Save to file flag|
 |**`headers`**||Target headers|
-|**`kwargs`**||Keyword arguments|
 
-- Same as `saveTagLine()`
-- Set `save=True` to save changes to the file.
-  - Default: `save=False`
+    Outdated from `v2.2.0`
 
-### `deleteTag()`
+### `deleteValue()`
+
+    `v2.2.0` or newer
 
 ```python
-def deleteTag(
+def deleteValue(
     delTag: str,
-    willSave: bool = False,
-    *headers: str
+    *headers: str,
+    **kwargs
 ) -> bool
 ```
 
 |Property|Required|Value|
 |--------|--------|-----|
 |**`delTag`**|\*|Tag to delete|
-|**`willSave`**||Save to file flag|
 |**`headers`**||Target headers|
+|**`kwargs`**||Keyword arguments|
 
     Delete a tag and its value.
 
+- Set `save=True` to save changes to the file.
+  - Default: `save=False`
+
 Sample data: `SampleData.mpl`
 
 ```text
@@ -539,7 +574,7 @@ E.g.:
 from maplex import MapleTree
 
 mapleFile = MapleTree("SampleData.mpl")
-mapleFile.deleteTag("BAR", True, "FOO")
+mapleFile.deleteTag("BAR", "FOO", save=True)
 ```
 
     The file data will be changed like:
@@ -554,28 +589,6 @@ E
 EOF
 ```
 
-### `deleteValue()`
-
-    `v2.2.0` or newer
-
-```python
-def deleteValue(
-    delTag: str,
-    *headers: str,
-    **kwargs
-) -> bool
-```
-
-|Property|Required|Value|
-|--------|--------|-----|
-|**`delTag`**|\*|Tag to delete|
-|**`headers`**||Target headers|
-|**`kwargs`**||Keyword arguments|
-
-- Same as `deleteTag()`
-- Set `save=True` to save changes to the file.
-  - Default: `save=False`
-
 ### `getTagValueDict()`
 
 ```python
@@ -670,8 +683,31 @@ def deleteHeader(
 |**`willSave`**||Save to file flag|
 |**`Headers`**||Target headers|
 
+    Outdated from `v2.2.0`
+
+### `removeHeader()`
+
+    `v2.2.0` or newer
+
+```python
+def removeHeader(
+    delHead: str,
+    *headers: str,
+    **kwargs
+) -> bool
+```
+
+|Property|Required|Value|
+|--------|--------|-----|
+|**`delHead`**|\*|Deleting header|
+|**`headers`**||Target headers|
+|**`kwargs`**||Keyword arguments|
+
     This deletes an entire header block and its associated data, including child blocks.
 
+- Set `save=True` for save data to the file.
+  - Default: `save=False`
+
 Sample data: `SampleData.mpl`
 
 ```text
@@ -696,7 +732,7 @@ E.g.:
 from maplex import MapleTree
 
 mapleTree = MapleTree("SampleData.mpl")
-mapleTree.deleteHeader("FOO", True)
+mapleTree.deleteHeader("FOO", save=True)
 ```
 
     This code changes the data like:
@@ -711,28 +747,6 @@ E
 EOF
 ```
 
-### `removeHeader()`
-
-    `v2.2.0` or newer
-
-```python
-def removeHeader(
-    delHead: str,
-    *headers: str,
-    **kwargs
-) -> bool
-```
-
-|Property|Required|Value|
-|--------|--------|-----|
-|**`delHead`**|\*|Deleting header|
-|**`headers`**||Target headers|
-|**`kwargs`**||Keyword arguments|
-
-- Same as `deleteHeader()`
-- Set `save=True` for save data to the file.
-  - Default: `save=False`
-
 ### `getHeaders()`
 
 ```python
@@ -1006,6 +1020,26 @@ E
 EOF
 ```
 
+### `changeEncryptionKey()`
+
+    `v2.2.0` or newer
+
+```python
+def changeEncryptionKey(
+    newKey: bytes,
+    save: bool = False
+    ) -> None
+```
+
+|Property|Required|Value|
+|--------|--------|-----|
+|**`newKey`**|\*|New encryption key|
+|**`save`**||Save to file flag|
+
+    Changing file encryption key. If `save=True`, encrypt the buffer data with new key and save to the file.
+
+:warning: **The key must be 32 url-safe base64-encoded bytes**
+
 ## Logger Class
 
     Logger is a logging object for Python applications. It outputs application logs to log files and to standard output.
@@ -1088,8 +1122,9 @@ def ShowError(
 
 - You can configure log settings with `config.mpl`.
 - If `config.mpl` does not exist, the instance auto-generates the file.
+- Instance uses the parameter values to auto-generate configuration file, or using default value if it was not specified.
 
-Auto-generated `config.mpl`:
+Auto-generated `config.mpl` (parameters not specified):
 
 ```text
 MAPLE
@@ -1136,6 +1171,10 @@ EOF
 
     This occurs when the data is not found in the file.
 
+### `MapleEncryptionNotEnabledException(MapleException)`
+
+    This occurs when try to encrypt maple data, but the encryption flag is `False`.
+
 ### `class MapleHeaderNotFoundException(MapleDataNotFoundException)`
 
     This occurs when the header (specified by the user) is not found in the data.
@@ -1218,12 +1257,12 @@ EOF
 |`Reversed`|\\033\[7m|Reversed colors|
 |`Reset`|\\033\[0m|Reset formatting|
 
-## Install maplex :inbox_tray:
+## Install MapleX
 
 ### From PyPI
 
 ```bash
-[python[3] -m] pip install maplex [--break-system-packages]
+[python[3] -m] pip install MapleX [--break-system-packages]
 ```
 
 ### Manual Installation

maplex-2.2.0a2/src/MapleX.egg-info/PKG-INFO → maplex-2.2.0b1/README.md

@@ -1,24 +1,3 @@
-Metadata-Version: 2.4
-Name: MapleX
-Version: 2.2.0a2
-Summary: # MapleX
-Author: Ryuji Hazama
-Project-URL: PyPI, https://pypi.org/project/MapleX/
-Project-URL: Homepage, https://github.com/Ryuji-Hazama
-Project-URL: Repository, https://github.com/Ryuji-Hazama/MapleTree
-Project-URL: Issues, https://github.com/Ryuji-Hazama/MapleTree/issues
-Project-URL: YouTube, https://www.youtube.com/@ryujihazama
-Project-URL: Instagram, https://www.instagram.com/ryujihazama/
-Classifier: Programming Language :: Python :: 3.12
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: cryptography>=46.0.3
-Requires-Dist: pydantic>=2.12.5
-Dynamic: license-file
-
 # :maple_leaf: MapleX :deciduous_tree:
 
     MapleX is a tool set for Maple file format operations, with logging and console color utilities for Python applications.
@@ -26,9 +5,18 @@ Dynamic: license-file
     ***You can install the package from pip with the following command.***
 
 ```bash
-pip install maplex
+pip install MapleX
 ```
 
+## Table of Contents
+
+> - [Maple File](#maple-file)
+> - [MapleTree Class](#mapletree-class)
+> - [Logger Class](#logger-class)
+> - [Exceptions](#exceptions)
+> - [Console Colors](#console-colors)
+> - [Install MapleX](#install-maplex)
+
 ## Maple File
 
     Maple is a file system that I created when I was a child. It's like a combination of the INI file and the Jason file. I made this format that is easy to read and write for both humans and machines.
@@ -314,6 +302,8 @@ EOF
     If `encrypt=True`, the instance decrypts data when it is read, and encrypts data when it is saved.  
     You need to specify the byte key when you use encryption, and the file must be encrypted.
 
+:warning: **The key must be 32 url-safe base64-encoded bytes**
+
 ```python
 mapleFile = MapleTree("FileName.mpl", encrypt=True, key=key)
 ```
@@ -385,7 +375,32 @@ def saveTagLine(
 |**`willSave`**|\*|Save to file flag|
 |**`headers`**||Target headers|
 
-    `saveTagLine` saves a value with a tag in a header block specified by the parameter.
+    Outdated from `v2.2.0`
+
+### `saveValue()`
+
+    `v2.2.0` or newer
+
+```python
+def saveValue(
+    tag: str,
+    valueString: any,
+    *headers: str,
+    **kwargs
+) -> bool
+```
+
+|Property|Required|Value|
+|--------|--------|-----|
+|**`tag`**|\*|Target tag|
+|**`value`**|\*|Value to save|
+|**`headers`**||Target headers|
+|**`kwargs`**||Keyword arguments|
+
+    `saveValue` saves a value with a tag in a header block specified by the parameter.
+
+- Set `save=True` to save changes to the file.
+  - Default: `save=False`
 
 E.g.:
 
@@ -393,7 +408,7 @@ E.g.:
 from maplex import MapleTree
 
 mapleFile = MapleTree("SampleData.mpl", createBaseFile=True)
-mapleFile.saveTagLine("TAG", "VALUE", True, "FOO")
+mapleFile.saveTagLine("TAG", "VALUE", "FOO", save=True)
 
 ```
 
@@ -409,12 +424,12 @@ EOF
 
 #### Update a Buffer Content
 
-    If `willSave=False`, the buffer content will be updated, but no update on physical file content.
+    If `save=False` (or not specified), the buffer content will be updated, but no update on physical file content.
 
 E.g.:
 
 ```python
-mapleFile.saveTagLine("TAG", "NEW VALUE", False, "FOO")
+mapleFile.saveTagLine("TAG", "NEW VALUE", "FOO")
 ```
 
     This code changes the contents on buffer like:
@@ -439,10 +454,10 @@ EOF
 
 #### Update and Save Changes
 
-    If `willSave=True`, all the changes to the buffer will be saved.
+    If `save=True`, all the changes to the buffer will be saved.
 
 ```python
-mapleFile.saveTagLine("BAR", "ANOTHER VALUE", True, "FOO")
+mapleFile.saveTagLine("BAR", "ANOTHER VALUE", "FOO", save=True)
 ```
 
     This code changes the contents in the file like:
@@ -461,10 +476,10 @@ EOF
     If the block and/or the header(s) specified with the parameters do not exist in the data, the function creates the new header block(s) and the tag and saves the value.
 
 ```python
-mapleFile.saveTagLine("TAZ", "NEW HEADER AND TAG", False, "NEW_HEADER")
+mapleFile.saveTagLine("TAZ", "NEW HEADER AND TAG", "NEW_HEADER")
 ```
 
-    This code will change the data like:
+    This code will change the buffer data like:
 
 ```text
 MAPLE
@@ -478,48 +493,47 @@ E
 EOF
 ```
 
-### `saveValue()`
-
-    `v2.2.0` or newer
+### `deleteTag()`
 
 ```python
-def saveValue(
-    tag: str,
-    valueString: any,
-    *headers: str,
-    **kwargs
+def deleteTag(
+    delTag: str,
+    willSave: bool = False,
+    *headers: str
 ) -> bool
 ```
 
 |Property|Required|Value|
 |--------|--------|-----|
-|**`tag`**|\*|Tag to delete|
-|**`value`**|\*|Value to save|
+|**`delTag`**|\*|Tag to delete|
+|**`willSave`**||Save to file flag|
 |**`headers`**||Target headers|
-|**`kwargs`**||Keyword arguments|
 
-- Same as `saveTagLine()`
-- Set `save=True` to save changes to the file.
-  - Default: `save=False`
+    Outdated from `v2.2.0`
 
-### `deleteTag()`
+### `deleteValue()`
+
+    `v2.2.0` or newer
 
 ```python
-def deleteTag(
+def deleteValue(
     delTag: str,
-    willSave: bool = False,
-    *headers: str
+    *headers: str,
+    **kwargs
 ) -> bool
 ```
 
 |Property|Required|Value|
 |--------|--------|-----|
 |**`delTag`**|\*|Tag to delete|
-|**`willSave`**||Save to file flag|
 |**`headers`**||Target headers|
+|**`kwargs`**||Keyword arguments|
 
     Delete a tag and its value.
 
+- Set `save=True` to save changes to the file.
+  - Default: `save=False`
+
 Sample data: `SampleData.mpl`
 
 ```text
@@ -539,7 +553,7 @@ E.g.:
 from maplex import MapleTree
 
 mapleFile = MapleTree("SampleData.mpl")
-mapleFile.deleteTag("BAR", True, "FOO")
+mapleFile.deleteTag("BAR", "FOO", save=True)
 ```
 
     The file data will be changed like:
@@ -554,28 +568,6 @@ E
 EOF
 ```
 
-### `deleteValue()`
-
-    `v2.2.0` or newer
-
-```python
-def deleteValue(
-    delTag: str,
-    *headers: str,
-    **kwargs
-) -> bool
-```
-
-|Property|Required|Value|
-|--------|--------|-----|
-|**`delTag`**|\*|Tag to delete|
-|**`headers`**||Target headers|
-|**`kwargs`**||Keyword arguments|
-
-- Same as `deleteTag()`
-- Set `save=True` to save changes to the file.
-  - Default: `save=False`
-
 ### `getTagValueDict()`
 
 ```python
@@ -670,8 +662,31 @@ def deleteHeader(
 |**`willSave`**||Save to file flag|
 |**`Headers`**||Target headers|
 
+    Outdated from `v2.2.0`
+
+### `removeHeader()`
+
+    `v2.2.0` or newer
+
+```python
+def removeHeader(
+    delHead: str,
+    *headers: str,
+    **kwargs
+) -> bool
+```
+
+|Property|Required|Value|
+|--------|--------|-----|
+|**`delHead`**|\*|Deleting header|
+|**`headers`**||Target headers|
+|**`kwargs`**||Keyword arguments|
+
     This deletes an entire header block and its associated data, including child blocks.
 
+- Set `save=True` for save data to the file.
+  - Default: `save=False`
+
 Sample data: `SampleData.mpl`
 
 ```text
@@ -696,7 +711,7 @@ E.g.:
 from maplex import MapleTree
 
 mapleTree = MapleTree("SampleData.mpl")
-mapleTree.deleteHeader("FOO", True)
+mapleTree.deleteHeader("FOO", save=True)
 ```
 
     This code changes the data like:
@@ -711,28 +726,6 @@ E
 EOF
 ```
 
-### `removeHeader()`
-
-    `v2.2.0` or newer
-
-```python
-def removeHeader(
-    delHead: str,
-    *headers: str,
-    **kwargs
-) -> bool
-```
-
-|Property|Required|Value|
-|--------|--------|-----|
-|**`delHead`**|\*|Deleting header|
-|**`headers`**||Target headers|
-|**`kwargs`**||Keyword arguments|
-
-- Same as `deleteHeader()`
-- Set `save=True` for save data to the file.
-  - Default: `save=False`
-
 ### `getHeaders()`
 
 ```python
@@ -1006,6 +999,26 @@ E
 EOF
 ```
 
+### `changeEncryptionKey()`
+
+    `v2.2.0` or newer
+
+```python
+def changeEncryptionKey(
+    newKey: bytes,
+    save: bool = False
+    ) -> None
+```
+
+|Property|Required|Value|
+|--------|--------|-----|
+|**`newKey`**|\*|New encryption key|
+|**`save`**||Save to file flag|
+
+    Changing file encryption key. If `save=True`, encrypt the buffer data with new key and save to the file.
+
+:warning: **The key must be 32 url-safe base64-encoded bytes**
+
 ## Logger Class
 
     Logger is a logging object for Python applications. It outputs application logs to log files and to standard output.
@@ -1088,8 +1101,9 @@ def ShowError(
 
 - You can configure log settings with `config.mpl`.
 - If `config.mpl` does not exist, the instance auto-generates the file.
+- Instance uses the parameter values to auto-generate configuration file, or using default value if it was not specified.
 
-Auto-generated `config.mpl`:
+Auto-generated `config.mpl` (parameters not specified):
 
 ```text
 MAPLE
@@ -1136,6 +1150,10 @@ EOF
 
     This occurs when the data is not found in the file.
 
+### `MapleEncryptionNotEnabledException(MapleException)`
+
+    This occurs when try to encrypt maple data, but the encryption flag is `False`.
+
 ### `class MapleHeaderNotFoundException(MapleDataNotFoundException)`
 
     This occurs when the header (specified by the user) is not found in the data.
@@ -1218,12 +1236,12 @@ EOF
 |`Reversed`|\\033\[7m|Reversed colors|
 |`Reset`|\\033\[0m|Reset formatting|
 
-## Install maplex :inbox_tray:
+## Install MapleX
 
 ### From PyPI
 
 ```bash
-[python[3] -m] pip install maplex [--break-system-packages]
+[python[3] -m] pip install MapleX [--break-system-packages]
 ```
 
 ### Manual Installation

{maplex-2.2.0a2 → maplex-2.2.0b1}/pyproject.toml

@@ -4,8 +4,9 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "MapleX"
-version = "2.2.0a2"
-description = """
+version = "2.2.0b1"
+description = """A Python library for Maple file format operations, with logging and console color utilities
+
 # MapleX
 
 A Python library for Maple file format operations, with logging and console color utilities
@@ -21,7 +22,7 @@ Logger is a versatile logging utility that allows developers to log messages wit
 readme = "README.md"
 license-files = ["LICENSE"]
 authors = [
-    {name = "Ryuji Hazama"}
+    {name = "RyujiHazama"}
 ]
 dependencies = [
     "cryptography>=46.0.3",

maplex-2.2.0a2/README.md → maplex-2.2.0b1/src/MapleX.egg-info/PKG-INFO

@@ -1,3 +1,24 @@
+Metadata-Version: 2.4
+Name: MapleX
+Version: 2.2.0b1
+Summary: A Python library for Maple file format operations, with logging and console color utilities
+Author: RyujiHazama
+Project-URL: PyPI, https://pypi.org/project/MapleX/
+Project-URL: Homepage, https://github.com/Ryuji-Hazama
+Project-URL: Repository, https://github.com/Ryuji-Hazama/MapleTree
+Project-URL: Issues, https://github.com/Ryuji-Hazama/MapleTree/issues
+Project-URL: YouTube, https://www.youtube.com/@ryujihazama
+Project-URL: Instagram, https://www.instagram.com/ryujihazama/
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cryptography>=46.0.3
+Requires-Dist: pydantic>=2.12.5
+Dynamic: license-file
+
 # :maple_leaf: MapleX :deciduous_tree:
 
     MapleX is a tool set for Maple file format operations, with logging and console color utilities for Python applications.
@@ -5,9 +26,18 @@
     ***You can install the package from pip with the following command.***
 
 ```bash
-pip install maplex
+pip install MapleX
 ```
 
+## Table of Contents
+
+> - [Maple File](#maple-file)
+> - [MapleTree Class](#mapletree-class)
+> - [Logger Class](#logger-class)
+> - [Exceptions](#exceptions)
+> - [Console Colors](#console-colors)
+> - [Install MapleX](#install-maplex)
+
 ## Maple File
 
     Maple is a file system that I created when I was a child. It's like a combination of the INI file and the Jason file. I made this format that is easy to read and write for both humans and machines.
@@ -293,6 +323,8 @@ EOF
     If `encrypt=True`, the instance decrypts data when it is read, and encrypts data when it is saved.  
     You need to specify the byte key when you use encryption, and the file must be encrypted.
 
+:warning: **The key must be 32 url-safe base64-encoded bytes**
+
 ```python
 mapleFile = MapleTree("FileName.mpl", encrypt=True, key=key)
 ```
@@ -364,7 +396,32 @@ def saveTagLine(
 |**`willSave`**|\*|Save to file flag|
 |**`headers`**||Target headers|
 
-    `saveTagLine` saves a value with a tag in a header block specified by the parameter.
+    Outdated from `v2.2.0`
+
+### `saveValue()`
+
+    `v2.2.0` or newer
+
+```python
+def saveValue(
+    tag: str,
+    valueString: any,
+    *headers: str,
+    **kwargs
+) -> bool
+```
+
+|Property|Required|Value|
+|--------|--------|-----|
+|**`tag`**|\*|Target tag|
+|**`value`**|\*|Value to save|
+|**`headers`**||Target headers|
+|**`kwargs`**||Keyword arguments|
+
+    `saveValue` saves a value with a tag in a header block specified by the parameter.
+
+- Set `save=True` to save changes to the file.
+  - Default: `save=False`
 
 E.g.:
 
@@ -372,7 +429,7 @@ E.g.:
 from maplex import MapleTree
 
 mapleFile = MapleTree("SampleData.mpl", createBaseFile=True)
-mapleFile.saveTagLine("TAG", "VALUE", True, "FOO")
+mapleFile.saveTagLine("TAG", "VALUE", "FOO", save=True)
 
 ```
 
@@ -388,12 +445,12 @@ EOF
 
 #### Update a Buffer Content
 
-    If `willSave=False`, the buffer content will be updated, but no update on physical file content.
+    If `save=False` (or not specified), the buffer content will be updated, but no update on physical file content.
 
 E.g.:
 
 ```python
-mapleFile.saveTagLine("TAG", "NEW VALUE", False, "FOO")
+mapleFile.saveTagLine("TAG", "NEW VALUE", "FOO")
 ```
 
     This code changes the contents on buffer like:
@@ -418,10 +475,10 @@ EOF
 
 #### Update and Save Changes
 
-    If `willSave=True`, all the changes to the buffer will be saved.
+    If `save=True`, all the changes to the buffer will be saved.
 
 ```python
-mapleFile.saveTagLine("BAR", "ANOTHER VALUE", True, "FOO")
+mapleFile.saveTagLine("BAR", "ANOTHER VALUE", "FOO", save=True)
 ```
 
     This code changes the contents in the file like:
@@ -440,10 +497,10 @@ EOF
     If the block and/or the header(s) specified with the parameters do not exist in the data, the function creates the new header block(s) and the tag and saves the value.
 
 ```python
-mapleFile.saveTagLine("TAZ", "NEW HEADER AND TAG", False, "NEW_HEADER")
+mapleFile.saveTagLine("TAZ", "NEW HEADER AND TAG", "NEW_HEADER")
 ```
 
-    This code will change the data like:
+    This code will change the buffer data like:
 
 ```text
 MAPLE
@@ -457,48 +514,47 @@ E
 EOF
 ```
 
-### `saveValue()`
-
-    `v2.2.0` or newer
+### `deleteTag()`
 
 ```python
-def saveValue(
-    tag: str,
-    valueString: any,
-    *headers: str,
-    **kwargs
+def deleteTag(
+    delTag: str,
+    willSave: bool = False,
+    *headers: str
 ) -> bool
 ```
 
 |Property|Required|Value|
 |--------|--------|-----|
-|**`tag`**|\*|Tag to delete|
-|**`value`**|\*|Value to save|
+|**`delTag`**|\*|Tag to delete|
+|**`willSave`**||Save to file flag|
 |**`headers`**||Target headers|
-|**`kwargs`**||Keyword arguments|
 
-- Same as `saveTagLine()`
-- Set `save=True` to save changes to the file.
-  - Default: `save=False`
+    Outdated from `v2.2.0`
 
-### `deleteTag()`
+### `deleteValue()`
+
+    `v2.2.0` or newer
 
 ```python
-def deleteTag(
+def deleteValue(
     delTag: str,
-    willSave: bool = False,
-    *headers: str
+    *headers: str,
+    **kwargs
 ) -> bool
 ```
 
 |Property|Required|Value|
 |--------|--------|-----|
 |**`delTag`**|\*|Tag to delete|
-|**`willSave`**||Save to file flag|
 |**`headers`**||Target headers|
+|**`kwargs`**||Keyword arguments|
 
     Delete a tag and its value.
 
+- Set `save=True` to save changes to the file.
+  - Default: `save=False`
+
 Sample data: `SampleData.mpl`
 
 ```text
@@ -518,7 +574,7 @@ E.g.:
 from maplex import MapleTree
 
 mapleFile = MapleTree("SampleData.mpl")
-mapleFile.deleteTag("BAR", True, "FOO")
+mapleFile.deleteTag("BAR", "FOO", save=True)
 ```
 
     The file data will be changed like:
@@ -533,28 +589,6 @@ E
 EOF
 ```
 
-### `deleteValue()`
-
-    `v2.2.0` or newer
-
-```python
-def deleteValue(
-    delTag: str,
-    *headers: str,
-    **kwargs
-) -> bool
-```
-
-|Property|Required|Value|
-|--------|--------|-----|
-|**`delTag`**|\*|Tag to delete|
-|**`headers`**||Target headers|
-|**`kwargs`**||Keyword arguments|
-
-- Same as `deleteTag()`
-- Set `save=True` to save changes to the file.
-  - Default: `save=False`
-
 ### `getTagValueDict()`
 
 ```python
@@ -649,8 +683,31 @@ def deleteHeader(
 |**`willSave`**||Save to file flag|
 |**`Headers`**||Target headers|
 
+    Outdated from `v2.2.0`
+
+### `removeHeader()`
+
+    `v2.2.0` or newer
+
+```python
+def removeHeader(
+    delHead: str,
+    *headers: str,
+    **kwargs
+) -> bool
+```
+
+|Property|Required|Value|
+|--------|--------|-----|
+|**`delHead`**|\*|Deleting header|
+|**`headers`**||Target headers|
+|**`kwargs`**||Keyword arguments|
+
     This deletes an entire header block and its associated data, including child blocks.
 
+- Set `save=True` for save data to the file.
+  - Default: `save=False`
+
 Sample data: `SampleData.mpl`
 
 ```text
@@ -675,7 +732,7 @@ E.g.:
 from maplex import MapleTree
 
 mapleTree = MapleTree("SampleData.mpl")
-mapleTree.deleteHeader("FOO", True)
+mapleTree.deleteHeader("FOO", save=True)
 ```
 
     This code changes the data like:
@@ -690,28 +747,6 @@ E
 EOF
 ```
 
-### `removeHeader()`
-
-    `v2.2.0` or newer
-
-```python
-def removeHeader(
-    delHead: str,
-    *headers: str,
-    **kwargs
-) -> bool
-```
-
-|Property|Required|Value|
-|--------|--------|-----|
-|**`delHead`**|\*|Deleting header|
-|**`headers`**||Target headers|
-|**`kwargs`**||Keyword arguments|
-
-- Same as `deleteHeader()`
-- Set `save=True` for save data to the file.
-  - Default: `save=False`
-
 ### `getHeaders()`
 
 ```python
@@ -985,6 +1020,26 @@ E
 EOF
 ```
 
+### `changeEncryptionKey()`
+
+    `v2.2.0` or newer
+
+```python
+def changeEncryptionKey(
+    newKey: bytes,
+    save: bool = False
+    ) -> None
+```
+
+|Property|Required|Value|
+|--------|--------|-----|
+|**`newKey`**|\*|New encryption key|
+|**`save`**||Save to file flag|
+
+    Changing file encryption key. If `save=True`, encrypt the buffer data with new key and save to the file.
+
+:warning: **The key must be 32 url-safe base64-encoded bytes**
+
 ## Logger Class
 
     Logger is a logging object for Python applications. It outputs application logs to log files and to standard output.
@@ -1067,8 +1122,9 @@ def ShowError(
 
 - You can configure log settings with `config.mpl`.
 - If `config.mpl` does not exist, the instance auto-generates the file.
+- Instance uses the parameter values to auto-generate configuration file, or using default value if it was not specified.
 
-Auto-generated `config.mpl`:
+Auto-generated `config.mpl` (parameters not specified):
 
 ```text
 MAPLE
@@ -1115,6 +1171,10 @@ EOF
 
     This occurs when the data is not found in the file.
 
+### `MapleEncryptionNotEnabledException(MapleException)`
+
+    This occurs when try to encrypt maple data, but the encryption flag is `False`.
+
 ### `class MapleHeaderNotFoundException(MapleDataNotFoundException)`
 
     This occurs when the header (specified by the user) is not found in the data.
@@ -1197,12 +1257,12 @@ EOF
 |`Reversed`|\\033\[7m|Reversed colors|
 |`Reset`|\\033\[0m|Reset formatting|
 
-## Install maplex :inbox_tray:
+## Install MapleX
 
 ### From PyPI
 
 ```bash
-[python[3] -m] pip install maplex [--break-system-packages]
+[python[3] -m] pip install MapleX [--break-system-packages]
 ```
 
 ### Manual Installation

{maplex-2.2.0a2 → maplex-2.2.0b1}/src/maplex/__init__.py

@@ -10,6 +10,7 @@ from .mapleExceptions import (
     KeyEmptyException,
     MapleDataNotFoundException,
     MapleException,
+    MapleEncryptionNotEnabledException,
     MapleFileEmptyException,
     MapleFileLockedException,
     MapleFileNotFoundException,
@@ -27,6 +28,7 @@ __all__ = [
     'InvalidMapleFileFormatException',
     'KeyEmptyException',
     'MapleDataNotFoundException',
+    'MapleEncryptionNotEnabledException',
     'MapleException',
     'MapleFileEmptyException',
     'MapleFileLockedException',
@@ -42,6 +44,6 @@ __all__ = [
     'winUnHide'
 ]
 
-__version__ = "2.2.0a2"
+__version__ = "2.2.0b1"
 __author__ = "Ryuji Hazama"
 __license__ = "MIT"

{maplex-2.2.0a2 → maplex-2.2.0b1}/src/maplex/mapleColors.py

@@ -41,6 +41,7 @@ class ConsoleColors(BaseModel):
     # Other formats
 
     Bold: str = "\033[1m"
+    Italic: str = "\033[3m"
     Underline: str = "\033[4m"
     Reversed: str = "\033[7m"
     Reset: str = "\033[0m"

{maplex-2.2.0a2 → maplex-2.2.0b1}/src/maplex/mapleExceptions.py

@@ -54,6 +54,13 @@ class MapleDataNotFoundException(MapleException):
 
         super().__init__(self.message)
 
+class MapleEncryptionNotEnabledException(MapleException):
+
+    def __init__(self, mapleFile: str = "", message: str = "File encryption is not enabled"):
+
+        self.message = f"{message}: {mapleFile}"
+        super().__init__(self.message)
+
 class MapleHeaderNotFoundException(MapleDataNotFoundException):
 
     def __init__(self, fileName = "", header: str = "", preHeader: str = "", message = ""):

{maplex-2.2.0a2 → maplex-2.2.0b1}/src/maplex/mapleLogger.py

@@ -52,15 +52,15 @@ class Logger:
 
                 with open(configFile, "w") as f:
 
-                    f.write("MAPLE\n"
-                            "H *LOG_SETTINGS\n"
-                            "    CMD INFO\n"
-                            "    FLE INFO\n"
-                            "    # TRACE, DEBUG, INFO, WARN,\n"
-                            "    # ERROR, FATAL, NONE\n"
-                            "    MAX 3\n"
-                            "    OUT logs\n"
-                            "E\nEOF")
+                    f.write(f"MAPLE\n"
+                            f"H *LOG_SETTINGS\n"
+                            f"    CMD {cmdLogLevel if cmdLogLevel is not None else 'INFO'}\n"
+                            f"    FLE {fileLogLevel if fileLogLevel is not None else 'INFO'}\n"
+                            f"    # TRACE, DEBUG, INFO, WARN,\n"
+                            f"    # ERROR, FATAL, NONE\n"
+                            f"    MAX {maxLogSize if maxLogSize is not None else 3}\n"
+                            f"    OUT {workingDirectory if workingDirectory is not None else 'logs'}\n"
+                            f"E\nEOF")
                 
             maple = MapleTree(configFile)
 
@@ -225,6 +225,7 @@ class Logger:
         Green = self.consoleColors.Green
         bLightBlue = self.consoleColors.bLightBlue
         Bold = self.consoleColors.Bold
+        Italic = self.consoleColors.Italic
         Reset = self.consoleColors.Reset
 
         try:
@@ -265,7 +266,7 @@ class Logger:
 
                 case self.LogLevel.NONE:
 
-                    col = Bold + Black
+                    col = Bold + Italic + Black
 
                 case _:
 
@@ -406,6 +407,10 @@ ToDo list:
 
 * Logger *
 
+- Create getLogger function
+- Add option to file output mode (append/overwrite/daily)
+- Add option to set date format
+- Add set* functions
 - Configure log format in config file
 
 """

{maplex-2.2.0a2 → maplex-2.2.0b1}/src/maplex/mapleTreeEditor.py

@@ -32,9 +32,9 @@ class MapleTree:
 
                     # Encrypt data
 
-                    mapleBaseString = Fernet(key).encrypt(mapleBaseString.encode()).decode()
+                    mapleBaseString = Fernet(key).encrypt(mapleBaseString.encode())
 
-                with open(fileName, "w") as f:
+                with open(fileName, "wb") as f:
 
                     f.write(mapleBaseString)
 
@@ -44,24 +44,26 @@ class MapleTree:
 
         try:
 
-            with open(fileName, "r") as f:
-
-                if encrypt:
+            if encrypt:
 
+                with open(fileName, "rb") as f:
+                        
                     # Decode encryption
                     
                     fileData = f.read()
-                    fileData = Fernet(key).decrypt(fileData.encode()).decode()
+                    fileData = Fernet(key).decrypt(fileData).decode()
                     self.fileStream = fileData.split("\n")
 
-                    # Add \r at the end of each line
+                    # Add \n at the end of each line
 
                     for i, fileLine in enumerate(self.fileStream):
 
                         self.fileStream[i] = f"{fileLine}\n"
 
-                else:
-                        
+            else:
+
+                with open(fileName, "r") as f:
+                
                     self.fileStream = f.readlines()
 
             # If the file is empty
@@ -117,18 +119,39 @@ class MapleTree:
     ##############################
     # Read file
 
+    #
+    ##############################
+    # Change encryption key
+
+    def changeEncryptionKey(self, newKey: bytes, save: bool = False) -> None:
+
+        """
+        Change encryption key to newKey.
+        If save is True, overwrite the file with new encryption.
+        """
+
+        if not self.ENCRYPT:
+
+            raise mExc.MapleEncryptionNotEnabledException(self.fileName)
+
+        self.KEY = newKey
+
+        if save:
+
+            self._saveToFile()
+
     #
     ##############################
     # Encrypt data
 
-    def __encryptData(self) -> str:
+    def __encryptData(self) -> bytes:
 
         """
         Return encrypted base_64 string
         """
 
         fileData = "".join(self.fileStream).encode()
-        fileData = Fernet(self.KEY).encrypt(fileData).decode()
+        fileData = Fernet(self.KEY).encrypt(fileData)
 
         return fileData
 
@@ -149,15 +172,21 @@ class MapleTree:
 
                 fileData = self.__encryptData()
 
+                # Save to file
+
+                with open(self.fileName, "wb") as f:
+
+                    f.write(fileData)
+
             else:
 
                 fileData = "".join(self.fileStream)
 
-            # Save to file
+                # Save to file
 
-            with open(self.fileName, "w") as f:
+                with open(self.fileName, "w") as f:
 
-                f.writelines(fileData)
+                    f.writelines(fileData)
 
         except Exception as e:
 
@@ -1117,5 +1146,11 @@ ToDo list:
 
 * MapleTree *
 
+- In changeEncryptionKey, if encrypt is False, force to encrypt the file with new key.
+- In changeEncryptionKey, if newKey is None, save file without encryption.
+    - Add parameter to control this behavior. (changeEncryptionState: bool = False)
+- Add auto-generate key function.
+    - Add function to get current key.
+
 """
 """ * * * * * * * * * * * * * """