EZDXF(1)

💖 EZDXF — bestie edition 💖

okay so. ezdxf is the command launcher for the Python package "ezdxf" — it's the little front door that opens into a whole mansion of DXF tooling. come on in. 🫶

---

✨ SYNOPSIS ✨

ezdxf [-h] [-V] [-f] [-v] [--config CONFIG] [--log LOG]
{audit,draw,view,browse,browse-acis,strip,config,info,hpgl} ...

---

🌸 OPTIONS 🌸

👑 POSITIONAL ARGUMENTS

these are the subcommands, the main characters of the group chat:

• audit — audit and repair DXF files. it's giving detective energy 🔍
• draw — draw and convert DXF files by the Matplotlib backend 🎨
• view — PyQt DXF file viewer 👀
• browse — PyQt DXF structure browser, for DXF debugging and curious people. the nosy bestie command fr fr 🙈
• browse-acis — PyQt ACIS entity content browser for SAT/SAB debugging
• strip — strip comments and the THUMBNAILIMAGE section from DXF files 🧹
• config — manage config files ⚙️
• info — show information and optional stats of DXF files as loaded by ezdxf(1). and lowkey important: this may not represent the original content of the file; use ezdxf-browse(1) to see the original content. don't let it gaslight you 💀
• hpgl — view and/or convert HPGL/2 plot files to various formats

⭐ OPTIONAL ARGUMENTS

• -h, --help — show a help message and exit. the classic. the icon. 💅
• -V, --version — show version and exit
• -f, --fonts — rebuild the system font cache and print all fonts found 🔤
• -v, --verbose — give more output. the way she just keeps talking and we love her for it 🗣️
• --config CONFIG — path to a config file
• --log LOG — path to a verbose appending log, stderr logs to the standard error stream

---

🌈 ENVIRONMENT 🌈

• EZDXF_DISABLE_C_EXT — set this env var to 1 or True to disable the usage of the C-extensions. bye bye C-extensions ✨
• EZDXF_TEST_FILES — path to the ezdxf test files required by some tests. for instance the CADKit sample files should be located in the EZDXF_TEST_FILES/CADKitSamples folder. see also option ezdxf.options.test_files.
• EZDXF_CONFIG_FILE — specifies a user config file which will be loaded automatically after the default config files, at the first import of ezdxf. see the FILES section below 👇
• XDG_CONFIG_HOME — when searching for a default config file in the user home directory, ezdxf(1) follows the XDG Base Directory specification if this environment variable is set. see the FILES section.

---

🎀 FILES 🎀

so the default config files get loaded from two places: the user home directory as ~/.config/ezdxf/ezdxf.ini, and the current working directory as ./ezdxf.ini. a custom config file can be specified by the environment variable EZDXF_CONFIG_FILE. and ezdxf(1) follows the XDG Base Directory specification if the environment variable XDG_CONFIG_HOME is set. periodt. 💖

the config file loading order, in this exact order bestie:

1. user home directory: ~/.config/ezdxf/ezdxf.ini
2. current working directory: ./ezdxf.ini
3. config file specified by EZDXF_CONFIG_FILE

and here's the thing — a configuration file that is loaded later does not replace the previously loaded ones. only the existing options in the newly loaded file are added to the configuration and can overwrite existing options. it's additive, not a fresh start. no cap. 🧠

---

🔥 EXAMPLES 🔥

show the ezdxf(1) version and configuration:

$ ezdxf -Vv

ezdxf v0.16.5b0 @ d:\source\ezdxf.git\src\ezdxf
Python version: 3.9.6 (tags/v3.9.6:db3ff76, Jun 28 2021, 15:26:21) [MSC v.1929 64 bit (AMD64)]
using C-extensions: yes
using Matplotlib: yes

Configuration:
[core]
default_dimension_text_style = OpenSansCondensed-Light
test_files = D:\Source\dxftest
font_cache_directory =
load_proxy_graphics = true
store_proxy_graphics = true
log_unprocessed_tags = false
filter_invalid_xdata_group_codes = true
write_fixed_meta_data_for_testing = false
disable_c_ext = false

[browse-command]
text_editor = "C:\Program\ Files\Notepad++\notepad++.exe" "{filename}" -n{num}

Environment Variables:
EZDXF_DISABLE_C_EXT=
EZDXF_TEST_FILES=D:\Source\dxftest
EZDXF_CONFIG_FILE=

Existing Configuration Files:
C:\Users\manfred\.config\ezdxf\ezdxf.ini

look at all that output. she's thorough. she's organized. she ate. 💅✨

---

🦋 SEE ALSO 🦋

• https://pypi.org/project/ezdxf/
• ezdxf-audit(1), ezdxf-draw(1), ezdxf-view(1), ezdxf-browse(1), ezdxf-browse-acis(1), ezdxf-strip(1), ezdxf-config(1), ezdxf-info(1), ezdxf-hpgl(1)

---

and that's the whole page bestie!! 💖 this one's from May 2024, and it's the EZDXF(1) manual — go forth and slay your DXF files 🌈👑🫶