developer-portfolios 딥다이브
— 개발자 1,800여 명의 포트폴리오를 모은 '살아있는' 카탈로그

1프로젝트 한줄 요약

이 레포가 무엇을 하는 물건인가.

구조 자체는 단순합니다. README.md 파일 하나에 - [이름](포트폴리오 주소) [직함 | 전문 분야] 형식의 줄이 1,800여 개 들어 있고, 알파벳 A부터 Z까지 섹션으로 나뉘어 있습니다. 누구나 자기 포트폴리오를 PR (Pull Request, 코드 병합 요청)로 추가할 수 있습니다.

하지만 이 레포가 공부 자료로 가치 있는 진짜 이유는 따로 있습니다. 1,800여 개의 줄을 사람이 알파벳순으로 유지하고 중복을 걸러내는 건 불가능합니다. 그래서 이 레포는 src/ 폴더에 그 일을 대신 해 주는 파이썬 자동화 스크립트를 두고 있습니다. 즉 "콘텐츠는 마크다운, 엔지니어링은 파이썬"인 셈이죠.

2왜 주목받는가

트렌딩 이유 · 비슷한 목록과 다른 점.

이 레포는 2019년 개발자 Emma Bostian이 동료 Ali Spittel의 트윗("포트폴리오 좀 보여줄 사람?")에서 영감을 받아 시작했습니다. 그 뒤 전 세계 개발자들이 자기 포트폴리오를 PR로 보태면서 1,800여 개까지 불어난 거대한 크라우드소싱 자료가 되었습니다. 인기 비결은 세 가지입니다.

첫째, 구직·이직 시즌의 실용성. "나도 포트폴리오를 만들어야 하는데 뭘 넣지?"라는 막막함을 1,800여 개의 실제 사례로 단번에 풀어 줍니다. 둘째, 오픈소스 입문자의 첫 PR 연습장. 코드를 몰라도 마크다운 한 줄만 추가하면 되니, 생애 첫 기여를 여기서 해 보는 사람이 많습니다. 셋째 — 그리고 이 글의 초점 — 거대 목록을 자동화로 유지하는 모범 사례라는 점입니다.

3기술 스택 전체 지도

콘텐츠 · 자동화 · 데이터 · CI 한눈에.

화려한 프레임워크는 없습니다. 핵심은 파이썬 표준 라이브러리만으로 짠 텍스트 처리 파이프라인 — 외부 패키지 설치가 전혀 필요 없다는 점이 오히려 배울 만합니다.

덤: 1,800여 개가 실제로 어디에 호스팅돼 있나

목록의 포트폴리오 주소들을 직접 집계해 봤습니다(약 1,000개 표본 기준 — 전체 1,800여 개의 일부라 비율은 근사값입니다). 실제 개발자들이 개인 사이트를 어디에 올리는지 보여 주는 살아있는 데이터입니다.

4아키텍처 심화 분석

PR 한 건이 들어오면 무엇이 어떤 순서로 도는가.

이 레포의 "아키텍처"는 서버 구조가 아니라 데이터(=README) 가공 파이프라인입니다. 먼저 전체 그림을 보고, 그다음 줄 한 개가 어떻게 처리되는지 끝까지 따라가 보겠습니다.

핵심 엔진 alphabetical.py의 9단계 (해피 패스)

이 스크립트의 main()은 README를 읽어 아래 순서로 가공한 뒤 다시 저장합니다. "줄 하나"가 거치는 여정을 따라가 봅시다.

여기서 가장 영리한 부분은 ⑤ 중복 판단입니다. https://Me.com/과 http://me.com은 글자만 보면 다르지만 사실 같은 사이트죠. 그래서 비교 전에 URL 정규화를 거칩니다 — 대소문자를 낮추고, :80/:443 같은 기본 포트를 떼고, 끝의 /를 제거해 "같은 주소"로 만든 뒤 비교합니다.

5디렉토리 구조 해부

어떤 파일이 무슨 일을 하나.

6학습 포인트 (기술별)

이 작은 레포에서 의외로 많이 배운다.

핵심 로직은 이렇게 짧습니다(읽기 쉽게 단순화):

# 겉모습이 달라도 같은 사이트로 인식되게 표준형으로 변환
def _normalize_url(url):
    p = urlparse(url)                # URL을 부품으로 분해
    scheme = p.scheme.lower()        # http/https 소문자로
    netloc = p.netloc.lower()        # 도메인 소문자로
    path = p.path.rstrip('/')        # 끝의 / 제거 → 핵심!
    return urlunparse((scheme, netloc, path, '', p.query, p.fragment))

복사해서 그대로 돌려도 됩니다. https://Me.com/도, http://me.com도 모두 http(s)://me.com으로 맞춰져 "중복"으로 잡히는 원리입니다.

# 두 번째 글자 이후에 대문자가 있거나(GitHub) 전부 대문자(API)면 그대로 둠
if len(token) > 1 and (any(c.isupper() for c in token[1:]) or token.isupper()):
    result.append(token)         # DevOps, GitHub, API → 보존
else:
    result.append(token.title()) # aaron → Aaron

7시스템 요구사항

돌려 보려면 무엇이 필요한가 — 거의 아무것도 필요 없다.

의존성이 0개라는 점은 그 자체로 학습 포인트입니다. "표준 라이브러리만으로 충분한 일에 굳이 패키지를 늘리지 않는다"는 절제를 보여 줍니다.

8직접 해볼 수 있는 실습 과제

읽기만 하지 말고 직접 돌려 보자.

9관련 기술 심화 학습 로드맵

이 레포를 발판 삼아 한 주씩.

10핵심 키워드 사전

본문에 나온 용어 빠른 참조.

11참고 링크

• GitHub: emmabostian/developer-portfolios
• 기여 가이드: CONTRIBUTING.md
• 핵심 엔진: src/alphabetical.py
• TrendShift: trendshift.io (실시간 트렌딩 레포)
• 파이썬 공식 문서: urllib.parse · re · unicodedata