ppf/CRUSH.md

CRUSH.md for /home/user/git/ppf

Project Overview

This is a Python 2.7 project focused on proxy fetching and management. Code MUST be Python 2 exclusive, optimized for low-end hardware, using only standard library modules. No external libraries allowed.

Build/Lint/Test Commands

• Build: No formal build process; run scripts directly with python script.py.
• Lint: Use built-in tools or manual checks (e.g., PEP8 compliance via code review). No external linters like pylint due to restrictions.
• Test: Use python -m unittest discover for running all tests (if tests exist). For single test: python -m unittest test_module.TestClass.test_method.
• Note: Currently no test files in repo; add using unittest module as per guidelines.
• Typecheck: Python 2 has no static typing; rely on runtime checks.

Code Style Guidelines

• PEP8 Adapted: 79-char lines, 4-space indentation, descriptive names. Use Python 2 syntax (e.g., print statement, xrange).
• Imports: Standard library only (e.g., os, sys, threading). Import from local modules as needed (e.g., from config import Config).
• Formatting: Consistent spacing, no trailing whitespace. Use with statements for resources.
• Types: Dynamic typing; add type hints in comments if clarifying (e.g., # param: str).
• Naming Conventions: Snake_case for variables/functions, CamelCase for classes. Descriptive, e.g., process_user_input.
• Error Handling: try/except with specific exceptions (e.g., except IOError). Use logging module, avoid print for errors.
• Threading: Use threading module, avoid time.sleep; use Event/Lock/Queue. Limit to 2-4 threads.
• Memory Optimization: Use generators (xrange), iterative approaches, stream data in chunks.
• Security: Validate inputs, manual checks for vulnerabilities (EOL Python 2.7).
• Comments/Docstrings: Comprehensive docstrings for functions/classes. Inline comments for complex sections.

Copilot Rules Integration

Follow .github/copilot-instructions.md strictly: Python 2 exclusivity, low-end optimization, no external libs, multi-threading efficiency with GIL awareness.

Additional Notes

• Testing Emphasis: Focus on threading and memory in unit tests.
• Maintenance: Track community patches for Python 2.7 security.

(24 lines)