cute 0.1.1

A macro for Python-esque comprehensions
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

# Cute

[![Build Status](https://travis-ci.org/mattgathu/cute.svg?branch=master)](https://travis-ci.org/mattgathu/cute)

Macro for Python-esque list comprehensions in Rust.

 The `c!` macro implements list comprehensions similar to those found in Python,
 allowing for conditionals and nested comprehensions.

 # Python Syntax

 ```python
 squares = [x*x for x in range(10)]

 even_squares = [x*x for x in range(10) if x % 2 == 0]
 ```

 # c! Syntax

 ```rust
 let squares = c![x*x, for x in 0..10];

 let even_squares = c![x*x, for x in 0..10, if x % 2 == 0];

 ```

 Note `c!`'s has the comprehension's parts, comma-separated.

 # Examples

 Simpe comprehension

 ```rust
 #[macro_use(c)]
 extern crate cute;

 let v = [1,2,3,4];
 let v_squared = c![x*x, for x in v];

 ```
 Conditional filtering

 ```rust
 let squares = c![x*x, for x in 0..10, if x % 2 == 0];
 assert_eq!(squares, vec![0, 4, 16, 36, 64]);
 ```
 
 Nested Comprehensions

 ```rust
 let nested = vec![vec![1,2,3], vec![4,5,6], vec![7,8,9]];
 let flat: Vec<usize> = c![x, for x in y, for y in nested];
 assert_eq!(flat, vec![1, 2, 3, 4, 5, 6, 7, 8, 9]);
 ``` 
 
 ```rust
 let nested = vec![vec![1,2,3], vec![4,5,6], vec![7,8,9]];
 let even_flat: Vec<usize> = c![x, for x in y, for y in nested, if x % 2 == 0];
 assert_eq!(even_flat, vec![2, 4, 6, 8]);
 ```

 Comprehensions over Iterators

 ```rust
 let vec: Vec<i32> = vec![-4, -2, 0, 2, 4];
 let output: Vec<i32> = c![x*2, for x in vec.iter()];
 assert_eq!(output, vec![-8, -4, 0, 4, 8]);
 ``` 
 
 ```rust
 let vec: Vec<i32> = vec![-4, -2, 0, 2, 4];
 let output: Vec<i32> = c![x, for x in vec.iter(), if *x >= 0i32];
 assert_eq!(output, vec![0, 2, 4]);
 ``` 
 
 Function Application

 ```rust
 let vec: Vec<i32> = vec![-4, -2, 0, 2, 4];
 let output: Vec<i32> = c![x.abs(), for x in vec.iter()];
 assert_eq!(output, vec![4, 2, 0, 2, 4]);
 ```

 ```rust
 fn square(x:i32) -> i32 {
        x*x
 }
       
 let vec: Vec<i32> = vec![-4, -2, 0, 2, 4];
 let squares: Vec<i32> = c![square(x), for x in vec];
 assert_eq!(squares, vec![16, 4, 0, 4, 16]);
 ```