Skip to main content

Arx language compiler

arxlang is the main language frontend in the ArxLang ecosystem. It provides the arx Python package and arx command for lexing, parsing, inspecting, and compiling .x source files.

Arx emits ASTx nodes and delegates semantic analysis, LLVM lowering, native runtime features, and linking to IRx.

Status: functional prototype. Supported behavior is tested, but the language and APIs are not yet production-stable.

Native Apache Arrow collections

Arx exposes data-oriented types backed by IRx's native Arrow C++ runtime:

  • tensor[T, D0, ...] uses arrow::Tensor
  • dataframe[name: T, ...] uses arrow::Table
  • series[T] uses arrow::ChunkedArray
fn main() -> i32:
  var grid: tensor[i32, 2, 2] = [[1, 2], [3, 4]]
  var rows: dataframe[id: i32, score: f64] = dataframe({
    id: [1, 2, 3],
    score: [0.5, 0.8, 1.0],
  })
  return cast(rows.nrows(), i32)

Current Tensor elements are fixed-width signed integers and floats. Current DataFrame columns are fixed-width numeric values or bool. Runtime-shaped Tensor and runtime-schema DataFrame types are parameter-only, and their dynamic index/column access remains deferred.

Install

pip install arxlang
arx --version

Building executables requires LLVM/Clang-compatible tools. Arrow-backed features also require a C++ compiler.

CLI

arx --show-tokens program.x
arx --show-ast program.x
arx --show-llvm-ir program.x
arx program.x --output-file program
arx --run program.x
arx test

Use --link-mode auto, pie, or no-pie when a platform requires an explicit linking mode.

Implemented language areas

  • explicit scalar, collection, class, and finite-union annotations
  • functions, trailing defaults, externs, and templates
  • mutable variables, assignments, casts, isinstance, and type
  • if/else, while, count loops, and list-valued for ... in
  • absolute, relative, grouped, namespace, installed-package, and stdlib imports
  • classes, inheritance, fields, methods, modifiers, and default construction
  • lists, builtin range, Tensors, DataFrames, and Series
  • Douki module/class/function/method docstrings
  • fatal assertions and compiled tests

Boundaries

Arx owns source syntax and CLI behavior. It does not define new AST node types or implement feature lowering locally: those responsibilities belong to ASTx and IRx respectively.

Documentation: https://arxlang.org

License: Apache-2.0.

Metadata

Release files for arxlang 1.25.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for arxlang 1.25.0
File Size Uploaded Provenance Actions
arxlang-1.25.0.tar.gz 91.7 kB Without provenance Details for arxlang-1.25.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for arxlang 1.25.0
File Interpreter ABI Platform Actions
arxlang-1.25.0-py3-none-any.whl Python 3 none any Details for arxlang-1.25.0-py3-none-any.whl

Total release size: 201.7 kB

Release files / arxlang-1.25.0.tar.gz

Download URL arxlang-1.25.0.tar.gz
Size 91.7 kB
Tags Source
SHA-256 checksum
How to use checksums
0571f501923083cc7525a593577a24f7d45a8a775d64bdf872d4d9773e2e2b5c
BLAKE2b-256 checksum
How to use checksums
b5803e68ae9cad2c84aa019e2e005c5914ae24894663d22a27c37577cd33b6c0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.4.2 CPython/3.10.22 Linux/6.17.0-1022-azure

Release files / arxlang-1.25.0-py3-none-any.whl

Download URL arxlang-1.25.0-py3-none-any.whl
Size 109.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f6f8bf549347b651bce3709c2c457461108207f934d9cec7bedb7d464336dfdb
BLAKE2b-256 checksum
How to use checksums
26a2f94c07d79f2d232306f4d04fd845fe1f632a95b86e8694df026b1ab3f0a7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.4.2 CPython/3.10.22 Linux/6.17.0-1022-azure

Security for arxlang 1.25.0

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.25.0 This release

2 release files No provenance

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