Files
zeekay b832ba2c39 Initial Torus commit
Forked from upstream concrete (BSD-3-Clause-Clear, © 2024 ZAMA) at HEAD
ecb729bb. Modifications copyright © 2026 Lux Industries Inc.

Rebranding scope:
  - Python module concrete → torus (across frontends/torus-python)
  - Rust module concrete-* → torus-* (across frontends/torus-rust)
  - MLIR dialect concretelang → toruslang (across compilers/torus-compiler)
  - Compiler optimizer concrete-optimizer → torus-optimizer
  - Backend concrete-cpu / concrete-cuda → torus-cpu / torus-cuda
  - Wire protocol concrete-protocol → torus-protocol
  - Parameter-curves concrete-security-curves-* → torus-security-curves-*
  - Public symbols concretelib → toruslib, ConcreteLang → TorusLang
  - URLs github.com/zama-ai/concrete → github.com/luxfhe/torus
  - URLs docs.zama.ai/concrete → docs.luxfhe.com/torus

Legal compliance:
  - LICENSE.txt retains original Copyright © 2024 ZAMA verbatim (§1-§2)
  - LICENSE.txt adds modifications copyright © 2026 Lux Industries Inc.
  - §3 endorsement clause: Torus is marketed exclusively as a Lux product;
    no Zama name used in README, docs, or marketing
  - NOTICE file provides factual attribution per legal best practice
    (not endorsement; required by upstream BSD-3-Clause-Clear)

README + NOTICE rewritten from scratch with Lux brand:
  - Quick-start in Python (torus.fhe)
  - Architecture diagram showing the gen-1 vtbl integration path
    (luxcpp/gpu → lux-private/gpu-kernels for CUDA/Metal/WebGPU)
  - Scheme coverage table: TFHE (luxfi/fhe), CKKS/BGV/BFV (luxfi/lattice)
  - Lux FHE family table: Torus / TorusVM / TorusEVM / TorusML / TorusNet

Known limitations (phase-2A scope):
  - PyPI package torus-fhe not yet published; the torus Python module
    is renamed structurally but pip-installable distribution is a
    follow-up (Phase 2A.1)
  - MLIR dialect rename is text-level; the compiler-internal LLVM
    rebuild (concrete-compiler-internal-llvm-project submodule) is
    structural and works; tablegen files renamed concrete→torus but the
    generated .inc files in the source tree will regenerate at build
    time
  - backends/torus-cuda/implementation/ is an upstream submodule
    pointer to the tfhe-rs source (not fetched in the staging clone);
    the CUDA backend body is delivered out-of-tree
  - ~100 test-fixture variable names like concrete_encoded_sample
    retain "concrete" as a math term (vs symbolic); these are inside
    tests/, not the public API; cleanup is a follow-up commit
  - 295 Python `from concrete import ...` residuals in luxfhe/ml-sdk
    consumer remain; that repo's import update is Phase 2B

This commit is the seed for the luxfhe/torus repo. Push as the first
commit to a fresh GitHub repo; do not re-import upstream Zama git
history.
2026-05-29 14:16:47 -07:00

181 lines
6.1 KiB
Python

"""
Tests of `Tracer` class.
"""
import numpy as np
import pytest
from torus.fhe.dtypes import UnsignedInteger
from torus.fhe.tracing import Tracer
from torus.fhe.tracing.typing import uint4
from torus.fhe.values import EncryptedTensor
def bad_assignment(x):
"""
Function with an invalid assignment.
"""
idx = [[1, 2], [1, 2, 3], [1]]
x[idx] = 0
return x
@pytest.mark.parametrize(
"function,parameters,expected_error,expected_message",
[
pytest.param(
lambda x: np.ravel(x),
{"x": EncryptedTensor(UnsignedInteger(7), shape=(3, 2))},
RuntimeError,
"Function 'np.ravel' is not supported",
),
pytest.param(
lambda x: np.sum(x, initial=42),
{"x": EncryptedTensor(UnsignedInteger(7), shape=(3, 2))},
RuntimeError,
"Function 'np.sum' is not supported with kwarg 'initial'",
),
pytest.param(
lambda x: np.absolute(x, where=False),
{"x": EncryptedTensor(UnsignedInteger(7), shape=(1, 2, 3))},
RuntimeError,
"Function 'np.absolute' is not supported with kwarg 'where'",
),
pytest.param(
lambda x: np.multiply.outer(x, [1, 2, 3]),
{"x": EncryptedTensor(UnsignedInteger(7), shape=(4,))},
RuntimeError,
"Only __call__ hook is supported for numpy ufuncs",
),
pytest.param(
lambda x: x.astype(uint4),
{"x": EncryptedTensor(UnsignedInteger(7), shape=(4,))},
ValueError,
"`astype` method must be called with a numpy type "
"for compilation (e.g., value.astype(np.int64))",
),
pytest.param(
lambda x: x + 1 if x else x + x,
{"x": EncryptedTensor(UnsignedInteger(7), shape=())},
RuntimeError,
"Branching within circuits is not possible",
),
pytest.param(
lambda x: x[["abc", 3, 2.2, (1,)]],
{"x": EncryptedTensor(UnsignedInteger(7), shape=(3, 2))},
ValueError,
"Tracer<output=EncryptedTensor<uint7, shape=(3, 2)>> "
"cannot be indexed with ['abc', 3, 2.2, (1,)]",
),
pytest.param(
bad_assignment,
{"x": EncryptedTensor(UnsignedInteger(7), shape=(3, 2))},
ValueError,
"Tracer<output=EncryptedTensor<uint7, shape=(3, 2)>>[[[1, 2], [1, 2, 3], [1]]] "
"cannot be assigned 0",
),
],
)
def test_tracer_bad_trace(function, parameters, expected_error, expected_message):
"""
Test `trace` function of `Tracer` class with bad parameters.
"""
with pytest.raises(expected_error) as excinfo:
Tracer.trace(function, parameters)
assert str(excinfo.value) == expected_message
@pytest.mark.parametrize(
"function,parameters,expected_message",
[
pytest.param(
lambda x: x.astype(np.int8),
{"x": EncryptedTensor(UnsignedInteger(7), shape=(3, 2))},
(
"Warning: When using `value.astype(newtype)` "
"with an integer newtype, "
"only use `np.int64` as the newtype "
"to avoid unexpected overflows "
"during inputset evaluation"
),
),
pytest.param(
lambda x: x.astype(np.int16),
{"x": EncryptedTensor(UnsignedInteger(7), shape=(3, 2))},
(
"Warning: When using `value.astype(newtype)` "
"with an integer newtype, "
"only use `np.int64` as the newtype "
"to avoid unexpected overflows "
"during inputset evaluation"
),
),
pytest.param(
lambda x: x.astype(np.int32),
{"x": EncryptedTensor(UnsignedInteger(7), shape=(3, 2))},
(
"Warning: When using `value.astype(newtype)` "
"with an integer newtype, "
"only use `np.int64` as the newtype "
"to avoid unexpected overflows "
"during inputset evaluation"
),
),
pytest.param(
lambda x: x.astype(np.uint8),
{"x": EncryptedTensor(UnsignedInteger(7), shape=(3, 2))},
(
"Warning: When using `value.astype(newtype)` "
"with an integer newtype, "
"only use `np.int64` as the newtype "
"to avoid unexpected overflows "
"during inputset evaluation"
),
),
pytest.param(
lambda x: x.astype(np.uint16),
{"x": EncryptedTensor(UnsignedInteger(7), shape=(3, 2))},
(
"Warning: When using `value.astype(newtype)` "
"with an integer newtype, "
"only use `np.int64` as the newtype "
"to avoid unexpected overflows "
"during inputset evaluation"
),
),
pytest.param(
lambda x: x.astype(np.uint32),
{"x": EncryptedTensor(UnsignedInteger(7), shape=(3, 2))},
(
"Warning: When using `value.astype(newtype)` "
"with an integer newtype, "
"only use `np.int64` as the newtype "
"to avoid unexpected overflows "
"during inputset evaluation"
),
),
pytest.param(
lambda x: x.astype(np.uint64),
{"x": EncryptedTensor(UnsignedInteger(7), shape=(3, 2))},
(
"Warning: When using `value.astype(newtype)` "
"with an integer newtype, "
"only use `np.int64` as the newtype "
"to avoid unexpected overflows "
"during inputset evaluation"
),
),
],
)
def test_tracer_warning_trace(function, parameters, expected_message, capsys):
"""
Test `trace` function of `Tracer` class with parameters that result in a warning.
"""
Tracer.trace(function, parameters)
captured = capsys.readouterr()
assert captured.out.strip() == expected_message