Skip to content

Commit

Permalink
python: add README note about installing from source for DataMatrix s…
Browse files Browse the repository at this point in the history
…upport

See also here:
zxing-cpp#695 (comment)
  • Loading branch information
axxel committed Jan 5, 2024
1 parent 5d623be commit c97fc94
Showing 1 changed file with 9 additions and 1 deletion.
10 changes: 9 additions & 1 deletion wrappers/python/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@

[![PyPI](https://img.shields.io/pypi/v/zxing-cpp.svg)](https://pypi.org/project/zxing-cpp/)


## Installation

```bash
Expand All @@ -13,7 +14,14 @@ or
python setup.py install
```

[Note: To install via `setup.py` (or via `pip install` in case there is no pre-build wheel available for your platfor or python version), you need a suitable [build environment](https://github.com/zxing-cpp/zxing-cpp#build-instructions) including a c++ compiler.]
**Note**: To enable position independent and multi-symbol DataMatrix detection, the library needs to be compiled with a c++20 compiler. Unfortunatelly some build environments used by `cibuildwheel` to generate the binary wheels that are published on [pypi.org](https://pypi.org/project/zxing-cpp/) don't include a c++20 compiler. Best chance to enable proper DataMatrix support in that case is by installing from source:

```bash
pip install zxing-cpp --no-binary zxing-cpp
```

In that case or if there is no pre-build wheel available for your platform or python version or if you use `setup.py` directly, a suitable [build environment](https://github.com/zxing-cpp/zxing-cpp#build-instructions) including a c++ compiler is required.


## Usage

Expand Down

0 comments on commit c97fc94

Please sign in to comment.