parallelsgo: A Go repository from sunqirui1987

#并行执行 GO函数
Package parallelsgo provides synchronization, error propagation, and Context
parallelsgo 包为一组子任务的 goroutine 提供了 goroutine 同步,错误取消功能.

parallelsgo 包含三种常用方式

1、直接使用 此时不会因为一个任务失败导致所有任务被 cancel:
		g := &parallelsgo.Parallels{}
		g.Go(func(ctx context.Context, args interface{}) {
			// NOTE: 此时 ctx 为 context.Background()
			// do something
		},nil)

2、WithContext 使用 WithContext 时不会因为一个任务失败导致所有任务被 cancel:
		g := parallelsgo.WithContext(ctx)
		g.Go(func(ctx context.Context, args interface{}) {
			// NOTE: 此时 ctx 为 parallelsgo.WithContext 传递的 ctx
			// do something
		},nil)

3、WithCancel 使用 WithCancel 时如果有一个人任务失败会导致所有*未进行或进行中*的任务被 cancel:
		g := parallelsgo.WithCancel(ctx)
		g.Go(func(ctx context.Context, args interface{}) {
			// NOTE: 此时 ctx 是从 parallelsgo.WithContext 传递的 ctx 派生出的 ctx
			// do something
		},nil)

设置最大并行数 GOMAXPROCS 对以上三种使用方式均起效
NOTE: 由于 parallelsgo 实现问题,设定 GOMAXPROCS 的 parallelsgo 需要立即调用 Wait() 例如:

		g := parallelsgo.WithCancel(ctx)
		g.GOMAXPROCS(2)
		// task1
		g.Go(func(ctx context.Context, args interface{}) {
			fmt.Println("%v", args)
		},"task1")

		// task2
		g.Go(func(ctx context.Context, args interface{}) {
			fmt.Println("%v", args)
		},"task2")

		// task3
		g.Go(func(ctx context.Context, args interface{}) {
			fmt.Println("%v", args)
		},"task3")
		
		// NOTE: 此时设置的 GOMAXPROCS 为2, 添加了三个任务 task1, task2, task3 此时 task3 是不会运行的!
		// 只有调用了 Wait task3 才有运行的机会
		g.Wait() // task3 运行
sunqirui1987/parallelsgo
