PHPackages rickanjilal/sym - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. rickanjilal/sym ActiveLibrary rickanjilal/sym =============== Sym client for PHP - use any language's libraries from PHP 10PythonCI passing Since Aug 7Pushed 3w agoCompare [ Source](https://github.com/RicKanjilal/sym)[ Packagist](https://packagist.org/packages/rickanjilal/sym)[ RSS](/packages/rickanjilal-sym/feed)WikiDiscussions main Synced 1w ago READMEChangelog (1)DependenciesVersions (1)Used By (0) Sym ⚡ ===== [](#sym-) ### *Every library. Every language. No walls.* [](#every-library-every-language-no-walls) [![battery](https://github.com/RicKanjilal/sym/actions/workflows/test.yml/badge.svg)](https://github.com/RicKanjilal/sym/actions/workflows/test.yml)[![matrix](https://camo.githubusercontent.com/115c6b775dcfff3b08fd674d94ad868d60faaeb4bba94f32d4ec59f0786bf5ca/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6d61747269782d383025324638305f677265656e2d3232633535653f7374796c653d666c61742d737175617265266c6162656c436f6c6f723d303030)](https://camo.githubusercontent.com/115c6b775dcfff3b08fd674d94ad868d60faaeb4bba94f32d4ec59f0786bf5ca/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6d61747269782d383025324638305f677265656e2d3232633535653f7374796c653d666c61742d737175617265266c6162656c436f6c6f723d303030)[![ecosystems](https://camo.githubusercontent.com/d4c96655ce8bd1d41720f8150ae65c07ac600ed75b5897d6821eb7c9f2ec3f93/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f65636f73797374656d732d31302d3763356366663f7374796c653d666c61742d737175617265266c6162656c436f6c6f723d303030)](https://camo.githubusercontent.com/d4c96655ce8bd1d41720f8150ae65c07ac600ed75b5897d6821eb7c9f2ec3f93/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f65636f73797374656d732d31302d3763356366663f7374796c653d666c61742d737175617265266c6162656c436f6c6f723d303030)[![license](https://camo.githubusercontent.com/ba7a63d72292a30d24aa02250cd7ca3277ba4fed0204b33e3aa8d896cb6c0be4/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d3933633566643f7374796c653d666c61742d737175617265266c6162656c436f6c6f723d303030)](https://camo.githubusercontent.com/ba7a63d72292a30d24aa02250cd7ca3277ba4fed0204b33e3aa8d896cb6c0be4/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d3933633566643f7374796c653d666c61742d737175617265266c6162656c436f6c6f723d303030) [![Ten languages, one program, same run](demo.gif)](demo.gif)*Ten languages. One program. Same run.* --- Your Python can't use Apache Lucene. Your Ruby can't touch ggplot2. Your Go can't call numpy. Says who? ``` import sym lucene = sym.java.package("org.apache.lucene") # Java's search engine np = sym.imp("numpy") # Python's own ggplot = sym.r("ggplot2") # R's finest gson = sym.java("com.google.gson.Gson")() # a LIVE Java object, held in Python # same file. same breath. ``` Not ports. Not reimplementations. **The actual libraries**, running in their own real runtimes, called from yours. The party trick: real React, from Python ---------------------------------------- [](#the-party-trick-real-react-from-python) ``` import sym React = sym.js("react") Server = sym.js("react-dom/server") page = React.createElement("h1", None, "rendered by React. called from Python. yes, really.") print(Server.renderToString(page)) # rendered by React. called from Python. yes, really. ``` That's React — the real one, from npm, running in Node — driven from a `.py` file. THE MATRIX ---------- [](#the-matrix) Every row can use every column's libraries. 80 out of 80 cells, green in CI on Linux **and** macOS. ``` java js python php ruby r perl c python ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ node ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ruby ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ rust ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ go ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ java ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ php ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ r ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ perl ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ sym ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ``` *(rows = who's asking · columns = whose library)* A Ruby script using numpy. A Go binary holding a live Java object. R calling PHP. Reproduce it yourself: ``` python3 tests/test_matrix.py ``` Install ------- [](#install) The Python package is the engine. Every other language is a thin client that finds it. ``` pip install sym-lang # the core → `import sym` + the `sym` CLI ``` ``` npm install symlang # Node cargo add sym-bridge # Rust gem install sym-lang # Ruby composer require rickanjilal/sym # PHP go get github.com/RicKanjilal/sym/clients/go # R: remotes::install_github("RicKanjilal/sym", subdir="clients/r") # Java: JitPack — com.github.RicKanjilal:sym:v0.2.0 ``` Grab libraries from any ecosystem with one command: ``` sym add numpy # pip sym add js:lodash # npm sym add java:lucene # Maven, with transitive deps sym add ruby:nokogiri # gem sym add r:ggplot2 # CRAN ``` How it actually works --------------------- [](#how-it-actually-works) No magic — a broker and a neutral format. ``` ┌──────────────┐ your program ──► │ SYM (host) │ │ the broker │ └──┬────┬───┬──┘ Symbol │ │ │ Symbol Objects │ │ │ Objects ┌───▼─┐┌─▼──┐┌▼────┐ │ JVM ││Node││ R … │ ← real runtimes, └─────┘└────┘└─────┘ launched and owned by Sym ``` - Each language runs as a **worker process** Sym launches, owns, and shuts down. - Values crossing a boundary become **Symbol Objects** — a neutral JSON form every language can read. - Live objects never move. They stay in their runtime and travel as **handles**; method calls route back to where the object lives. When your variable dies, so does the object (distributed GC). - One protocol: newline-delimited JSON, small enough to read in an evening → [`docs/BRIDGE.md`](docs/BRIDGE.md) **Ten consumers × eight providers = 80 combinations, from 18 small programs** — because nobody talks to anybody. Everybody talks to Sym. ### Honest limits (physics, not laziness) [](#honest-limits-physics-not-laziness) - The **callable surface** of a library bridges: functions, methods, objects, data. - **Environments** don't — React's browser event loop, a game engine, a framework that wants to own your process. No system crosses that, Sym included. - No callbacks (foreign code calling back into you) or cross-language inheritance yet. - Every boundary crossing is a real round trip (~0.1–1 ms). Put the hot loop *inside* the block, not across it. The test battery ---------------- [](#the-test-battery) ``` python3 tests/test_compiler.py # 19 — language core python3 tests/test_bridge.py # 21 — every ecosystem, handles, clients python3 tests/test_deep.py # 42 — unicode, 2^53 longs, error recovery, # stale handles, adversarial parsing python3 tests/test_matrix.py # 80 — every consumer × every provider showcase/run_all.sh # 10 — the same real program in ten languages ``` 172 checks + 10 programs, every push, on Linux and macOS. Workers must survive their own crashes. Bengali and emoji must cross every boundary intact. A `}` inside a string must not break the parser — it did, once, and the deep suite caught it before you could. --- Chapter two: `.sym`, the language ================================= [](#chapter-two-sym-the-language) Sym started as a language before it became a host, and the language is still here. Files use `.sym`. The compiler is Python, lives in this repo, and emits **two** things: 1. **Python** for any function that touches the Python ecosystem 2. **C shared libraries** for any function that's *pure* — only math, no Python deps You don't annotate anything. The compiler walks the AST, tags each function, routes the pure ones through C codegen, and wires them together with `ctypes`. You just run `sym run file.sym`. ### Speed you didn't ask for [](#speed-you-didnt-ask-for) TestPure PythonNative CSpeedup`fib(35)`1778 ms29 ms**62×**`sum_squares(1M)`166 ms<0.1 ms**>1000×**`count_primes(100K)`228 ms46 ms**5×**Combined1900 ms33 ms**57×**The speedup isn't the interesting part — that's just C being C. The interesting part is that you got it without writing C, choosing a decorator, or knowing it happened. ### Three syntax modes, one AST [](#three-syntax-modes-one-ast) Same program, same speed, same generated code. Pick whichever you find readable. ``` fn fibonacci(n: int) -> int # Normal if n int # Compact ? n { sym$sd { let m = sym.get("doubled").as_f64s().iter().cloned().fold(f64::MIN, f64::max); sym.set("max", J::num(m)); // compiled once, cached, native } ``` ### CLI [](#cli) ``` sym run file.sym # hybrid C+Python (default) sym run file.sym -v # verbose — shows what compiled to C sym run file.sym --emit # show generated code sym build -t native file.sym # standalone binary sym check file.sym # purity analysis report sym repl # interactive REPL sym add # install from any ecosystem ``` Why I built this ---------------- [](#why-i-built-this) I'd wanted to build a real language for years. My first attempt was [Pytson 1.0](https://github.com/RicKanjilal/Pytson1.0), in Class 5 — tutorial-following work that produced a basic interpreter. Sym is that idea five years later, with the questions I actually wanted to answer: - *Can a high-level language give native speed without the user thinking about it?* → purity analysis routes pure functions to C. - *Can syntax be a preference instead of a law?* → three modes, one AST. - *Why should a library's home language decide who's allowed to use it?* → SymBridge. That question ate the whole project, and became the headline. How this was built ------------------ [](#how-this-was-built) **I drove the design.** The three-syntax-mode architecture, hybrid Python/C compilation gated by purity analysis, the Symbol Object model, Sym-as-host-not-language, object handles, the consumer/provider split that turns 80 bridges into 18 programs — those calls are mine, usually after several wrong turns. **Most of the implementation typing was done with Claude.** I specified what each module should do, reviewed output, pushed back, and debugged. The lexer, parser, codegens, workers, and clients were collaborative. I can read all of it, modify all of it, and explain all of it. If you fork this and ask me why something works the way it does, I'll answer. The design is mine. The execution was collaborative. The understanding is mine. Roadmap ------- [](#roadmap) Shipped: ten-ecosystem bridge, Symbol Objects, live handles with distributed GC, overload scoring, universal `sym add`, the 80-cell matrix, nine package registries. Next: auto-free handles in external clients · Windows support · Java varargs · callbacks · facade libraries (`symxl`-style wrappers so `sheet["A1"]` beats fifteen lines of POI). Never (physics, not laziness): cross-language inheritance · bridging environments. License ------- [](#license) MIT. Fork it, extend it, ship something better. --- Built by [**Ric Kanjilal**](https://github.com/RicKanjilal) · Class 10 · Don Bosco School, Liluah · Kolkata *A 5-year arc from [Pytson 1.0](https://github.com/RicKanjilal/Pytson1.0) to a runtime that hosts ten ecosystems.* ### Health Score 20 — LowBetter than 12% of packages Maintenance62 Regular maintenance activity Popularity2 Limited adoption so far Community6 Small or concentrated contributor base Maturity11 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/63b586dabd7cbb606c8cb3be490a6c4a36b1454c6bf9e89c4c37753ee4d25839?d=identicon)[RicKanjilal](/maintainers/RicKanjilal) --- Top Contributors [![RicKanjilal](https://avatars.githubusercontent.com/u/106694690?v=4)](https://github.com/RicKanjilal "RicKanjilal (2 commits)") --- Tags bridgecompilercross-languagedeveloper-toolsffiinteroperabilityjavascriptjvmpolyglotprogramming-languagepythonrust ### Embed Badge ![Health badge](/badges/rickanjilal-sym/health.svg) ``` [![Health](https://phpackages.com/badges/rickanjilal-sym/health.svg)](https://phpackages.com/packages/rickanjilal-sym) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)