Repolode
mherrmann

mherrmann/helium

Selenium 기반 브라우저 자동화용 Python 라이브러리로, selector 대신 화면에 표시되는 레이블로 요소를 지정합니다.

스타
8,322
포크
513
열린 이슈
55
마지막 커밋
3일 전

어떤 프로젝트인가요?

Helium은 Chrome과 Firefox를 자동화하는 Python 라이브러리입니다. Selenium을 감싸고 각 호출을 Selenium으로 전달하므로, 기본 드라이버를 계속 사용할 수 있고 한 스크립트에서 두 라이브러리를 자유롭게 함께 쓸 수 있습니다.

가장 큰 차이는 API입니다. HTML ID, XPath, CSS selector 대신 Helium은 Button('Download')처럼 사용자에게 보이는 레이블로 요소를 지정합니다. 스크립트는 일반적으로 동등한 Selenium 코드보다 30~50% 짧고, 페이지 마크업이 바뀌어도 깨질 가능성이 낮습니다.

또한 Helium은 순수 Selenium으로 처리하기 번거로운 작업도 지원합니다. 중첩된 iframe 안의 요소를 전환 없이 조작하고, 팝업이 열리고 닫힐 때 해당 창에 포커스를 맞추며, 일부 제목으로 창을 전환하고, 요소가 나타날 때까지 최대 10초간 암묵적으로 기다립니다. 명시적 대기를 위한 더 간단한 wait_until 도우미도 제공합니다.

핵심 기능

  • 01selector 대신 버튼이나 링크처럼 화면에 표시되는 레이블로 요소를 찾습니다.
  • 02Selenium을 통해 Chrome과 Firefox에서 동작합니다.
  • 03명시적으로 전환하지 않고 중첩된 iframe 안의 요소를 조작합니다.
  • 04팝업 창을 자동으로 처리하고 제목 일부로 창을 전환합니다.
  • 05요소가 나타날 때까지 기본적으로 최대 10초간 기다립니다.
  • 06한 스크립트에서 Helium 호출과 순수 Selenium API를 함께 사용할 수 있습니다.

활용 사례

  • 양식 작성이나 보고서 다운로드 같은 반복적인 웹 작업을 자동화합니다.
  • 읽기 쉽고 마크업 변경에도 잘 견디는 브라우저 테스트를 작성합니다.
  • 화면에 표시되는 텍스트로 요소를 더 쉽게 식별할 수 있는 페이지를 스크래핑합니다.

빠른 시작

  1. 1

    가상 환경 만들기

    python3 -m venv venv
  2. 2

    가상 환경 활성화하기(Mac/Linux)

    source venv/bin/activate
  3. 3

    pip로 Helium 설치하기

    python -m pip install helium

사용 전 알아둘 점

  • Chrome 또는 Firefox가 설치되어 있어야 합니다.
  • 메인테이너는 시간이 제한되어 있어 간단히 처리할 수 있는 경우가 아니면 보통 이슈에 답변하지 않습니다.

포함된 컬렉션

토픽

자주 묻는 질문

helium은(는) 무엇인가요?
Selenium 기반 브라우저 자동화용 Python 라이브러리로, selector 대신 화면에 표시되는 레이블로 요소를 지정합니다. Helium은 Chrome과 Firefox를 자동화하는 Python 라이브러리입니다. Selenium을 감싸고 각 호출을 Selenium으로 전달하므로, 기본 드라이버를 계속 사용할 수 있고 한 스크립트에서 두 라이브러리를 자유롭게 함께 쓸 수 있습니다.
helium은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
helium은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
helium은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. helium의 마지막 커밋은 2026년 10월 22일입니다.
helium은(는) 어디에 사용할 수 있나요?
양식 작성이나 보고서 다운로드 같은 반복적인 웹 작업을 자동화합니다. 읽기 쉽고 마크업 변경에도 잘 견디는 브라우저 테스트를 작성합니다. 화면에 표시되는 텍스트로 요소를 더 쉽게 식별할 수 있는 페이지를 스크래핑합니다.
helium는 어떻게 설치하나요?
가상 환경 만들기: python3 -m venv venv 가상 환경 활성화하기(Mac/Linux): source venv/bin/activate pip로 Helium 설치하기: python -m pip install helium
helium은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/mherrmann/helium

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트