Skip to main content

libefiling

This library targets electronic filing data provided by the Japan Patent Office (JPO). Detailed documentation is written in Japanese, as the primary users are Japanese.

概要

libefiling は インターネット出願ソフトのアーカイブを扱う python パッケージです。

  • インターネット出願ソフト: 日本国特許庁に特許など出願する際に使うアプリ
  • アーカイブ: インターネット出願ソフトの「データ出力」で保存されるようなJWX(JPC,JWX)を本パッケージではそう呼んでる。
  • データ出力でアーカイブと一緒に出力されるXMLを手続XMLと呼ぶことにする。

機能

  • アーカイブの展開 -> XML, 画像ファイルが得られる
  • XMLファイルの文字コード変換
  • manifest.json の生成
  • いまのところ 特許願(A163) だけが処理対象。

動作環境

  • ubuntu bookworm
  • python 3.14

必要アプリのインストール

apt-get update
apt-get install -y python3.14

libefiling パッケージのインストール

pip install libefiling

使い方

from libefiling import parse_archive, Source

SRC = "202501010000123456_A163_____XXXXXXXXXX__99999999999_____AAA.JWX"
PROC = "202501010000123456_A163_____XXXXXXXXXX__99999999999_____AFM.XML"
OUT = "output"

# src のハッシュ値や文書コードを生成して、処理するか判定する例
source = Source.create(SRC)
document_code = source.get_document_code()
if document_code not in ["A163", "A151"]:
    raise ValueError(f"Unsupported document code: {document_code}")
if source.sha256 == "...":
    print("Already processed")
else:
    parse_archive(SRC, PROC, OUT)
  • generate_sha256 はアーカイブの内容に応じたハッシュ値を生成し、再処理判定用に使える。
  • parse_archive は SRC, PROC を OUT に展開する。
  • source = Source.create(SRC) の source は、manifest.json の sources フィールドと同じ形式。parse_archive するまえに、source.sha256 を得られるということ。

出力ファイル

  • manifest.json : 展開後のファイルの情報
  • raw/ : SRC に含まれてたファイルが展開されてる。
  • xml/ : raw/*.xml と PROC を文字コード変換した xml が保存されてる。

注意事項

  • テストは十分でないので、いろいろバグあるとおもう。
  • 読み取り元のファイル(SRC,PROCに指定したファイル)や展開後のファイルは、どこかに送信されることはありません。ソースみてもらえば。
  • 本アプリで何らかの損害を被っても本アプリ作者は責任を負いません。

ライセンス

MIT ライセンス

Reference

特許庁 日本国特許庁電子文書交換標準仕様XML編 (抜粋版) https://www.jpo.go.jp/system/patent/gaiyo/sesaku/document/touroku_jyohou_kikan/shomen-entry-02jpo-shiyosho.pdf

変更履歴

0.1.40

  • manifest の形式変更
    • xml, image の path を filename にした。

0.1.49

  • manifest の形式変更
    • xml_files の kind を追加
  • get_document_code 関数を追加

0.1.51

  • get_doc_id 関数を追加

0.1.54

  • 画像リサイズをスレッド化した。

0.1.55

  • 画像リサイズのために cykooze_resizer を選択できるようにした。

0.1.56

  • 画像リサイズのために pillow-simd を選択できるようにした。

0.1.60

  • get_document_code 関数は、manifest.jsonだけでなく、アーカイブパス・手続ファイルを与えても文書コードを返すようにした。
  • manifest.json に 文書コードを含めた

0.2.0

  • manifest.json の documents フィールドを sources フィールドに変更した。
    • sources の子要素は配列でなく archive, procedure とした。
    • sources.document_code フィールドは、文書コードを表す
  • get_document_code 廃止,Source クラスの get_document_code で代替
  • get_doc_id, generate_sha256 関数廃止, Source クラスの sha256 で代替
  • xml/sources.xml をはき出すようにした. manifest.json の sources フィールドと同じ内容を表す。

0.2.1

  • xml/images-information.xml をはき出すようにした. manifest.json の images フィールドと同じ内容 + ocr テキストを含んだxml

0.3.0 ** API互換性がなくなっています。

  • 画像変換、OCR、xml/sources.xml、xml/images-information.xml の出力を廃止した。
  • 出力は manifest.json, xml/, raw/ のみとした。

Metadata

Release files for libefiling 0.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for libefiling 0.3.1
File Size Uploaded Provenance Actions
libefiling-0.3.1.tar.gz 71.8 kB With provenance Details for libefiling-0.3.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for libefiling 0.3.1
File Interpreter ABI Platform Actions
libefiling-0.3.1-py3-none-any.whl Python 3 none any Details for libefiling-0.3.1-py3-none-any.whl

Total release size: 88.1 kB

Release files / libefiling-0.3.1.tar.gz

Download URL libefiling-0.3.1.tar.gz
Size 71.8 kB
Tags Source
SHA-256 checksum
How to use checksums
b6a52642232a28966ef47502c558dd42d53facf49b242bb14d17265d2a399327
BLAKE2b-256 checksum
How to use checksums
2ccb2e222f8c7d48cc2438cc92a23c7e8405693a20ca095c76f711eaed418cd4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.

Transparency log

Release files / libefiling-0.3.1-py3-none-any.whl

Download URL libefiling-0.3.1-py3-none-any.whl
Size 16.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9608dfe52365d2a1d059ae28483744e2acf295084e4da1652dfb26e0b3141072
BLAKE2b-256 checksum
How to use checksums
2c6e88e3715f9ca5115a333ac97dea88d4d333f4393c1334c3e9348e2df58701
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.

Transparency log

Security for libefiling 0.3.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for libefiling-0.3.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.3.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page