Skip to main content

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)

Source distribution for biblealignlib 0.4.2
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}

Release history Release notifications | RSS feed

This release

0.4.2 This release

1 release file

0.4.1

2 release files

0.4.0

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.10

2 release files

0.2.9

2 release files

0.2.8

2 release files

0.2.7

2 release files

0.2.6

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.16

2 release files

0.1.15

2 release files

0.1.14

2 release files

0.1.13

2 release files

0.1.12

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page