Improvements
- **Version Check**: Implemented a function to check for updates to the FileSystemPro library.
- **Update Notification**: Added a notification system to alert users of new releases.
- **Installation Instructions**: Provided clear instructions for updating the library using pip.
This update enhances the user experience by ensuring they are always working with the latest version of the library, with easy-to-follow steps for upgrading.
Console
Console is a robust library designed to enable ANSI escape character sequences, which are used for generating coloured terminal text and cursor positioning. This library is a key addition to FileSystemPro as a third-party library, enhancing the toolkit for developers who require consistent terminal styling across different operating systems.
from filesystem import console
- **ANSI Escape Sequences**: Integrated the open source library **Colorama** to enhance the Console with ANSI escape character sequences, enabling coloured terminal text and cursor positioning
- **Cross-Platform Compatibility**: Ensured that the new Console implementation works seamlessly across different platforms, including Windows, by utilizing Colorama's functionality to strip ANSI sequences and convert them into appropriate win32 calls.
- **Simplified API**: Provided a simple cross-platform API for printing coloured terminal text from Python, making it easier for developers to create visually appealing console output
- **Enhanced Output**: Improved the visual output of the Console by supporting various formatting constants like **foreground**, **background**, and **style**, allowing for a more customised and readable display.
- **Simplified Integration:** With no dependencies other than the standard library, integrating Console into your projects is straightforward. It’s tested across multiple Python versions, ensuring reliability.
- **Effortless Transition:** For developers transitioning to FileSystemPro, incorporating Console into your workflow is effortless, enabling you to maintain the visual aspects of your terminal applications without platform constraints.
This update brings a significant enhancement to the Console's capabilities, offering a more robust and user-friendly experience for FileSystemPro users.
Documentation (README)
- **Enhanced Documentation**: Introduced a **clear and structured table** that lists all methods with corresponding explanations, improving the readability and accessibility of the documentation.
- **Method Overview**: Provided a **concise summary** for each method, allowing users to quickly understand the purpose and usage of the FileSystemPro toolkit functions.
- **User-Friendly Format**: Adopted a **tabular format** to organize the method information, which enhances the user experience by making it easier to navigate through the documentation.
- **Improved Clarity**: The table format helps to **distinguish between different methods** and their descriptions, ensuring that users can find the information they need without confusion.
This update aims to make the FileSystemPro documentation more user-friendly and informative, aiding developers in utilising the toolkit more effectively.
Changes
Wrapper
- **wrapper.delete:** (`def delete(path, recursive=False):`)
- **Enhanced Error Handling:** Changed behavior for non-existent directory operations. The system now raises an Exception instead of printing an error message, providing a more robust error handling mechanism.
- **Strict Directory Deletion Policy:** Modified the response to attempts at deleting non-empty directories. The library will now raise an Exception to enforce the use of the recursive parameter when necessary, ensuring safer file operations.
---
Developer Notes
These updates require developers to handle exceptions in their code where FileSystemPro functions are utilized.
Ensure that proper try-except blocks are implemented to maintain the application’s stability.
Update any relevant documentation to guide users through the new error handling process.
---
Let's continue to work together to improve FileSystem Pro!
Bisneto.