astfy

Create a Python-based code formatter and beautifier tool called 'AstfyFormatter' that leverages the 'astfy' library to parse, analyze, and format Python code snippets. This tool will not only enhance the readability of the code but also ensure it adheres to specific formatting rules defined by the user or default settings. Here’s a detailed outline of the project:

1. **Project Setup**: Start by setting up a new Python virtual environment and installing necessary packages including 'astfy'. Ensure your project structure is well-organized with clear separation between source code, tests, and configuration files.

2. **Code Parsing**: Use 'astfy' to parse Python code into an Abstract Syntax Tree (AST). This step is crucial as it allows you to analyze the structure of the code without executing it.

3. **Formatting Rules Definition**: Define a set of customizable formatting rules that the user can adjust. These rules could include indentation levels, line length limits, spaces vs. tabs, and more. Users should be able to either use predefined styles or define their own.

4. **Code Analysis**: Implement functions that analyze the AST to identify areas where the code does not meet the specified formatting rules. For example, check if there are lines exceeding the maximum allowed length, inconsistent indentation, etc.

5. **Code Beautification**: Develop algorithms that traverse the AST and apply the formatting rules to the code. This involves modifying the code structure while ensuring the semantic meaning remains unchanged.

6. **User Interface**: Create a simple command-line interface (CLI) that allows users to input their code directly or specify a file path. The CLI should also allow users to select from predefined formatting styles or customize their own.

7. **Testing and Validation**: Write comprehensive unit tests to validate the functionality of your code formatter. Test various edge cases, including very large codebases, code with syntax errors, and code that already meets the formatting standards.

8. **Documentation**: Provide clear documentation on how to install and use AstfyFormatter, including examples and best practices for customizing formatting rules.

9. **Optimization and Performance**: Focus on optimizing the performance of your code formatter, especially when dealing with large codebases. Consider implementing caching mechanisms for frequently accessed AST nodes.

Throughout the development process, leverage 'astfy' to handle the parsing and analysis of Python code, ensuring that your tool is both powerful and flexible.