Collector APIs
外部 API から取得し、Filing を組み立てて Collection.add する層。テンプレートメソッド: 公開は iter_collect(**criteria) / collect(**criteria)。サブクラスは _fetch_documents / _parse_response / _build_filing を実装する。
公開型(パッケージルートから re-export)
| Type | 説明 |
|---|---|
| BaseCollector | 上記フローの抽象基底 |
RawDocument / Parsed | RawDocument(content: bytes, meta: dict); Parsed = dict[str, Any] |
| EdgarConfig / EdgarClient | SEC 用設定・HTTP クライアント(主に Collector 内部) |
| EdgarArchiveCollector / EdgarFactsCollector / EdgarBulkCollector | SEC 収集 |
| EdinetConfig / EdinetCollector | EDINET 収集 |
フロー(1 件ごと)
_fetch_documents(**criteria)→RawDocumentを yield_parse_response(raw)→Parsed_build_filing(parsed, content)→Filing(contentはraw.content)_add_to_collection→Collection.add
途中で失敗しても、すでに yield 済みの分は Collection に残る。