Silex Path Resolver
Silex is a graph-based path resolution engine for VFX and animation pipelines. It bidirectionally converts between filesystem paths, URIs, and structured context dictionaries using schema-driven segment trees and pluggable functor expressions.
The runtime is implemented as a C++17 core library with pybind11 bindings. Python consumers install the published fr-silex distribution from PyPI and import the compiled silex module, while C++ consumers can still build against silex_core and the public headers in include/silex.
Installation
Install the published package with pip:
pip install fr-silex
Import it in Python as silex:
import silex
If you are building from source locally, use a normal Python build frontend:
python -m pip install --upgrade pip build
python -m build --wheel
Quick Start
import os
os.environ["SILEX_SCHEMA_PATH"] = "/path/to/schemas"
from silex import GenericResolver, ResolverStatus, set_verbosity, Verbosity
set_verbosity(Verbosity.Info)
resolver = GenericResolver()
# Path → Context
result = resolver.context_from_path("/projects/PROJ/assets/chrBob/model/v001/scene.ma")
if result.status == ResolverStatus.SUCCESS:
print(result.context.project)
# Context → Path
result = resolver.path_from_context({"project": "PROJ", "entity": "chrBob", "fragment": "model"})
print(result.resolved_path)
Build
Build wheels and source distributions with standard Python tooling:
python -m pip install --upgrade pip build
python -m build
GitHub Actions builds wheels for Windows, Linux, and macOS, publishes tagged releases to PyPI, and publishes the generated Doxygen site to GitHub Pages.
The published distribution name is fr-silex. The Python import name remains silex.
The build also generates packaged API documentation from the public headers and documentation sources using Doxygen.
The install layout is split by consumer:
python/contains the compiledsilexextension module and any required runtime DLLs.include/,lib/, andbin/contain the public C++ headers, import library, and runtime library.docs/contains packaged manuals and generated API documentation.
Shared production schemas now live in the fr_env_config package. Reference authoring examples live in examples/.
Documentation
- Documentation Index — Release-facing documentation map
- Getting Started — Installation, setup, and first resolver flows
- API Guide — User guide with Python and C++ examples
- Schema Cookbook — Production patterns for filesystem and URI schemas
- Examples — Standalone example schemas of varying complexity
- Schema Authoring — Comprehensive guide to writing
.silexfiles - Build And Test — Local build, test, and packaging workflow
- Troubleshooting — Common resolver and schema authoring failure modes
- Generated HTML API Docs — Doxygen-generated packaged API site
- Architecture — Developer guide with diagrams and internals
- Architecture Decision Records — Design decisions and rationale
License
This project is licensed under the MIT License. See LICENSE.
Metadata
Release files for fr-silex 0.5.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| fr_silex-0.5.6.tar.gz | 201.3 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| fr_silex-0.5.6-cp311-cp311-win_amd64.whl | CPython 3.11 | CPython 3.11 | Windows x86-64 | Details |
| fr_silex-0.5.6-cp311-cp311-win32.whl | CPython 3.11 | CPython 3.11 | Windows x86-32 | Details |
| fr_silex-0.5.6-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl | CPython 3.11 | CPython 3.11 | Linux glibc 2.27+ x86-64, Linux glibc 2.28+ x86-64 | Details |
| fr_silex-0.5.6-cp311-cp311-macosx_11_0_arm64.whl | CPython 3.11 | CPython 3.11 | macOS 11.0+ ARM64 | Details |
| fr_silex-0.5.6-cp310-cp310-win_amd64.whl | CPython 3.10 | CPython 3.10 | Windows x86-64 | Details |
| fr_silex-0.5.6-cp310-cp310-win32.whl | CPython 3.10 | CPython 3.10 | Windows x86-32 | Details |
| fr_silex-0.5.6-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl | CPython 3.10 | CPython 3.10 | Linux glibc 2.27+ x86-64, Linux glibc 2.28+ x86-64 | Details |
| fr_silex-0.5.6-cp310-cp310-macosx_11_0_arm64.whl | CPython 3.10 | CPython 3.10 | macOS 11.0+ ARM64 | Details |
| fr_silex-0.5.6-cp39-cp39-win_amd64.whl | CPython 3.9 | CPython 3.9 | Windows x86-64 | Details |
| fr_silex-0.5.6-cp39-cp39-win32.whl | CPython 3.9 | CPython 3.9 | Windows x86-32 | Details |
| fr_silex-0.5.6-cp39-cp39-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl | CPython 3.9 | CPython 3.9 | Linux glibc 2.27+ x86-64, Linux glibc 2.28+ x86-64 | Details |
| fr_silex-0.5.6-cp39-cp39-macosx_11_0_arm64.whl | CPython 3.9 | CPython 3.9 | macOS 11.0+ ARM64 | Details |
Total release size: 27.7 MB
Release files / fr_silex-0.5.6.tar.gz
| Download URL | fr_silex-0.5.6.tar.gz |
|---|---|
| Size | 201.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
988934a43c91f2072a943b6c0a4b414589f831849fef9beaebc136aef5962751
|
|
BLAKE2b-256 checksum How to use checksums |
9dc36b0e4538306b05ffe9449a89141061ea0a1b78c960e16afed45cb22143fb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logRelease files / fr_silex-0.5.6-cp311-cp311-win_amd64.whl
| Download URL | fr_silex-0.5.6-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 3.2 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
d0b3e008ef6c2dcd6295e92f6a4c7ce5104ab0e2189473231ff0d40787bfbb24
|
|
BLAKE2b-256 checksum How to use checksums |
5fda42fb6024085db183c6716b37fab287abd7a13330da93cf1477a5cdc04e04
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logRelease files / fr_silex-0.5.6-cp311-cp311-win32.whl
| Download URL | fr_silex-0.5.6-cp311-cp311-win32.whl |
|---|---|
| Size | 2.9 MB |
| Tags | CPython 3.11 Windows x86-32 |
|
SHA-256 checksum How to use checksums |
c4c6f10bd904969989b73ce964352bfcccb3d2aec76b57b715b41aa684233872
|
|
BLAKE2b-256 checksum How to use checksums |
9b8fb1bdafd9009e233e85db28e474737f54780134c33e6b5d28e3a4c72872fc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logRelease files / fr_silex-0.5.6-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | fr_silex-0.5.6-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 1.9 MB |
| Tags | CPython 3.11 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
eb9100be1b725dfa4a7f3ebf071d002f88754f2784eebfa64854c2021df76e0c
|
|
BLAKE2b-256 checksum How to use checksums |
ccab0ccc3825865c5e359f056ecc952a5c23c28260f1461da561c41536677cd3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logRelease files / fr_silex-0.5.6-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | fr_silex-0.5.6-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
eb8be5dc38817f66d9bdf15ae2923691bc9002b534d5292730ff01a0815b1898
|
|
BLAKE2b-256 checksum How to use checksums |
afa6a7e68cb49f45b33efdd1f7344b2cc85dedad9f8170c43f6259832823a077
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logRelease files / fr_silex-0.5.6-cp310-cp310-win_amd64.whl
| Download URL | fr_silex-0.5.6-cp310-cp310-win_amd64.whl |
|---|---|
| Size | 3.2 MB |
| Tags | CPython 3.10 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
08033cb7442afbbef71d29062be7f7033e5f6f2a8b1688f455ef1260952ce861
|
|
BLAKE2b-256 checksum How to use checksums |
93e5856ff541557438aec4394f6cd03accd274aa0c126498a05347d76815d6ed
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logRelease files / fr_silex-0.5.6-cp310-cp310-win32.whl
| Download URL | fr_silex-0.5.6-cp310-cp310-win32.whl |
|---|---|
| Size | 2.9 MB |
| Tags | CPython 3.10 Windows x86-32 |
|
SHA-256 checksum How to use checksums |
346aca167238d4fdb62f4d843602b88d98edd2a6bb5a7234b47b1c2873a29878
|
|
BLAKE2b-256 checksum How to use checksums |
7c10a3bf58ddf59ab39eabee676938a7a6d88c26c5f5daafd654b578a9787934
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logRelease files / fr_silex-0.5.6-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | fr_silex-0.5.6-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 1.9 MB |
| Tags | CPython 3.10 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
935539cfb743893fc4183226a673c2e954fd16138883792765595a71c69bd26d
|
|
BLAKE2b-256 checksum How to use checksums |
fc02e96989f18d97882fb136926b9df0360b7a3f0c9d24b40b4ab8b10d0d3a70
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logRelease files / fr_silex-0.5.6-cp310-cp310-macosx_11_0_arm64.whl
| Download URL | fr_silex-0.5.6-cp310-cp310-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.10 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
c22c5c17fc1694c9af6579f4f357021dc911b5739339cf83e1694fb9cb3418a6
|
|
BLAKE2b-256 checksum How to use checksums |
730c7002f6c7b821ef3e561b047690442be1740c162e254939ce115a22a692d0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logRelease files / fr_silex-0.5.6-cp39-cp39-win_amd64.whl
| Download URL | fr_silex-0.5.6-cp39-cp39-win_amd64.whl |
|---|---|
| Size | 3.2 MB |
| Tags | CPython 3.9 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
d49fc07eaeb1f64ba6c58d7825b34cbf94ecfd1e226f9ac98bbf910480f81eeb
|
|
BLAKE2b-256 checksum How to use checksums |
e5ee6f693750f79b756dd9e897cc479a0b480c8d2c173679e080d4875b0fd5df
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logRelease files / fr_silex-0.5.6-cp39-cp39-win32.whl
| Download URL | fr_silex-0.5.6-cp39-cp39-win32.whl |
|---|---|
| Size | 2.9 MB |
| Tags | CPython 3.9 Windows x86-32 |
|
SHA-256 checksum How to use checksums |
9339ccef56cf382cc4e419c255abc5e378324959eb56beccea2a31d28ec36c2c
|
|
BLAKE2b-256 checksum How to use checksums |
4a534a61ce15ab5e0ee3ee699edc2ae2da38c7f574cdaf1ae8cad18627223dab
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logRelease files / fr_silex-0.5.6-cp39-cp39-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
| Download URL | fr_silex-0.5.6-cp39-cp39-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 1.9 MB |
| Tags | CPython 3.9 Linux glibc 2.27+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
3502cfd4818cce4effcb5ba3d8e2f3f479c97638a2a7f010bf49e54511edc952
|
|
BLAKE2b-256 checksum How to use checksums |
311c8022ebfa9bc4f21283a64c8f583cda058b7d36cd432ea1a89fbc374026e4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logRelease files / fr_silex-0.5.6-cp39-cp39-macosx_11_0_arm64.whl
| Download URL | fr_silex-0.5.6-cp39-cp39-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.2 MB |
| Tags | CPython 3.9 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
be354136b814958a71190d544581b59f95ca9d529c805b73e661cee180061bb5
|
|
BLAKE2b-256 checksum How to use checksums |
28416a624c83eab58c1501bde48f5d7b541ae597f8a62b8ad32a065a1bd6a8c8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency log