kolpa API速查手册30生成函数的用法与示例大全【免费下载链接】kolpaA fake data generator written in and for Go项目地址: https://gitcode.com/gh_mirrors/ko/kolpa如果你正在为 Go 项目编写单元测试、Demo 演示或数据库灌数据一定为造数据头疼过。kolpa就是一个用 Go 编写、专为 Go 开发者设计的假数据生成库fake data generator它提供了 30 多个开箱即用的生成函数覆盖姓名、地址、电话、邮箱、支付卡、时间、Lorem 文本、颜色与 User Agent 等常用场景。本文是一份完整的 kolpa API 速查手册带你快速掌握每个生成函数的用法与示例输出。一、kolpa 是什么为什么用它kolpa 的核心思路非常简单一行代码生成一条真实感十足的数据。它的数据源存放在data/目录下按语言与类型分文件组织如data/en_US/person_first_name_male、data/zh_CN/phone等并通过统一的GenericGenerator引擎随机抽取、组合。相比手写一堆随机逻辑kolpa 的优点是✅ 开箱即用无需额外配置✅ 支持多语言en_US、zh_CN、tr_TR、pl_PL、pt_BR 等✅ 生成的假数据格式贴近真实适合测试场景✅ 零第三方依赖安装即用快速安装 kolpa如果你需要 clone 仓库本地体验可执行git clone https://gitcode.com/gh_mirrors/ko/kolpa作为 Go 依赖引入时只需在你的项目中导入 kolpa 包然后调用初始化函数即可。二、kolpa 初始化与基础 API 用法所有生成函数的入口都是Generator对象通过C()创建定义见kolpa.go。默认语言为en_US也支持传入语言代码。k : kolpa.C() // 默认 en_US k2 : kolpa.C(zh_CN) // 指定中文 k2.SetLanguage(tr_TR) // 随时切换语言基础 API 一览源码见kolpa.go函数作用示例C(locale...)初始化生成器kolpa.C(en_US)SetLanguage(locale)运行时切换语言k.SetLanguage(zh_CN)GenericGenerator(slug)通用生成入口k.GenericGenerator(person_name)其中GenericGenerator是引擎核心几乎所有便捷函数如Name()、Address()都是对它的封装支持{{token}}模板替换与函数调用详见kolpa.go中的实现。三、人名生成函数16 个速查人名相关函数全部定义在person.go中覆盖全名、性别化姓名、称谓与后缀。k.Name() // John Doe k.FirstName() // Jane k.LastName() // Doe k.Gender() // male / female长尾关键词kolpa 姓名生成函数清单函数输出示例Name()/NameMale()/NameFemale()John Doe / 男性/女性全名FirstName()/FirstNameMale()/FirstNameFemale()Jane / 男性/女性名LastName()/LastNameMale()/LastNameFemale()Doe / 男性/女性姓Prefix()/PrefixMale()/PrefixFemale()Dr. / Mr. / Ms.Suffix()/SuffixMale()/SuffixFemale()PhD. / Jr. / MD.Gender()male / female四、地址生成函数16 个速查地址系列函数集中在address.go从门牌号到军事地址一应俱全。k.Address() // 52185 Katelyn Court Suite 559, Romanstad, AZ 80645 k.StreetAddress() // 98191 Miranda Knoll k.City() // 城市名 k.Postcode() // 17073函数说明Address()/StreetAddress()/StreetName()/StreetSuffix()完整地址 / 街道地址 / 路名 / 路后缀BuildingNumber()/SecondaryAddress()楼号 / 公寓号City()/CityPrefix()/CitySuffix()城市 / 前缀 / 后缀State()/StateAbbr()州名 / 州缩写Postcode()邮编MilitaryAPO()/MilitaryDPO()军用 APO / DPO 地址MilitaryShipPrefix()/MilitaryStateAbbr()舰船前缀 / 军用州缩写五、联系方式与支付卡生成函数邮箱生成email.gok.Email() // Jay.Haydenfakemail.com k.EmailMale() // 男性风格邮箱 k.EmailFemale() // Alice.Haydenfakemail.com电话生成phone.gok.Phone() // 55-44-63311072支付卡生成payment.gok.PaymentCard() // 24208918642114291 k.MasterCard() // 5154214251151243 k.VisaCard() // 4292198623077593 小提示支付卡号仅为测试用途的随机数字不代表真实卡号。六、时间日期生成函数7 个速查datetime.go提供了非常实用的时间区间随机函数返回值类型为time.Time可直接用于数据库字段。k.DateTimeBetween(start, end) // 区间内随机时间 k.DateTimeAfter(t) // 某时刻之后 k.DateTimeBefore(t) // 某时刻之前 k.DateTimeBetweenWithString(a, b) // 用 RFC3339 字符串指定区间 k.DateFormatter(layout, datetime) // 自定义格式化输出长尾关键词kolpa 随机时间生成函数怎么用——例如生成过去 30 天内的注册时间只需k.DateTimeAfter(time.Now().Add(-30*24*time.Hour))即可。七、文本、颜色与浏览器标识生成函数Lorem 文本lorem_text.gok.LoremWord() // dolores k.LoremSentence() // Provident nobis nostrum blanditiis voluptatem animi rerum harum. k.LoremParagraph() // 随机段落颜色生成color.gok.Color() // Lime #00FF00颜色名 HEX 值User Agent 生成user_agent.gok.UserAgent() // 随机 UA k.Chrome() // Chrome UA k.Firefox() // Firefox UA k.Safari() / k.Opera() / k.InternetExplorer()浏览器 UA 生成对爬虫开发、浏览器兼容性测试非常有用模拟不同内核的请求头只需一行代码。八、其他实用函数与多语言支持语言环境生成misc.gok.Locale() // en-US k.LocaleWithUnderscore() // en_US多语言数据切换kolpa 的数据文件按data/locale/组织目前已内置en_US、zh_CN、tr_TR、pl_PL、pt_BR等多套数据。初始化时传入语言代码即可k : kolpa.C(zh_CN)结合SetLanguage()还能在程序运行中动态切换语言非常适合做国际化测试数据的生成。九、kolpa 常用场景速查场景推荐函数组合用户表造数Name()Email()Phone()Address()订单流水PaymentCard()DateTimeAfter()LoremWord()浏览器测试Chrome()/Firefox()/Safari()内容占位LoremSentence()/LoremParagraph()总结kolpa 虽然代码量精简核心逻辑集中在kolpa.go、utils.go却提供了覆盖 10 大类的 30 生成函数配合GenericGenerator还能自定义扩展数据模板。无论你是新手想快速生成测试数据还是老手需要稳定的假数据工具这份 kolpa API 速查手册都能帮你一行代码造数据把精力留给真正重要的业务逻辑。【免费下载链接】kolpaA fake data generator written in and for Go项目地址: https://gitcode.com/gh_mirrors/ko/kolpa创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考