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.27.1

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.27.1
File Size Uploaded Provenance Actions
arxlang-1.27.1.tar.gz 92.4 kB Without provenance Details for arxlang-1.27.1.tar.gz

Built distribution (wheel)

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

Total release size: 202.9 kB

Release files / arxlang-1.27.1.tar.gz

Download URL arxlang-1.27.1.tar.gz
Size 92.4 kB
Tags Source
SHA-256 checksum
How to use checksums
06e7c50595b78cf380631346344ae9dc1dc7240fdc7ff2d6928b1a9413a0468a
BLAKE2b-256 checksum
How to use checksums
da7b266726a6f2071b056e28cce4057f06cb7ce49df9dda919c86a3e7eb3bc4b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.5.1 CPython/3.11.18 Linux/7.0.0-1019-azure

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

Download URL arxlang-1.27.1-py3-none-any.whl
Size 110.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f72b09d1b13382813e2e78b1fc5e7b8f534adf01b75a6fcdaa5e52e59fd5ad2d
BLAKE2b-256 checksum
How to use checksums
8074fc410301a9ef5f3ec45a77e5406f4e439c7cd43bd0f153b5f5c774e0c82b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.5.1 CPython/3.11.18 Linux/7.0.0-1019-azure

Security for arxlang 1.27.1

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.27.1 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