파일 업로드
  1. base64hub
  2. 다운로드
  3. Python 패키지
v1.0.0 · 오픈 소스 · MIT

PyPI base64hub: Python Base64 라이브러리와 CLI

PyPI의 base64hub는 표준 라이브러리의 Base64를 더 쓰기 편한 API로 감쌉니다. 텍스트를 넣으면 Base64 문자열이 나오고, 디코딩은 현실의 지저분한 입력도 처리하며, b64 명령도 들어 있습니다.

pip install base64hub
무료 계정 없음, 키 없음 MIT 오픈 소스 라이선스 0개 런타임 의존성 업데이트 2026. 11. 22.

설치

pip install base64hub      # the library, in a virtual environment
pipx install base64hub     # the b64 command, isolated

Python 3.9 이상만 있으면 됩니다. 이 패키지는 표준 라이브러리만 사용하므로 설치할 때 다른 코드를 끌어오지 않습니다.

인코딩, 디코딩, 검증

함수는 네 개이며 Python에서 기대할 만한 타입을 씁니다.

from base64hub import encode, decode, validate, data_uri

encode("Hello, hub!")                    # 'SGVsbG8sIGh1YiE='
encode("Привет", url=True, pad=False)    # '0J_RgNC40LLQtdGC'
encode(b"foobar", wrap=4)                # 'Zm9v\nYmFy'
decode("SGVsbG8sIGh1YiE")                # b'Hello, hub!'
decode("data:text/plain;base64,SGk=")    # b'Hi'
validate("+/+/")["variant"]              # 'standard'
data_uri(b"Hi")                          # 'data:text/plain;charset=utf-8;base64,SGk='

encode는 str(UTF-8로 인코딩)이나 bytes를 받아 str을 반환합니다. decode는 bytes를 반환하고, Base64가 아닌 입력에는 ValueError의 하위 클래스인 base64hub.Base64Error를 발생시킵니다. validate는 예외를 발생시키지 않으며 valid, variant, padded, bytes, error를 담은 dict를 반환합니다. error에는 입력이 잘못됐을 때 그 이유가, 그렇지 않으면 None이 들어 있습니다.

base64hub와 base64 모듈 비교

표준 base64 모듈은 정확하고 빠릅니다. 다만 사람들이 지저분한 입력을 붙여넣는 곳에서는 엄격하고, 오류를 내야 할 곳에서는 느슨합니다. 아래는 Python 3.13에서 실제로 나온 출력입니다.

import base64

base64.b64decode("SGVsbG8sIGh1YiE")   # binascii.Error: Incorrect padding
base64.b64decode("Zm9v!YmFy")         # b'foobar', the "!" is dropped silently
base64.b64decode("-_-_")              # b'', URL-safe characters are dropped
base64 모듈base64hub
빠진 = 패딩Incorrect padding허용
URL-safe 입력별도의 urlsafe_b64decodedecode가 처리
잘못된 문자validate=True가 아니면 버림ValueError
encode의 반환 타입bytesstr
data: URI없음data_uri(), 디코딩할 때는 제거

직접 만든 데이터만 인코딩한다면 표준 라이브러리로 충분합니다. 방법은 Python에서 Base64 사용하기에 있습니다. 입력이 사용자, 로그, JSON, URL에서 오고 올바른 결과나 명확한 오류 중 하나를 원할 때 base64hub를 쓰세요.

b64 명령

pipx install base64hub로 네이티브 CLI와 같은 b64 명령을 설치할 수 있습니다.

$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 --url --no-pad "Привет"
0J_RgNC40LLQtdGC

Python 빌드는 처리하기 전에 입력을 메모리로 읽고, Go 빌드는 스트리밍합니다. 플래그와 종료 코드를 비롯한 나머지는 모두 같습니다. 모든 함수와 플래그는 Python 문서에 있습니다.

자주 묻는 질문

Python으로 Base64 명령줄 도구를 설치하려면 어떻게 하나요?

pipx install base64hub를 실행하면 별도 환경에 설치된 b64 명령이 PATH에 추가됩니다. 가상 환경 안에서 pip install base64hub를 실행해도 됩니다.

base64.b64decode가 Incorrect padding 오류를 내는 이유는 무엇인가요?

표준 라이브러리는 길이가 반드시 4의 배수여야 합니다. base64hub.decode()는 빠진 =를 직접 채우므로 decode("SGVsbG8sIGh1YiE")가 b'Hello, hub!'를 반환합니다.

base64hub는 어떤 Python 버전을 지원하나요?

Python 3.9 이상입니다. 표준 라이브러리 밖의 의존성은 없습니다.

변형을 모르는 URL-safe Base64를 Python에서 디코딩하려면 어떻게 하나요?

base64hub.decode()를 호출하세요. 한 문자열 안에서 표준 알파벳과 URL-safe 알파벳을 모두 받아들입니다. 표준 라이브러리에서는 b64decode와 urlsafe_b64decode 중 하나를 직접 골라야 합니다.

base64hub의 다른 제품