Python 예제

이 실습에서는 다음을 사용하여 일부 콘텐츠를 다운로드하고 분석하는 간단한 프로그램을 작성하는 방법을 보여줍니다. 스냅샷 콘텐츠 서버가 제공하는.

다음 항목을 찾을 수 있습니다. 전체 스크립트 를 GitHub에서, 그리고 더 고급 예제.

우리는 Decentraland Foundation의 서버를 다음에서 사용할 것입니다. peer.decentraland.org, 그리고 Python 3를 선호 언어로 사용합니다.

우리가 할 일은 다음과 같습니다:

콘텐츠 서버의 상태를 조회합니다.
다음을 선택하고 다운로드합니다. 스냅샷 엔티티 목록이 포함된.
참조된 모든 엔티티의 유형과 ID를 출력합니다.

몇 가지 준비 작업으로 스크립트를 시작해 봅시다. 표준 라이브러리 모듈만 사용하겠지만, 실제 코드에서는 아마도 더 편한 HTTP 클라이언트(예: requests 라이브러리)를 원하게 될 것입니다.

# HTTP GET 요청을 만들어, 파일처럼 다룰 수 있는 HTTP 응답을 반환합니다.
def fetch(path):
    url = f"https://peer.decentraland.org/{path}"
    headers = { "User-Agent": "urllib" } # 일부 서버에서 중요함(비어 있으면 403 Forbidden)

    request = urllib.request.Request(url, headers=headers)
    response = urllib.request.urlopen(request)

    return response

우리의 간단한 헬퍼는 HTTP GET 요청을 만들고, 파일처럼 다룰 수 있는 응답 객체를 반환합니다. 별다른 것은 없습니다. 이를 사용해 /about 엔드포인트에 접속하고 서버 상태를 확인해 봅시다:

# 서버 상태를 확인합니다:
about = json.load(fetch('about'))

if not about['healthy']】【：】【“】【t_5e0321bf":"print(\"서버가 정상적이지 않습니다!\")","t_0815044e":"sys.exit(1)","t_db7d70d8":"이 지점을 지나면 서버가 실행 중이며(우리는","t_94ab18de":"응답을 받았고) 운영 중이라고 보고하고 있습니다. 현재 스냅샷 집합을 요청할 수 있습니다(이것은 JSON 배열 형식으로 제공됩니다):","t_4fc3436d":"# 스냅샷 목록을 가져옵니다:","t_42a6af8f":"all_snapshots = json.load(fetch('content/snapshots'))","t_f6cc5826":"스냅샷 파일은(특히 더 긴 시간 범위의 경우) 매우 클 수 있습니다. 빠른 실험을 위해 목록에서 가장 작은 것을 다음 기준으로 가져와 봅시다.","t_bbd8fa11":"# 포함된 엔티티 수 기준으로 가장 작은 스냅샷을 선택합니다:","t_d772d884":"snapshot = min(all_snapshots, key=lambda s: s['numberOfEntities'])","t_3ee8d295":"콘텐츠를 다운로드하려면 다음이 필요합니다.","t_e88cb744":"필드","t_ba1f2e70":"의 . 파일 URL은 이를 콘텐츠 루트에 덧붙여 얻습니다:
    print("서버가 정상적이지 않습니다!")
    sys.exit(1)

이 지점을 지나면 서버가 실행 중이며(우리는 200 응답을 받았고) 운영 중이라고 보고하고 있습니다. 현재 스냅샷 집합을 요청할 수 있습니다(이것은 JSON 배열 형식으로 제공됩니다):

# 스냅샷 목록을 가져옵니다:
all_snapshots = json.load(fetch('content/snapshots'))

스냅샷 파일은(특히 더 긴 시간 범위의 경우) 매우 클 수 있습니다. 빠른 실험을 위해 목록에서 가장 작은 것을 다음 기준으로 가져와 봅시다. numberOfEntities:

# 포함된 엔티티 수 기준으로 가장 작은 스냅샷을 선택합니다:
snapshot = min(all_snapshots, key=lambda s: s['numberOfEntities'])

콘텐츠를 다운로드하려면 다음이 필요합니다. hash 필드 스냅샷의 . 파일 URL은 이를 콘텐츠 루트에 덧붙여 얻습니다:

# 콘텐츠 API에서 파일을 요청합니다:
response = fetch('content/contents/' + snapshot['hash'])

선택한 파일은 메모리에 버퍼링할 수 있을 만큼 작지만, 우리가 그것을 모른다고 가정하고 스트리밍해 봅시다. 첫 번째 줄은 스냅샷 헤더이고, 그 다음의 각 줄에는 JSON 객체가 들어 있습니다.

헤더를 확인해 봅시다. 항상 좋은 생각입니다:

# 스냅샷 헤더를 검증합니다:
header = response.readline().decode('utf-8').strip()

if header != '### Decentraland json snapshot':
    print("잘못된 스냅샷 헤더: " + header)
    sys.exit(1)

이제 응답을 한 줄씩 읽으면서 스냅샷의 모든 엔티티를 처리할 수 있습니다. 우리의 소박한 목적에서, 처리 란 엔티티 유형과 ID를 출력하는 것을 의미합니다:

# 각 항목을 읽고 디코딩합니다. 한 줄당 JSON 하나씩:
for line in response:
    item = json.loads(line)
    print(item['entityType'], item['entityId'])

이 루프는 스냅샷이 끝날 때까지 다음과 같은 줄들을 스트리밍하고, 파싱하고, 출력하기 시작할 것입니다:

profile bafkreic36qmzyprs6whkpuxbeiif4no6kvdrr2tfpichbx2fzfz5py6eyv
scene bafkreibr5xfujqrp5q3o4s73vm2yljlcp7cucqgugssnarsuclxv4emlmy
profile bafkreid7khr5wnkialba44rsslffi633rh3lvctad5oa5vjoe6wa7s4c5a
wearable bafkreihlqcb7jgubomyidikpwpqhgzbagltk5m4rgbjdvzydxmoka7bg4i

잘됐습니다! 스냅샷 시스템을 사용해 Decentraland에서 이용 가능한 일부 콘텐츠를 살펴보았습니다.

다음을 찾을 수 있다는 점을 기억하세요 전체 스크립트 를 GitHub에서, 그리고 더 고급 예제.

이전CLI 예제

다음개요

마지막 업데이트 1일 전