diff options
Diffstat (limited to 'awk/rawk/tests/real_world/README.md')
-rw-r--r-- | awk/rawk/tests/real_world/README.md | 130 |
1 files changed, 0 insertions, 130 deletions
diff --git a/awk/rawk/tests/real_world/README.md b/awk/rawk/tests/real_world/README.md deleted file mode 100644 index c4ba349..0000000 --- a/awk/rawk/tests/real_world/README.md +++ /dev/null @@ -1,130 +0,0 @@ -# Real-World Examples - -This directory contains practical examples that demonstrate rawk's utility for common data processing tasks. - -## Test Files - -### `test_system_monitor.rawk` - System Monitoring -Processes output from common system commands: -- **df**: Disk usage monitoring with warnings -- **ps**: Process resource analysis -- **ls -l**: File categorization and statistics - -**Features:** -- Disk usage alerts (WARNING/CRITICAL thresholds) -- Process resource monitoring (CPU/MEM usage) -- File type categorization (DIRECTORY/EXECUTABLE/LARGE/SMALL) -- Statistical summaries - -**Run with:** -```bash -awk -f ../../rawk.awk test_system_monitor.rawk | awk -f - ../data/test_data.txt -``` - -**Sample Output:** -``` -DISK: WARNING: /dev/sdb1 (/home) is 90% full -PROCESS: HIGH CPU: stress (PID: 3456, 25.7% CPU) -FILE: EXECUTABLE: executable.sh (2048 bytes) -``` - -### `test_log_parser.rawk` - Log Parsing -Processes common log formats: -- **Apache logs**: Web server access logs -- **Syslog**: System log entries - -**Features:** -- HTTP status code categorization (SUCCESS/ERROR/REDIRECT) -- Log level detection (INFO/WARNING/ERROR) -- Request type classification -- Error rate calculation - -**Run with:** -```bash -awk -f ../../rawk.awk test_log_parser.rawk | awk -f - ../data/test_logs.txt -``` - -**Sample Output:** -``` -APACHE: ERROR: 404 - GET /nonexistent.html from 192.168.1.104 -SYSLOG: ERROR: kernel - ERROR: Out of memory -``` - -### `test_csv_processor.rawk` - CSV Data Processing -Processes CSV files with validation: -- **Email validation**: Basic email format checking -- **Age categorization**: Group employees by age -- **Salary statistics**: Calculate averages and ranges -- **Department analysis**: Employee distribution - -**Features:** -- Data validation and categorization -- Statistical analysis -- Report generation -- Error detection - -**Run with:** -```bash -awk -f ../../rawk.awk test_csv_processor.rawk | awk -f - ../data/test_employees.csv -``` - -**Sample Output:** -``` -EMPLOYEE: John Smith (ADULT, Engineering) - VALID email, $65000 -Average salary: $73916.7 -Email validity rate: 100% -``` - -### `test_data_processing.rawk` - General Data Processing -General data processing scenarios: -- Array filtering and manipulation -- Data aggregation -- Formatting and reporting - -**Run with:** -```bash -awk -f ../../rawk.awk test_data_processing.rawk | awk -f - -``` - -### `test_mixed.rawk` - Mixed awk/rawk Code -Demonstrates mixing rawk functions with regular awk code: -- Line-by-line processing -- Integration with awk patterns -- Combined functionality - -**Run with:** -```bash -awk -f ../../rawk.awk test_mixed.rawk | awk -f - ../data/test_input.txt -``` - -## Use Cases - -These examples demonstrate rawk's practical applications: - -### System Administration -- Monitor disk usage and alert on thresholds -- Track process resource consumption -- Analyze file system contents - -### Web Server Management -- Parse and analyze web server logs -- Monitor error rates and traffic patterns -- Identify problematic requests - -### Data Analysis -- Process CSV files with validation -- Generate business intelligence reports -- Analyze employee or customer data - -### Log Analysis -- Parse various log formats -- Identify system issues -- Generate operational reports - -## Data Files - -The examples use sample data files in the `../data/` directory: -- `test_data.txt`: Simulated system command outputs -- `test_logs.txt`: Sample Apache and syslog entries -- `test_employees.csv`: Sample employee data -- `test_input.txt`: Simple input data for mixed tests \ No newline at end of file |