Log Parsing Manager for Mod Organizer 2 Version: 1.1.2
Author: Hymlock
DescriptionLog Parsing Manager is a plugin for Mod Organizer 2 that automatically parses Skyrim crash reports and provides insights to help prevent future crashes. This tool offers advanced error extraction and analysis, making it easier to identify and resolve issues within your game logs.
FeaturesAdvanced Parsing Methods:

• Default Parsing: Uses an advanced error extraction method to normalize and group similar error messages.
• Parse by Specific Keyword: Allows you to search for specific keywords within your logs.
• Regex Match: Enables the use of regular expressions to match and extract specific log lines.
  

Enhanced Parsing Results Screen:

• Sorting Options:
  • Frequency (High to Low)
  • Frequency (Low to High)
  • String Length (Long to Short)
  • String Length (Short to Long)
  • Alphabetically (A-Z)
  • Alphabetically (Z-A)
    
• Search Functionality: Filter parsing results by entering specific text in the search box.
  

Parsing Instance Management:

• Create Parsing Instances: Monitor specific log files or patterns.
• Manage and Organize: Sort your parsing instances with various options.
• Parsing Options:
  • Parse logs using different methods.
  • Export statistics and logs.
  • View the latest log.
  • Rename or remove parsing instances.
    
  
  

Auto Parsing:

• Auto Parsing Add: Automatically add parsing instances for each unique log file type in a selected folder.
• Auto Parsing Update: Update existing parsing instances based on new or modified log files.
  

Multi-language Support:

• Available in English, Spanish, and Chinese.
• Select your preferred language within the plugin settings.
• All UI elements, messages, and dialogs support dynamic translation.
  

Export Features:

• Export Parsing Results: Export parsing results and statistics to a file for further analysis.
• Export Parsing Instances: Export the list of parsing instances for record-keeping or sharing.
  

User-Friendly Interface:

• Intuitive UI: Tooltips and labels for ease of use.
• Help and About Sections: Detailed information and guidance.
  

Requirements

• Mod Organizer 2 installed with PyQt6. (Latest MO2)
• Python 3 (as required by MO2 for plugins).
  

InstallationDownload the Latest Release:

• Obtain the plugin from the Nexus Mods page.
  

Extract Files:

• Extract the contents of the archive.
  

Copy Files to MO2 Plugins Directory:

• Navigate to your Mod Organizer 2 installation directory.
• Copy the LogParsingManager folder into the plugins directory.
  

markdown
Copy code
ModOrganizer2/
└── plugins/
└── LogParsingManager/       
├── LogParsing_plugin.py
├── language_support.py
├── __init__.py
└── resources/
├── folder_icon.png
├── file_icon.png
├── plugin_icon.png
└── ... (other resources)

Restart Mod Organizer 2:

• If MO2 is running, restart it to load the new plugin.
  

UsageCreating a Parsing InstanceOpen Log Parsing Manager:

• In MO2, go to the Tools menu and select Log Parsing Manager.
  

Create Parsing Instance:

• Click on Start Parsing.
  

Select File to Parse:

• Choose the log file you wish to parse.
  

Enter Parsing Instance Name:

• Provide a friendly name for the parsing instance.
  

Enter File Matching Pattern (Optional):

• Enter a regex pattern to match files (optional).
  

Confirm Creation:

• Confirm to create the parsing instance.
  

Managing ParsingsOpen Manage Parsings:

• In the Log Parsing Manager, click on Manage Parsings.
  

View Parsings:

• View all your tracked parsing instances in the list.
  

Sort Parsings:

• Use the Sort dropdown to organize your parsing instances.
  

Parsing Options:

• Click on a parsing instance to open options:
  • Parse Me
  • Export Statistics
  • Export Last Log
  • View Latest Log
  • Rename Parsing
    
  
  

Remove Parsings:

• Click the X button next to a parsing instance to remove it.
  

Parsing LogsSelect Parsing Method:

• When you click Parse Me, a dialog will appear to select the parsing method:
  • Default Parsing
  • Parse by Specific Keyword
  • Regex Match
    
  
  

Enter Keyword or Regex Pattern:

• If you choose Parse by Specific Keyword or Regex Match, you'll be prompted to enter the keyword or regex pattern.
• The plugin validates your input and provides error messages if invalid.
  

View Parsing Results:

• The parsing results will be displayed with sorting and search options.
  

Using the Parsing Results ScreenSorting Options:

• Select how to sort the results from the dropdown menu.
  

Search Box:

• Enter text in the search box to filter the results.
  

Result Details:

• View the occurrences and details of each error or log line.
• Click on an error to see associated sentences and paragraphs.
  

Auto ParsingAccess Auto Parsing Options:

• Open Log Parsing Manager and click on Auto Parsing.
  

Auto Parsing Add:

• Automatically add parsing instances for unique log file types in a selected folder.
  

Auto Parsing Update:

• Update existing parsing instances based on new or modified log files.
  

Exporting Parsing DataExport Parsing List:

• In the Log Parsing Manager, go to File > Export Parsing List.
• Choose the sorting order and save the file.
  

Export Statistics:

• Export parsing statistics for a specific parsing instance.
  

Export Last Log:

• Export the most recent log file associated with a parsing instance.
  

TroubleshootingParsing Method IssuesProblem:

• Parsing method selection "Parse by Specific Keyword" or "Regex Match" does not function.
  

Solution:

• Ensure you enter a valid keyword or regex pattern.
• If the pattern is invalid, the plugin will display an error message and provide examples.
• Update to the latest version of the plugin where this issue has been fixed.
  

No Logs FoundProblem:

• No logs are found when attempting to parse.
  

Solution:

• Verify that the log files exist in the specified directory.
• Ensure that the file matching pattern correctly matches your log files.
  

Parsing Instances DisappearProblem:

• Parsing instances disappear after using the "Parse Me" function.
  

Solution:

• Update to Version 1.1.2 where this issue has been fixed.
• The plugin now properly saves parsing instances after parsing logs.
  

Plugin Not Showing in MO2Verify Installation:

• Ensure that the LogParsing_plugin.py file and resources folder are correctly placed in the plugins directory.
  

Compatibility:

• Ensure you're using a compatible version of MO2 and have Python 3 installed.
  

Changelog Version History
Changelog - Version 1.1.2 Improvements:

• Resolved Slowdown Issues:
  Optimized data storage and retrieval mechanisms to enhance performance. Parsing operations, including searching and sorting, now execute more efficiently, particularly for large log files or numerous parsing instances.

Version 1.1.1Bug Fixes:

• Critical Fix: Resolved an issue where parsing instances would disappear after using the "Parse Me" function.
  • Cause: Incompatibility with JSON serialization due to the use of non-serializable data structures (e.g., sets).
  • Solution: Modified the data structures to ensure all are JSON-serializable, preventing data loss.
    
• Stability Improvements:
  • Enhanced error handling during parsing and saving processes.
  • Fixed potential crashes related to file I/O operations.
    
  
  

Summary of Changes in Version 1.1.1:The Version 1.1.1 update addresses a critical issue affecting the persistence of parsing instances after parsing logs. By ensuring compatibility with JSON serialization, the plugin now reliably saves and reloads all parsing instances, maintaining user configurations. Additional stability improvements enhance the overall reliability of the plugin, ensuring a smoother and more dependable user experience.
Version 1.1.0Added Features:

• Additional Sorting Options in Parsing Results:
  • Users can now sort parsing results by frequency, string length, or alphabetically in both ascending and descending orders.
    
• Search Functionality in Parsing Results:
  • Added a search box in the parsing results screen to filter results based on user input.
    
• Parsing Method Selection:
  • Upon clicking Parse Me, users can select the parsing method:
    • Default Parsing
    • Parse by Specific Keyword
    • Regex Match
      
    
    
• Improved Error Handling:
  • The plugin now handles invalid inputs more gracefully.
  • Provides informative error messages if the keyword or regex pattern is invalid.
    
  
  

Bug Fixes:

• Fixed an issue where selecting "Parse by Specific Keyword" or "Regex Match" would cause the plugin to repeatedly prompt for input.
• Resolved crashes related to invalid regex patterns.
  

Summary of Changes in Version 1.1.0:The introduction of enhanced parsing methods, additional sorting options, and search functionality in Version 1.1.0 significantly improves the utility and user-friendliness of the Log Parsing Manager Plugin. These features provide users with greater control over log analysis, making it easier to identify and resolve issues within their game logs. The improvements in error handling and the resolution of known bugs further enhance the reliability and effectiveness of the plugin.
Version 1.0.0Initial Release:

• Automatically parse Skyrim crash reports.
• Create and manage parsing instances.
• View and export parsing results.
• Multi-language support for English, Spanish, and Chinese.
  

LicenseThis plugin is released under the Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International (CC BY-NC-ND 4.0) license.
Attribution:

• You must give appropriate credit to the original author.
  

Non-Commercial:

• You may not use the material for commercial purposes.
  

No Derivatives:

• If you remix, transform, or build upon the material, you may not distribute the modified material.
  

No Additional Restrictions:

• You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits.
  

For more details, please refer to the CC BY-NC-ND 4.0 License.
DisclaimerThe Log Parsing Manager for Mod Organizer 2 is provided "as is" without any warranties, express or implied. Hymlock (the author) does not warrant that the plugin will meet your requirements, operate without interruption, or be error-free. In no event shall Hymlock be liable for any damages, including but not limited to loss of data, loss of profits, or any other direct, indirect, incidental, or consequential damages arising out of the use or inability to use this plugin, even if Hymlock has been advised of the possibility of such damages.
By using this plugin, you acknowledge and accept that you are using it at your own risk, and you agree to indemnify and hold harmless the author from any claims, damages, or expenses arising from your use of the plugin.
PermissionsAsset Use:

• You may not use the assets or code in this plugin without explicit permission from the author.
  

Distribution:

• You may not redistribute this plugin or include it in mod packs without permission.
  

Translations:

• Translations are allowed, but please contact the author before distributing.
  

ContactIf you have any questions, issues, or suggestions, please contact Hymlock via the Nexus Mods messaging system.
Summary of Changes in Version 1.1.1:The Version 1.1.1 update is a critical maintenance release that fixes a major bug impacting the user experience. Previously, users encountered an issue where parsing instances would disappear after using the "Parse Me" function. This was traced back to incompatibilities with JSON serialization when saving certain data structures. The bug has been thoroughly addressed by modifying the internal data handling to ensure all data structures are compatible with JSON serialization.
Key Benefits:

• Data Integrity: Parsing instances are now reliably saved and persist across sessions, ensuring that users do not lose their configurations.
• Enhanced Stability: Improved error handling reduces the likelihood of crashes and unexpected behavior during parsing and data saving operations.
• User Confidence: By resolving this critical issue, users can trust the plugin to function as intended, allowing them to focus on analyzing their game logs without technical distractions.
  

This update underscores the commitment to maintaining the plugin's reliability and underscores the importance of user feedback in improving the tool.