Troubleshooting

Symptoms

You run the command with --output-format epf, but get XML files instead:

python -m 1c_processor_generator yaml ^
  --config config.yaml ^
  --handlers-file handlers.bsl ^
  --output output/ ^
  --output-format epf

Instead of an .epf file, XML files appear in the output/ folder.

Cause

The generator couldn't find 1C Designer (1cv8.exe) on your computer. EPF compilation requires an installed and licensed 1C:Enterprise 8.3 Designer.

Solution

Step 1: Check if 1C Designer is found:

python -m 1c_processor_generator setup-1c --check

Step 2: If Designer is not found, specify the path explicitly:

python -m 1c_processor_generator yaml ^
  --config config.yaml ^
  --handlers-file handlers.bsl ^
  --output output/ ^
  --output-format epf ^
  --designer-path "C:\Program Files\1cv8\8.3.25.1394\bin\1cv8.exe"

* Replace the version (8.3.25.1394) with your installed 1C version

Or set an environment variable (once):

$env:DESIGNER_1C_PATH = "C:\Program Files\1cv8\8.3.25.1394\bin\1cv8.exe"

set DESIGNER_1C_PATH=C:\Program Files\1cv8\8.3.25.1394\bin\1cv8.exe

Step 3: If 1C is found but XML is still generated — run setup-1c to create the information base:

python -m 1c_processor_generator setup-1c

Common causes

• 1C is not installed — PRO features require a licensed 1C Designer
• 1C installed in non-standard folder — specify the path explicitly via --designer-path
• No information base — run setup-1c to create one
• Compilation error — check the log for BSL code errors

Related

• PRO Edition Documentation
• FREE vs PRO Comparison

Symptoms

When running setup-1c --check you see:

MISSING: %APPDATA%\1C\epf_compiler_cache\

When generating with --output-format epf, XML is created instead of EPF.

Cause

The information base for EPF compilation hasn't been created. The generator requires an empty 1C IB to run Designer in batch mode.

Although the generator has a fallback for automatic base creation, it may fail due to:

• Timeout — creating a temporary IB takes 10-15 seconds, may not complete on slow machines
• Designer busy — if 1C is already running, CREATEINFOBASE may fail
• Access rights — issues accessing %TEMP% or %APPDATA%

Solution

Run the base creation command once after installation:

python -m 1c_processor_generator setup-1c

This command:

• Creates an empty IB at %APPDATA%\1C\epf_compiler_cache\
• Caches the base for all subsequent compilations
• Speeds up EPF generation by 3-5 seconds

Then retry generation:

python -m 1c_processor_generator yaml ^
  --config config.yaml ^
  --handlers-file handlers.bsl ^
  --output output/ ^
  --output-format epf

Recommendation

Related

• Getting XML instead of EPF
• Quick Start Guide

Symptoms

When running any command you get an error:

ImportError: DLL load failed while importing _protected: The specified module could not be found.

Cause

Microsoft Visual C++ Redistributable is missing — a Windows system library required to run compiled Python modules (.pyd).

Commonly occurs on:

• Windows Server 2012 R2 and older versions
• "Clean" Windows installations without additional software
• Virtual machines with minimal configuration

On Windows 10/11, VC++ is usually already installed along with games, Visual Studio, Office, etc.

Solution

1. Determine Python architecture:

python -c "import struct; print(struct.calcsize('P') * 8)"

Outputs 64 for x64 or 32 for x86

2. Download and install VC++ Redistributable:

• 64-bit: vc_redist.x64.exe
• 32-bit: vc_redist.x86.exe

3. Restart your terminal and try again:

python -m 1c_processor_generator --help

Why doesn't pip install this automatically?

Related

• DLL errors or unexpected behavior
• Microsoft: Latest VC++ Redistributable

Symptoms

• DLL loading errors (ImportError: DLL load failed)
• Module not found (ModuleNotFoundError)
• Unexpected behavior after update
• Dependency version conflicts
• Commands don't work as expected

Cause

Issues may occur due to:

• Corrupted files — incomplete download or crash during installation
• Version conflict — incompatible dependencies between packages
• Pip cache — old file versions in cache
• Python update — DLLs compiled for different Python version

Solution

Perform a full reinstall:

pip uninstall 1c-processor-generator -y && pip cache purge && pip install https://github.com/SERGIUSH-UA/1c-processor-generator-pro/archive/refs/heads/master.zip

This command:

• pip uninstall -y — removes the package without confirmation
• pip cache purge — clears pip cache (important!)
• pip install ... — installs fresh version from GitHub

After reinstall:

python -m 1c_processor_generator --version
python -m 1c_processor_generator setup-1c --check

If the problem persists

• Check Python version: python --version (requires 3.10-3.14)
• Try in a new virtual environment: python -m venv venv && venv\Scripts\activate
• Check for conflicts: pip check

Related

• Installation Guide
• Report a bug