# ✅ 正确
type HttpRequest* = object
  url*: string
  headers*: seq[tuple[key, value: string]]

const DefaultTimeout* = 30

proc sendRequest*(req: HttpRequest): HttpResponse =
  discard

# ❌ 错误
type http_request = object  # 类型应为 PascalCase
proc Send_Request() = discard  # 过程应为 camelCase

# 公开 API：后缀 *
type User* = object
  name*: string       # 公开字段
  age*: int

proc newUser*(name: string, age: int): User* =
  User(name: name, age: age)

proc getName*(user: User): string =
  user.name

# 内部实现：不导出
proc validateAge(age: int): bool =
  age >= 0 and age <= 150

type CacheEntry = object  # 模块内部使用
  data: string
  timestamp: float

# 使用 nimpretty 格式化
nimpretty --indent:2 --maxLineLen:100 src/*.nim

import std/[
  strutils,
  sequtils,
  tables
]

type
  Config* = object
    ## 应用配置
    host*: string       ## 服务器地址
    port*: int          ## 服务器端口
    debug*: bool        ## 是否启用调试模式

proc newConfig*(host = "localhost", port = 8080): Config =
  ## 创建新配置
  Config(host: host, port: port, debug: false)

proc formatAddress*(cfg: Config): string =
  ## 格式化为 host:port 格式
  cfg.host & ":" & $cfg.port

# 使用 when 而不是嵌套 if
when isMainModule:
  let cfg = newConfig(port = 3000)
  echo cfg.formatAddress()

# 长行换行
proc processVeryLongFunctionName(
    param1: string,
    param2: int,
    param3: seq[float],
    param4: bool = false
): Result[string, Error] =
  # 函数体
  discard

# 链式调用换行
let result = data
  .filterIt(it > 0)
  .mapIt(it * 2)
  .sorted()
  .deduplicate()

# config.nims
switch("path", "src")
switch("nimcache", "nimcache")

when defined(release):
  switch("opt", "speed")
  switch("checks", "off")
else:
  switch("debugger", "native")
  switch("linedir", "on")
  switch("hints", "on")

# ✅ 推荐：使用 Result 类型
import std/results

proc parseConfig(path: string): Result[Config, string] =
  if not fileExists(path):
    return err("File not found: " & path)
  
  let content = try:
    readFile(path)
  except IOError as e:
    return err("Read error: " & e.msg)
  
  try:
    ok(parseJson(content).to(Config))
  except JsonParsingError as e:
    return err("Parse error: " & e.msg)

# ✅ 推荐：有意义的错误信息
proc divide(a, b: float): Result[float, string] =
  if b == 0.0:
    err("Division by zero")
  else:
    ok(a / b)

# ❌ 不推荐：吞掉异常
# try: doSomething() except: discard

# ❌ 不推荐：过于宽泛的异常捕获
# try: doSomething() except CatchableError: discard

# ✅ 使用类型别名增加语义
type
  UserId = int
  Email = string
  Money = float

proc sendEmail(to: Email, subject: string) =
  discard

proc processPayment(userId: UserId, amount: Money) =
  discard

# ✅ 使用范围类型限制值域
type
  Percentage = range[0..100]
  Port = range[0..65535]
  Age = range[0..150]

# ✅ 使用 distinct 类型防止混淆
type
  Celsius = distinct float
  Fahrenheit = distinct float

proc toCelsius(f: Fahrenheit): Celsius =
  Celsius((f.float - 32.0) * 5.0 / 9.0)

proc toFahrenheit(c: Celsius): Fahrenheit =
  Fahrenheit(c.float * 9.0 / 5.0 + 32.0)

# 不能直接混用
let bodyTemp = Celsius(37.0)
# let wrong = bodyTemp + Fahrenheit(100.0)  # ❌ 编译错误

# ✅ 使用值类型
type Point = object  # 栈分配
  x, y: float

# ✅ 预分配
var data = newSeqOfCap[int](10000)

# ✅ 使用 lent 避免拷贝
proc first[T](s: seq[T]): lent T = s[0]

# ✅ 使用 sink 转移所有权
proc consume(data: sink seq[int]) =
  # data 的所有权转移到此过程
  discard

# ✅ 使用 HashSet 做成员检查
import std/sets
let validCodes = toHashSet([200, 201, 204, 301, 302])
if code in validCodes:
  discard

# ✅ 使用 Channel 进行线程通信
import std/threads

var channel: Channel[string]
channel.open(100)

# ✅ 使用 async/await 处理 I/O
import std/asyncdispatch

proc fetchData(url: string): Future[string] {.async.} =
  let client = newAsyncHttpClient()
  defer: client.close()
  return await client.getContent(url)

# ✅ 避免共享可变状态
# 使用消息传递而不是共享内存

# ✅ 使用 Lock 保护共享数据
import std/locks
var sharedData: seq[int]
var lock: Lock
initLock(lock)

proc addToData(val: int) =
  withLock(lock):
    sharedData.add(val)

import std/unittest

# ✅ 测试应该独立、可重复
suite "User Service":
  test "创建用户":
    let svc = newUserService()  # 每个测试新建
    let user = svc.create("Alice", "[email protected]")
    check user.name == "Alice"
  
  test "查找用户":
    let svc = newUserService()
    discard svc.create("Alice", "[email protected]")
    let found = svc.findByName("Alice")
    check found.isSome

# ✅ 测试边界条件
suite "边界条件":
  test "空输入":
    check process("").len == 0
  
  test "极大值":
    check process($int.high).len > 0
  
  test "特殊字符":
    check process("hello\nworld\t!") != ""

# ✅ 测试错误情况
suite "错误处理":
  test "无效输入":
    expect ValueError:
      discard parseInt("abc")

proc calculateDistance*(x1, y1, x2, y2: float): float =
  ## 计算两点之间的欧几里得距离
  ##
  ## 参数：
  ##   x1, y1 — 第一个点的坐标
  ##   x2, y2 — 第二个点的坐标
  ##
  ## 返回值：两点之间的距离
  ##
  ## 示例：
  ##   ```nim
  ##   echo calculateDistance(0, 0, 3, 4)  # 5.0
  ##   ```
  sqrt((x2 - x1) ^ 2 + (y2 - y1) ^ 2)

type
  User* = object
    ## 用户对象
    ## 
    ## 存储用户的基本信息，用于系统认证和授权
    name*: string    ## 用户名
    email*: string   ## 邮箱地址
    age*: int        ## 年龄，范围 0-150