IrisEx

설치

def deps do
 [
 {:iris_ex, git: "https://github.com/AlphaDoStar/IrisEx.git"}
 ]
end

시작하기

1. 챗봇 생성

defmodule MyBot do
 use IrisEx.Bot
 on :message do
 match "안녕" do
 reply("안녕하세요!")
 end
 end
end

2. Application 설정

defmodule MyApp.Application do
 use IrisEx.Application,
 bots: [MyBot],
 ws_url: "ws://localhost:3000/ws",
 http_url: "http://localhost:3000",
 children: []
end

3. mix.exs 설정

def application do
 [
 extra_applications: [:logger],
 mod: {MyApp.Application, []}
 ]
end

4. 실행

# 개발 모드로 실행
mix run --no-halt
# 또는 iex에서 실행
iex -S mix

주요 기능

메시지 매칭

# 정확한 텍스트
match "greet" do
 reply("반갑습니다.")
end
# 정규표현식 + 파라미터 추출
match ~r/greet (.+)/ do
 [name] = args
 reply("#{name} 님, 안녕하세요!")
end

상태 관리

on :message do
 # 채팅방 ID에 따른 상태 관리
 set chat.room.id
 state :default do
 match "메뉴" do
 reply("1. 딸기\n2. 바나나")
 trans :selection
 end
 end
 state :selection do
 match ~r/^(\d)$/ do
 [choice] = args
 case String.to_integer(choice) do
 1 -> reply("딸기를 선택하셨네요!")
 2 -> reply("바나나를 선택하셨네요!")
 _ -> :ok
 end
 trans :default
 end
 end
end

이벤트 처리

# 메시지 이벤트
on :message do
 # 메시지 처리 로직
end
# 새 멤버 입장
on :new_member do
 reply("#{chat.sender.name} 님, 환영합니다!")
end
# 기존 멤버 퇴장
on :del_member do
 reply("#{chat.sender.name} 님, 잘가요!")
end

컨텍스트 접근

on :message do
 match "정보" do
 reply("채팅방: #{chat.room.id}")
 reply("사용자: #{chat.sender.name}")
 end
end

완전한 예제

defmodule FruitBot do
 use IrisEx.Bot
 on :message do
 set chat.room.id
 state :default do
 match "선택" do
 message =
 """
 1. 딸기
 2. 바나나
 """
 reply("어떤 과일이 좋으신가요?")
 reply(message, trim: true) # trim 옵션 제공
 trans :fruit_selection
 end
 end
 state :fruit_selection do
 match ~r/^(\d)$/ do
 [index] = args
 case String.to_integer(index) do
 1 -> reply("난 바나나가 더 좋은데...")
 2 -> reply("난 딸기가 더 좋은데...")
 _ -> reply("1 또는 2를 선택해주세요.")
 end
 trans :default
 end
 end
 match "greet" do
 reply("안녕하세요.")
 continue() # 다음 매치로 계속
 end
 match "greet" do
 reply("반갑습니다.")
 end
 match ~r/greet (.+)/ do
 [name] = args
 reply("#{name} 님, 안녕하세요!")
 end
 fallback do
 # 매칭되지 않은 경우 처리
 end
 end
 on :new_member do
 reply("#{chat.sender.name} 님, 어서오세요!")
 end
end
defmodule MyApp.Application do
 use IrisEx.Application,
 bots: [FruitBot],
 ws_url: "ws://localhost:3000/ws",
 http_url: "http://localhost:3000",
 children: []
end

설정 옵션

Application 옵션

API 참조

매크로

컨텍스트 변수