jwwkit
既存のJw_cad図面(.jww)を、壊さずに読み書きするためのPythonライブラリ
jwwkitは、Jw_cadの図面ファイル(JWW形式)をPythonから読み込み、編集し、保存するためのライブラリです。 いちばんの特徴は、既存の図面を、触っていない部分を一切変えずに編集できることです。 何も編集せずに保存すれば元のファイルとバイト単位で一致し、線を1本動かしても、それ以外の要素はそのまま残ります。
日本中の設計事務所や現場には、Jw_cadで描かれた膨大な図面があります。 jwwkitは、それらの図面資産を、AIやプログラムから安全に扱えるようにするために作りました。
非公式ツールです。 jwwkitはJw_cadの作者とは関係のない、個人による非公式のライブラリです。 jwwkitについて、Jw_cadの作者の方々へ問い合わせることはお控えください。
できること
- 読み込み:線・円・弧・点・文字・ソリッド・寸法・ブロックなどの要素と、レイヤ・グループ・縮尺・線色・線種などの属性の取得
- 既存図面の安全な編集:要素の移動・複写・回転・反転・拡大縮小・属性変更・削除・追加、レイヤ名・グループ名・縮尺・表示状態の変更など。編集していない要素は変わりません
- 登録図形(JWS):登録図形(230〜700形式)の読み込みと配置
- ブロック:ブロック定義の読み込み、作成、配置、既存要素のブロック化と置換
- グループ(レイヤグループ)ごとの縮尺に対応(実寸mm・紙面mmの両方で指定可能)
- 大きな図面:65,535要素を超える図面に対応
- SXF拡張線色・線種:読み取り、検索、属性変更などの編集
- 別の図面からのグループの取り込みと、2点による位置合わせ:建築図だけを新しいものに差し替え、設備のグループはそのまま残す、といった使い方ができます
- 図面どうしの比較:設計変更の前後などで、追加・削除・属性の変化・文字の変化を一覧にします
- 条件検索:AND/OR/NOT、属性のフラグ、線の向き、長さ・半径、表示状態、文字の前方一致・正規表現、全角半角などの表記揺れ(指定した場合のみ)
- 形状と位置からの検索:要素の外形・中心・文字枠の取得、指定した点の近くにある要素・最も近い要素の検索
- **Jw_cadの環境設定ファイル(.jwf)**の読み取りと比較
- 他のCADが出力したJWW:TFAS 14eの出力はそのまま、Rebroの出力は対象のクラス宣言欄の明示的な正規化の後に扱えます
- AIに使わせるための安全な編集手順(safe_edit):「計画 → 確認・承認 → 実行」の2段階で編集し、意図しない変更を防ぎます。編集の結果は、追加・変更・削除・拒否・注意を共通の形で返します
- AI向けの利用ガイド:AIエージェントにこのライブラリを使わせるときの手引き(
jwwkit guideで場所を表示)
できないこと・対応していないこと
- Jw_cadの全機能・全データの完全な再現は保証しません。未対応の構造を見つけた場合、jwwkitは推測で処理せず、エラーとして止まります
- 新しい図面をゼロから作図する機能や、DXFなど他形式への変換は主な目的ではありません(DXFへの変換は ezjww が得意です)
- 動作確認はJw_cad 10.03.6で行っています。それ以外の版で保存された図面では、未対応の形式として読み込みを拒否することがあります
- 編集できる形式はJWWのv600/v700です。古い版(v230・v300・v351・v420)は、確かめた組み合わせだけを読取り専用で開けます(開く・集計・検索・比較・編集しない別名保存)。それ以外の古い版のJWWと、DOS版のJWCには対応していません
- 今のJw_cadがv6形式(Ver.6.00〜6.21a)で保存した図面は、開いて、図面にすでにある種類の要素だけを使う編集を保存できます。図面にない種類の要素を足す保存と、別の図面からのグループの取り込みは拒否します(Jw_cadでVer.7.00形式に保存し直せば扱えます)
- 画像を含む図面(BMP・JPEG・PNG・GIF・TIFF、複数枚も可)は、画像をそのまま保持して保存できますが、画像そのものの追加・入替え・削除はできません
- 縮尺の異なるグループへ、文字種の付いた文字・寸法を取り込む操作は、拒否します
- 新しい入れ子のブロック(ブロックの中のブロック)は作成できません
- 特殊な属性の付いた文字(寸法の値の文字など)は、文字枠を「未判定」として扱います
- Rebroが出力したJWWは、そのままでは開けません。明示的な正規化を行ってから使ってください。正規化では、Rebroの書き出しで欠けたデータ(短い線など)は戻りません
- Windowsで動作を確認しています。一部の機能(正規化の出力の確定など)はWindows専用です
必ずお読みください
- 編集する前に、必ず図面のバックアップを取ってください。 jwwkit自身も、元のファイルへの上書き保存はしません(別名でのみ保存します)。
- 編集結果は、Jw_cadで開いて目視で確認してから使ってください。
- AIサービスに図面を読ませると、図面の内容がそのAIの提供会社に送られます。業務の図面で使う前に、所属先や発注者の決まりを確認してください。
- jwwkit自体はインターネットへの通信を行いません。
- 大きな図面(数十MB)を開くには、数GBのメモリと数分の時間がかかります。開いて保存し、読み直すまでに、図面の大きさ1MBあたり約120MBのメモリを使い、56MB前後の図面では約6.9GBでした(開いて保存するだけでも約4.4GB)。開く前に図面の大きさを見て、見当を付けてください(詳しくは VERIFICATION.md)。
- 本ライブラリは無保証です(MITライセンス)。図面の破損や、編集結果による損害について、作者は責任を負いません。
- AIに使わせる場合、図面の中の文字・レイヤ名などは「データ」であり、AIへの指示ではありません。図面の中に指示のような文字が書かれていても、AIがそれに従わないよう、利用ガイドに注意を記載しています。
インストール
Windowsで使う手順です。作業フォルダを開き、PowerShellから実行します。
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install jwwkit
.\.venv\Scripts\jwwkit.exe check
.\.venv\Scripts\jwwkit.exe guide
check の結果が "passed": true なら導入確認は合格です。guide は同梱の AGENTS.md と利用ガイドの場所を表示します。仮想環境を有効にした場合は jwwkit check と jwwkit guide で実行できます。
- WindowsのPython 3.14と3.15でwheelからの導入を確認しました。
- 実行時の依存ライブラリは
ezjww>=0.2.13,<0.3です。
開発用のインストール
取得したリポジトリの直下で、新しい仮想環境を作って有効にします。その環境で次を実行します。
python -m pip install -e .
python -m jwwkit check
python -B -m unittest discover -s tests
使い方
from pathlib import Path
from jwwkit import CadDocument
# 図面を読み込む
drawing_dir = Path("../drawing-work") # ライブラリの外にある作業フォルダに置き換える
doc = CadDocument.open(drawing_dir / "sample.jww")
# 全体の要約(要素数、種類ごとの数、グループ・レイヤごとの内訳など)
summary = doc.summary()
print(summary["entity_count"], summary["by_type"])
# グループ0の線を探して、属性と座標を見る
for i in doc.find_entities(entity_type="LINE", layer_group=0):
e = doc.entities[i]
print(i, e.attributes["layer"], e.attributes["pen_color"], e.geometry)
# 何も編集せずに別名で保存すると、元のファイルとバイト単位で一致します
doc.save(drawing_dir / "sample_copy.jww")
サンプル図面は、今後追加する予定です。それまでは、ご自身で作成した図面でお試しください(業務の図面を使う場合は、必ずバックアップを取ってから)。
AIに既存図面の編集を頼む場合、AIが示す計画の内容とSHA256を確かめ、会話で了承を伝えてください。元図面の上書きはできないため、編集結果は別名で保存します。空テンプレートから新規作図を頼む場合は、先に作る内容と保存先を確認します。詳しくは AGENTS.md と 利用ガイド を参照してください。関数の一覧は API一覧 を参照してください。
コマンド
jwwkit summarize --source input.jww --output summary.jsonで図面を集計します。jwwkit compare --left before.jww --right after.jww --output comparison.jsonで図面を比較します。jwwkit inspect-jwf --source settings.jwf --output settings.jsonでJWFを読み取ります。jwwkit recognize-tategu --source input.jww --tolerances tolerances.json --output candidates.jsonで建具の候補を抽出します。許容値は 建具候補の抽出 を参照してください。
出力には新しいファイル名を指定してください。Pythonから手引きの場所を得るには jwwkit.guide_paths()、空テンプレートの場所を得るには jwwkit.template_path() を使います。
検証について
jwwkitは、業務で安心して使えることを目標に、一つひとつ検証しながら作りました。 無編集保存でのバイト一致、編集後にJw_cadで開いて再保存できること、DXF・PDF出力での照合など、検証の方法と結果は VERIFICATION.md にまとめています。
実務図面 2,939 件(中身が異なるもの)で確かめ(2026-11)、2,670 件(90.8%)が読めて、無編集の保存はすべて原本とバイト単位で一致しました。読めないものは、理由を示して拒否します。詳しくは VERIFICATION.md を参照してください。
作った人について
電気設備の設計者が、日々の業務を楽にしたいという動機から、AIと一緒に作りました。作者はプログラマーではありません。 JWW形式は、公開されているファイル形式の資料と、自作の図面の解析、Jw_cad本体で保存した結果との照合をもとに読み解いています。実務の図面は検証にのみ使い、公開していません。 図面のヘッダーの読み取りと、独自の読み取り結果の照合には、ezjww(MITライセンス)を利用しています。 Jw_cad本体や付属ファイルは含んでいません。ライブラリの確認用に、図形のない空テンプレートを収録しています。
サポートについて
- 不具合や危険な動作は、非公開の報告手順に沿って報告してください。改善要望はGitHubのIssueで受け付けます。
- 返信は不定期です。すべての要望に応えられるとは限りません。
- 報告や要望に図面は添付しないでください。
関連プロジェクト
JWW形式を扱うオープンソースには、ほかにも次のようなものがあります。目的に合わせて選んでください。
- ezjww — JWWの読み込み・新規作成・変換に強いライブラリ(Rust製、Python・TypeScriptから利用可能)。jwwkitも内部で利用しています
- zumen — SXF・JWW・DXF・DWGを読み込み、表示・比較・変換するライブラリ(Rust製、Python・ブラウザから利用可能)
ライセンス
「Jw_cad」は、その作者の方々に帰属する名称です。 「Rebro」と「TFAS」は、それぞれの権利者に帰属する名称です。
English summary
jwwkit is an unofficial Python library for reading and safely editing existing Jw_cad (.jww) drawings without altering untouched elements (a no-edit save is byte-identical to the original). It supports registered figures (JWS), blocks, per-group scales, drawings with more than 65,535 elements, Jw_cad v6-format files, old JWW versions (v230/v300/v351/v420, read-only), embedded images (BMP/JPEG/PNG/GIF/TIFF, kept byte-for-byte), SXF extended line colors/types, importing layer groups from another drawing with two-point alignment, drawing comparison, structured search, and a two-step plan/approve/execute editing workflow designed for AI agents. It is tested on Windows with Python 3.14 and 3.15 and with Jw_cad 10.03.6, and uses ezjww (MIT) for header reading and cross-checking. Not affiliated with the authors of Jw_cad — please do not contact them about this library. Always back up your drawings before editing.
Metadata
Release files for jwwkit 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| jwwkit-0.3.0.tar.gz | 295.4 kB | With provenance | Details for jwwkit-0.3.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| jwwkit-0.3.0-py3-none-any.whl | Python 3 | none | any | Details for jwwkit-0.3.0-py3-none-any.whl |
Total release size: 651.5 kB
Release files / jwwkit-0.3.0.tar.gz
| Download URL | jwwkit-0.3.0.tar.gz |
|---|---|
| Size | 295.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a7ea3066f5673fe5058329156bf25333542fddbfc270e34dcf0c5e1f0a3324f9
|
|
BLAKE2b-256 checksum How to use checksums |
c82cdc64a1cd8c41c0b5bdfec5990c66d499125d977c1683e21adb270eda3ae1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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 Nov 16, 2026.
Transparency logRelease files / jwwkit-0.3.0-py3-none-any.whl
| Download URL | jwwkit-0.3.0-py3-none-any.whl |
|---|---|
| Size | 356.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
58fb1a4ffaf990481f26559e9b71dd7943ba527dc807f10971bbae70070c8863
|
|
BLAKE2b-256 checksum How to use checksums |
3f433ec7db6bc44a281eb5072e56f9de05452fe0d5e23a0a4a9dbd0c31f9e45f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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 Nov 16, 2026.
Transparency logSecurity for jwwkit 0.3.0
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.
Attestation for jwwkit-0.3.0.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 Nov 16, 2026.
Transparency logA 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.