Skip to content

Commit 255e323

Browse files
Refer to the latest version
1 parent 67129e6 commit 255e323

File tree

12 files changed

+56
-43
lines changed

12 files changed

+56
-43
lines changed

docs/content/en/codegen/api.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,12 @@ title: Codegen API Reference
55
path_segments:
66
- codegen
77
- api
8-
source_hash: 66021f3a6bbf
8+
source_hash: f5184586a04b
99
status: source
1010
permalink: /en/docs/codegen/api/
1111
---
1212

13-
This page documents the current `0.5.1` code-generation and execution APIs used by `multilingualprogramming`.
13+
This page documents the current `0.6.0` code-generation and execution APIs used by `multilingualprogramming`.
1414

1515
---
1616

@@ -172,6 +172,8 @@ Recommended helper when you call `exec()` yourself:
172172

173173
Primary WASM-facing generator. It emits WAT directly from the shared AST or from a `CoreIRProgram`.
174174

175+
As of `0.6.0`, the WAT backend covers the current stateful-class object model, dynamic dispatch, property accessors, `with`/`try`/`match` lowering, bytes literals, and the best-effort async lowering described in the upstream language repository.
176+
175177
{{snippet:codegen__api__py22}}
176178

177179
### Methods

docs/content/en/contributing/index.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,12 +4,12 @@ locale: en
44
title: Contributing & Development
55
path_segments:
66
- contributing
7-
source_hash: 246c35a74a08
7+
source_hash: 48a6c71c7442
88
status: source
99
permalink: /en/docs/contributing/
1010
---
1111

12-
This guide reflects the current `0.5.1` development workflow.
12+
This guide reflects the current `0.6.0` development workflow.
1313

1414
---
1515

@@ -97,10 +97,9 @@ python -m pytest -k "inheritance" tests/
9797

9898
## Test Suite Overview
9999

100-
According to the current local agent reference:
101-
- about 58 test files
102-
- about 1,797 tests
103-
- 2 expected skips for `rustc wasm32`-dependent execution tests
100+
According to the current upstream repository state:
101+
- 63 test files
102+
- 1,926 collected tests
104103

105104
Key files:
106105
- `tests/lexer_test.py`
@@ -112,6 +111,9 @@ Key files:
112111
- `tests/complete_features_wasm_execution_test.py`
113112
- `tests/frontend_equivalence_test.py`
114113
- `tests/regression_fixes_test.py`
114+
- `tests/wat_oop_dispatch_test.py`
115+
- `tests/wat_generator_manifest_test.py`
116+
- `tests/wat_generator_string_lambda_test.py`
115117

116118
---
117119

docs/content/en/reference/compatibility.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,15 +5,15 @@ title: Compatibility Matrix
55
path_segments:
66
- reference
77
- compatibility
8-
source_hash: 2cea4d177e8d
8+
source_hash: 5266b537e3e5
99
status: source
1010
permalink: /en/docs/reference/compatibility/
1111
---
1212

1313
This matrix defines the current compatibility baseline for `multilingual`. The source of truth is:
1414

1515
- `examples/complete_features_en.ml` and equivalents in all 17 languages
16-
- `tests/` (~1,924 tests across 63 test files)
16+
- `tests/` (1,926 collected tests across 63 test files)
1717

1818
**Target runtime**: CPython 3.12.x
1919

@@ -191,7 +191,7 @@ SOV and RTL languages can use natural word order. The surface normalizer rewrite
191191

192192
## Test Coverage
193193

194-
~1,924 tests across 63 test files:
194+
1,926 collected tests across 63 test files:
195195

196196
| Test area | Files | Description |
197197
|-----------|-------|-------------|
@@ -204,7 +204,7 @@ SOV and RTL languages can use natural word order. The surface normalizer rewrite
204204
| Critical features | 8 | Triple-quoted strings, slices, parameters, tuples, comprehensions, decorators, f-strings |
205205
| Language completeness and CLI | 8 | Augmented assignment, membership, ternary, assert, chained assignment, CLI, REPL |
206206
| Advanced language features | 23 | Loop else, yield/raise from, set comprehensions, parameter separators, f-string formatting, match guards/OR/AS, global/nonlocal, builtins, exceptions, surface normalization, extended builtins, alias resolution, starred unpacking, integration, multilingual |
207-
| WAT/WASM backend | 5 | WAT generation, OOP/inheritance in WAT, WASM execution, corpus projects (20) |
207+
| WAT/WASM backend | 8 | WAT generation, manifest/build orchestration, OOP/inheritance and dispatch in WAT, string/lambda lowering, WASM execution, corpus projects (20) |
208208
| Infrastructure | 10 | Keyword registry, AST nodes, AST printer, error messages, runtime builtins, REPL |
209209

210210
---
@@ -217,7 +217,7 @@ The following are **not** claimed as universally compatible:
217217
- Full behavioral parity with all CPython edge cases
218218
- Full third-party package/runtime ecosystem compatibility
219219
- Every advanced metaprogramming/introspection scenario
220-
- WAT `@property` setter/deleter protocol (getter fully supported; `@prop.setter` not yet lowered)
220+
- WAT `@property` deleter protocol (`@property` getter/setter are lowered; deleter handling is not documented as complete)
221221
- WAT `print` `file=` keyword argument (stdout is the only target in WAT)
222222

223223
---

docs/content/en/reference/index.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ locale: en
44
title: Language Reference
55
path_segments:
66
- reference
7-
source_hash: 7daaacafc108
7+
source_hash: "130731172631"
88
status: source
99
permalink: /en/docs/reference/
1010
---
@@ -189,17 +189,18 @@ multilingual --version
189189
| Wildcard import ||
190190
| 70+ built-in functions ||
191191
| 45+ exception types ||
192-
| Localized built-in aliases (41 concepts) ||
192+
| Localized built-in aliases (75 concepts) ||
193193
| Surface normalization (SOV/RTL languages) ||
194194

195-
**~1,797 tests across 58 test files** provide the compatibility baseline.
195+
**1,926 collected tests across 63 test files** provide the compatibility baseline.
196196

197197
---
198198

199199
## Version History
200200

201201
| Version | Highlights |
202202
|---------|-----------|
203+
| `0.6.0` | WAT/WASM stateful object model, dynamic dispatch, `@property` accessors, `with`/`try`/`match` lowering, bytes literals in WAT, expanded localized builtin aliases |
203204
| `0.5.1` | Documentation updates |
204205
| `0.5.0` | WAT/WASM OOP object model; class lowering with linear-memory bump allocator; inheritance with C3 MRO; `super()` resolution; WAT execution tests; SemanticAnalyzer plain-assignment fix |
205206
| `0.4.0` | WAT/WASM code generation; browser playground; WASM backend with 25+ Python fallbacks; 20 corpus projects |

docs/content/en/wasm/architecture.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ title: WASM Architecture
55
path_segments:
66
- wasm
77
- architecture
8-
source_hash: 3c9983c998ed
8+
source_hash: 8daba5db70bd
99
status: source
1010
permalink: /en/docs/wasm/architecture/
1111
---
@@ -18,7 +18,7 @@ The WASM infrastructure is designed around three principles: **transparent selec
1818

1919
```
2020
┌─────────────────────────────────────────────────────────────┐
21-
│ Multilingual Programming Language v0.5.1
21+
│ Multilingual Programming Language v0.6.0
2222
└─────────────────────────────────────────────────────────────┘
2323
2424
┌─────────────┴──────────────┐

docs/content/en/wasm/index.md

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ locale: en
44
title: WASM Backend
55
path_segments:
66
- wasm
7-
source_hash: 7a83161027ac
7+
source_hash: c17143ce90da
88
status: source
99
permalink: /en/docs/wasm/
1010
---
@@ -162,7 +162,7 @@ multilingual Source (.ml)
162162

163163
## WAT Language Support
164164

165-
The WAT backend supports a rich subset of the multilingual language. Unsupported constructs emit stub comments and fall back to Python.
165+
The WAT backend supports a rich subset of the multilingual language. Remaining gaps emit stub comments and fall back to Python.
166166

167167
| Construct | WAT support |
168168
|---|---|
@@ -178,8 +178,9 @@ The WAT backend supports a rich subset of the multilingual language. Unsupported
178178
| `async def` / `await` | ✓ best-effort |
179179
| Class definition (OOP) with fields | ✓ linear-memory object model |
180180
| Inheritance and `super()` | ✓ C3 MRO |
181-
| `match`/`case` (numeric/boolean) | ✓ lowered to WAT blocks |
182-
| `match`/`case` (string/complex) | stub |
181+
| `match`/`case` (numeric/boolean/string) | ✓ lowered to WAT blocks |
182+
| `match`/`case` (`None`, capture, tuple/list patterns) | ✓ best-effort |
183+
| `match`/`case` (class/complex patterns) | stub |
183184
| `print` | ✓ host import |
184185
| `abs`, `min`, `max` (n-arg) | ✓ native f64 ops |
185186
| `len` (string literal/var, list, tuple) ||
@@ -189,8 +190,10 @@ The WAT backend supports a rich subset of the multilingual language. Unsupported
189190
| `with` statement | ✓ best-effort |
190191
| Lambda expressions | ✓ lifted to named WAT functions |
191192
| List/generator comprehension over `range` ||
192-
| String concatenation, indexing, slicing | not supported |
193-
| `async for` / `async with` | not supported |
193+
| String concatenation, indexing, slicing ||
194+
| `async for` over `range()` / tracked list vars | ✓ best-effort |
195+
| `async with` | ✓ best-effort |
196+
| `async for` over arbitrary iterables | stub |
194197

195198
---
196199

docs/content/fr/contribution/index.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,12 +4,12 @@ locale: fr
44
title: Contribution et développement
55
path_segments:
66
- contribution
7-
source_hash: 246c35a74a08
7+
source_hash: 48a6c71c7442
88
status: translated
99
permalink: /fr/docs/contribution/
1010
---
1111

12-
Ce guide reflète le flux de développement actuel en `0.5.1`.
12+
Ce guide reflète le flux de développement actuel en `0.6.0`.
1313

1414
- [Documentation multilingue]({{ '/fr/docs/contribution/documentation-multilingue/' | relative_url }})
1515

@@ -60,10 +60,9 @@ python -m pytest -m wasm tests/
6060
python -m pytest -k "inheritance" tests/
6161
```
6262

63-
D'après la référence locale actuelle :
64-
- environ 58 fichiers de tests
65-
- environ 1 797 tests
66-
- 2 tests ignores attendus pour `rustc wasm32`
63+
D'après l'état actuel du dépôt amont :
64+
- 63 fichiers de tests
65+
- 1 926 tests collectés
6766

6867
Fichiers clés :
6968
- `tests/lexer_test.py`
@@ -73,6 +72,9 @@ Fichiers clés :
7372
- `tests/wat_generator_test.py`
7473
- `tests/frontend_equivalence_test.py`
7574
- `tests/regression_fixes_test.py`
75+
- `tests/wat_oop_dispatch_test.py`
76+
- `tests/wat_generator_manifest_test.py`
77+
- `tests/wat_generator_string_lambda_test.py`
7678

7779
---
7880

docs/content/fr/generation-code/api.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,12 @@ title: Référence de l'API de génération de code
55
path_segments:
66
- generation-code
77
- api
8-
source_hash: 66021f3a6bbf
8+
source_hash: f5184586a04b
99
status: translated
1010
permalink: /fr/docs/generation-code/api/
1111
---
1212

13-
Cette page documente l'API actuelle `0.5.1` de transpilation, d'exécution et de génération WAT/WASM.
13+
Cette page documente l'API actuelle `0.6.0` de transpilation, d'exécution et de génération WAT/WASM.
1414

1515
---
1616

@@ -172,6 +172,8 @@ Helper recommandé si vous utilisez `exec()` directement :
172172

173173
Générateur principal côté WASM. Il produit directement du WAT à partir de l'AST partagé ou d'un `CoreIRProgram`.
174174

175+
En `0.6.0`, le backend WAT couvre l'état actuel du modèle objet à classes stateful, le dispatch dynamique, les accesseurs de propriété, l'abaissement de `with`/`try`/`match`, les littéraux `bytes` et l'abaissement asynchrone best-effort décrit dans le dépôt amont.
176+
175177
{{snippet:codegen__api__py22}}
176178

177179
### Méthodes

docs/content/fr/references/compatibilite.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,15 +5,15 @@ title: Compatibilité
55
path_segments:
66
- references
77
- compatibilite
8-
source_hash: 2cea4d177e8d
8+
source_hash: 5266b537e3e5
99
status: translated
1010
permalink: /fr/docs/references/compatibilite/
1111
---
1212

1313
Cette matrice décrit l'état actuel de compatibilité de `multilingual`. La source de vérité repose sur :
1414

1515
- `examples/complete_features_en.ml` et ses équivalents dans les 17 langues
16-
- `tests/` (environ 1 924 tests répartis sur 63 fichiers de test)
16+
- `tests/` (1 926 tests collectés répartis sur 63 fichiers de test)
1717

1818
**Runtime cible** : CPython 3.12.x
1919

@@ -191,7 +191,7 @@ Les langues SOV et RTL peuvent utiliser un ordre de mots naturel. Le normaliseur
191191

192192
## Couverture de tests
193193

194-
Environ 1 924 tests répartis sur 63 fichiers de test :
194+
1 926 tests collectés répartis sur 63 fichiers de test :
195195

196196
| Domaine | Fichiers | Description |
197197
|-----------|-------|-------------|
@@ -204,7 +204,7 @@ Environ 1 924 tests répartis sur 63 fichiers de test :
204204
| Fonctionnalités critiques | 8 | Chaînes triple-quoted, slices, paramètres, tuples, compréhensions, décorateurs, f-strings |
205205
| Couverture du langage et CLI | 8 | Affectation augmentée, appartenance, ternaire, assert, affectation chaînée, CLI, REPL |
206206
| Fonctionnalités avancées | 23 | `loop else`, `yield from`, `raise from`, compréhensions d'ensembles, séparateurs de paramètres, formatage f-string, gardes `match`, `global`, `nonlocal`, builtins, exceptions, normalisation de surface, alias, dépaquetage étoilé, intégration |
207-
| Backend WAT / WASM | 5 | Génération WAT, POO / héritage en WAT, exécution WASM, projets corpus |
207+
| Backend WAT / WASM | 8 | Génération WAT, orchestration manifeste / build, POO / héritage / dispatch en WAT, abaissement des chaînes et des lambdas, exécution WASM, projets corpus |
208208
| Infrastructure | 10 | Registre des mots-clés, nœuds AST, AST printer, messages d'erreur, builtins runtime, REPL |
209209

210210
---
@@ -217,7 +217,7 @@ Les points suivants **ne sont pas** annoncés comme universellement compatibles
217217
- Une parité comportementale complète avec tous les cas limites de CPython
218218
- Une compatibilité complète avec tous les écosystèmes tiers
219219
- Tous les scénarios avancés de métaprogrammation / introspection
220-
- Le protocole setter/deleter de `@property` en WAT (le getter est entièrement pris en charge ; `@prop.setter` n'est pas encore abaissé)
220+
- Le protocole deleter de `@property` en WAT (les getters / setters sont abaissés ; le deleter n'est pas documenté comme complet)
221221
- L'argument nommé `file=` de `print` en WAT (seul stdout est disponible en WAT)
222222

223223
---

docs/content/fr/references/index.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ locale: fr
44
title: Référence technique
55
path_segments:
66
- references
7-
source_hash: 7daaacafc108
7+
source_hash: "130731172631"
88
status: translated
99
permalink: /fr/docs/references/
1010
---
@@ -177,14 +177,15 @@ multilingual --version
177177
| Alias localisés des fonctions intégrées ||
178178
| Normalisation de surface pour les langues SOV / RTL ||
179179

180-
Cette base de compatibilité est couverte par environ 1 797 tests répartis sur 58 fichiers.
180+
Cette base de compatibilité est couverte par 1 926 tests collectés répartis sur 63 fichiers.
181181

182182
---
183183

184184
## Historique des versions
185185

186186
| Version | Points marquants |
187187
|---------|------------------|
188+
| `0.6.0` | Modèle objet WAT/WASM stateful, dispatch dynamique, accesseurs `@property`, abaissement de `with`/`try`/`match`, littéraux `bytes` en WAT, alias localisés de builtins élargis |
188189
| `0.5.1` | Mise à jour de la documentation |
189190
| `0.5.0` | Modèle objet WAT/WASM, héritage avec MRO C3, support de `super()`, correctifs d'analyse sémantique |
190191
| `0.4.0` | Génération WAT/WASM, playground navigateur, backend WASM avec replis Python |

0 commit comments

Comments
 (0)