example_test.go

package oper_test

import (
	"fmt"
	"strings"

	"oper"
)

// ExampleIn 演示 oper.In 元素包含检查。
func ExampleIn() {
	list := []int{1, 2, 3, 4, 5}
	fmt.Println(oper.In(list, 3))
	fmt.Println(oper.In(list, 99))
	// Output:
	// true
	// false
}

// ExampleFilter 演示 oper.Filter 过滤函数。
func ExampleFilter() {
	evens := oper.Filter([]int{1, 2, 3, 4, 5, 6}, func(n int) bool {
		return n%2 == 0
	})
	fmt.Println(evens)
	// Output: [2 4 6]
}

// ExampleMap 演示 oper.Map 映射函数。
func ExampleMap() {
	doubled := oper.Map([]int{1, 2, 3}, func(n int) int {
		return n * 2
	})
	fmt.Println(doubled)
	// Output: [2 4 6]
}

// ExampleChunk 演示 oper.Chunk 分块。
func ExampleChunk() {
	chunks := oper.Chunk([]int{1, 2, 3, 4, 5, 6, 7}, 3)
	fmt.Println(chunks)
	// Output: [[1 2 3] [4 5 6] [7]]
}

// ExampleGroupBy 演示 oper.GroupBy 分组。
func ExampleGroupBy() {
	// 用 role 字符串作为 key 分组
	roles := []string{"admin", "user", "admin", "user", "guest"}
	byRole := oper.GroupBy(roles, func(r string) string { return r })
	fmt.Println("admin:", byRole["admin"])
	fmt.Println("user:", byRole["user"])
	// Output:
	// admin: [admin admin]
	// user: [user user]
}

// ExampleChunk_realtime 演示按 size 分块。
func ExampleChunk_size() {
	for _, batch := range oper.Chunk([]int{1, 2, 3, 4, 5, 6, 7}, 3) {
		fmt.Println(batch)
	}
	// Output:
	// [1 2 3]
	// [4 5 6]
	// [7]
}

// ExampleUniqBy 演示按 key 去重。
func ExampleUniqBy() {
	// 演示用整型切片（List 约束只支持基础类型）
	values := oper.UniqBy([]int{1, 2, 2, 3, 3, 3, 4}, func(n int) int { return n })
	fmt.Println(values)
	// Output: [1 2 3 4]
}

// ExampleSum 演示求和。
func ExampleSum() {
	total := oper.Sum([]int{1, 2, 3, 4, 5})
	fmt.Println(total)
	// Output: 15
}

// ExampleCamelCase 演示字符串转驼峰。
func ExampleCamelCase() {
	fmt.Println(oper.CamelCase("hello_world"))
	fmt.Println(oper.CamelCase("user-profile"))
	// Output:
	// helloWorld
	// userProfile
}

// ExampleGet 演示从 map 嵌套取值。
func ExampleGet() {
	data := map[string]interface{}{
		"user": map[string]interface{}{
			"name": "alice",
			"addr": map[string]interface{}{
				"city": "Xiamen",
			},
		},
	}
	city := oper.Get(data, "user.addr.city", "unknown")
	fmt.Println(city)
	// Output: Xiamen
}

// ExampleIn_string 演示字符串切片包含检查。
func ExampleIn_string() {
	roles := []string{"admin", "user", "guest"}
	fmt.Println(oper.In(roles, "admin"))
	fmt.Println(oper.In(roles, "root"))
	// Output:
	// true
	// false
}

// ExampleChunk_strings 演示字符串分块（用于批量处理）。
func ExampleChunk_strings() {
	urls := []string{
		"https://a.com/1", "https://a.com/2", "https://a.com/3",
		"https://a.com/4", "https://a.com/5",
	}
	batches := oper.Chunk(urls, 2)
	for i, batch := range batches {
		fmt.Printf("batch %d: %s\n", i, strings.Join(batch, ", "))
	}
	// Output:
	// batch 0: https://a.com/1, https://a.com/2
	// batch 1: https://a.com/3, https://a.com/4
	// batch 2: https://a.com/5
}