biblealignlib
Biblica's Python code for working with Bible alignment data from https://github.com/Clear-Bible/Alignments .
This code is ©2024-2026 by Biblica, Inc and is licensed under CC BY SA 4.0.
Installing
Requires Python 3.11–3.13.
To use the library in another project:
pip install biblealignlib # or: uv add biblealignlib
Development
This project uses uv for dependency and environment management (it replaced Poetry as of version 0.4.1).
uv sync # install runtime + dev dependencies
uv sync --group docs # additionally install documentation dependencies
Common commands (run inside the project root):
uv run pytest # run the test suite
uv run mypy # run type checks
uv run mkdocs serve # preview the docs locally
uv run jupyter lab # run the tutorial notebooks
Configuration
biblealignlib locates alignment data relative to a CLEARROOT
directory containing local clones of the Clear-Bible repositories
(Alignments, alignments-eng, etc.). Set it in a .env file in
your working directory, or as an environment variable:
CLEARROOT=/path/to/Clear-Bible
If not set, it defaults to ~/git/Clear-Bible.
Documentation
See docs/index.md for tutorials, how-to guides, explanations, and API reference, and docs/ReleaseNotes.md for the change history.
Installing extra dependencies
eflomal
eflomal is a tool for automated alignment. It is not installed by
default because it requires a custom build.
On macOS, you may need to install additional dependencies before installing:
brew install llvm libomp
You'll need to override the CFLAGS and LDFLAGS environment variables before installing eflomal:
export CFLAGS="-Xpreprocessor -fopenmp -I${HOMEBREW_PREFIX}/opt/libomp/include -Ofast -march=native -Wall --std=gnu99 -Wno-unused-function -g"
export LDFLAGS="-Xpreprocessor -fopenmp -L${HOMEBREW_PREFIX}/opt/libomp/lib -lm -lomp"
uv pip install eflomal
Release files for biblealignlib 0.4.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| biblealignlib-0.4.2.tar.gz | 515.9 kB | Details |
Release files / biblealignlib-0.4.2.tar.gz
| Download URL | biblealignlib-0.4.2.tar.gz |
|---|---|
| Size | 515.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4fec21cf47d2ca4e4ec92615f6283d6ba3ac2db6267652437962a8d6cfd61275
|
|
BLAKE2b-256 checksum How to use checksums |
afbaf537902ad7df176ca193078a1fd1fa2e5ce86d1f7811dcaf7d2ff2f33b82
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.17 {"installer":{"name":"uv","version":"0.11.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|