rapydscript-ns 0.9.2 → 0.9.3

package/memory/project_string_impl.md

@@ -0,0 +1,43 @@
+---
+name: string.pyj Implementation
+description: string module (character constants, Template, Formatter) — pitfalls and design decisions
+type: project
+---
+
+## string.pyj Implementation (added 2026-05-02)
+- `src/lib/string.pyj` — character constants, `Template`, `Formatter`
+- `test/string.pyj` — unit tests; `test/unit/web-repl.js` — 3 bundle tests (bundle_string_*)
+- Language service: `'string'` added to `STDLIB_MODULES` in `src/monaco-language-service/diagnostics.js`
+
+## Character Constants
+- Built via simple Python assignments; `chr(39)` = `'`, `chr(92)` = `\`, `chr(96)` = `` ` `` avoid escaping issues in string literals
+- `whitespace = ' \t\n\r' + chr(11) + chr(12)` — chr(11)=VT, chr(12)=FF
+
+## Template
+- `substitute(mapping=None)` / `safe_substitute(mapping=None)` — accepts plain dict or ρσ_dict
+- `_tmpl_to_plain(mapping)` converts ρσ_dict (via `.jsmap`) to a plain JS object
+- `_tmpl_re` regex: `/\$(?:(\$)|\{([_a-zA-Z][_a-zA-Z0-9]*)\}|([_a-zA-Z][_a-zA-Z0-9]*)|([^]?))/g`
+- Uses `[^]?` (zero-or-one of any char) to match trailing lone `$` so substitute raises ValueError
+- `ρσ_str(val)` used for substituted values (gives 'None' for null, matching Python behavior)
+
+## Formatter
+- `format(format_string, *args)` — positional args ONLY (no **kwargs in RapydScript)
+- Named fields: use `vformat(fmt, [], {'key': val})` directly
+- `vformat` delegates to `_fmt_vformat(fmt_str, args, kwargs, self)` JS helper
+- `_fmt_get_kwarg(kwargs, key)` handles both plain objects and ρσ_dict (.jsmap)
+- `format_field` calls `format(value, format_spec)` (= `ρσ_format`) for specs; `str(value)` when empty
+- Subclassing works: override `format_field`, `convert_field`, `get_value`, `get_field`
+
+## Critical v-block Pitfall Discovered
+**v-blocks are TRULY VERBATIM — Python does NOT process escape sequences.**
+- `\n` in v-block → `\n` in JS output (which in a JS string = newline char)
+- `\\n` in v-block → `\\n` in JS output (which in a JS string = backslash+n)
+- For regex literals in v-blocks: write exactly the JS you want — `\$` → `\$` in JS regex (literal $)
+- NEVER double backslashes in v-block regex literals (unlike what an older MEMORY note implies)
+- The MEMORY note about doubling (`\\n`/`\\t`) applies when you WANT literal `\n` text in JS, not actual newlines
+
+## String.prototype .upper() in Tests
+- `String.prototype.upper` (and other Python str methods) is NOT added in the test runner context unless `from pythonize import strings` is used
+- Subclass tests that operate on string return values must use `.toUpperCase()` (native JS) not `.upper()` (Python) unless pythonize is imported
+
+**Why:** How to apply: When testing Formatter/string subclasses in .pyj test files that don't import pythonize, use `v'result.toUpperCase()'` not `result.upper()`.

package/package.json

@@ -2,7 +2,7 @@
   "name": "rapydscript-ns",
   "description": "Pythonic JavaScript that doesn't suck",
   "homepage": "https://github.com/ficocelliguy/rapydscript-ns",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "license": "BSD-2-Clause",
   "engines": {
     "node": ">=0.12.0"

package/publish.py

@@ -1,37 +1,37 @@
-#!/usr/bin/env python
-# vim:fileencoding=utf-8
-# License: BSD Copyright: 2016, Kovid Goyal <kovid at kovidgoyal.net>
-
-import subprocess
-import os
-import shutil
-import json
-
-# Load metadata
-base = os.path.dirname(os.path.abspath(__file__))
-subprocess.check_call([os.path.join(base, 'build')])
-with open('package.json', 'rb') as f:
-    m = json.load(f)
-version = m['version']
-
-# Update the files in release/ from dev/
-shutil.rmtree(os.path.join(base, 'release'))
-shutil.copytree(os.path.join(base, 'dev'), os.path.join(base, 'release'))
-subprocess.check_call(['git', 'add', os.path.join(base, 'release')])
-if subprocess.check_output(
-        'git status --porcelain --untracked-files release'.split()).strip():
-    subprocess.check_call([
-        'git', 'commit', '-m', 'Updating release build of compiler'])
-    subprocess.check_call('git push'.split())
-
-# Tag the release
-subprocess.check_call('git tag -s v{0} -m version-{0}'.format(version).split())
-subprocess.check_call(['git', 'push', 'origin', 'v'+version])
-
-# Update the web REPL
-gh_pages = os.path.join(os.path.dirname(base), 'kovidgoyal.github.io')
-subprocess.check_call([os.path.join(gh_pages, 'update-rapyd-repl.py')])
-
-# Publish to NPM
-subprocess.check_call(['npm', 'login'])
-subprocess.check_call(['npm', 'publish', base])
+#!/usr/bin/env python
+# vim:fileencoding=utf-8
+# License: BSD Copyright: 2016, Kovid Goyal <kovid at kovidgoyal.net>
+
+import subprocess
+import os
+import shutil
+import json
+
+# Load metadata
+base = os.path.dirname(os.path.abspath(__file__))
+subprocess.check_call([os.path.join(base, 'build')])
+with open('package.json', 'rb') as f:
+    m = json.load(f)
+version = m['version']
+
+# Update the files in release/ from dev/
+shutil.rmtree(os.path.join(base, 'release'))
+shutil.copytree(os.path.join(base, 'dev'), os.path.join(base, 'release'))
+subprocess.check_call(['git', 'add', os.path.join(base, 'release')])
+if subprocess.check_output(
+        'git status --porcelain --untracked-files release'.split()).strip():
+    subprocess.check_call([
+        'git', 'commit', '-m', 'Updating release build of compiler'])
+    subprocess.check_call('git push'.split())
+
+# Tag the release
+subprocess.check_call('git tag -s v{0} -m version-{0}'.format(version).split())
+subprocess.check_call(['git', 'push', 'origin', 'v'+version])
+
+# Update the web REPL
+gh_pages = os.path.join(os.path.dirname(base), 'kovidgoyal.github.io')
+subprocess.check_call([os.path.join(gh_pages, 'update-rapyd-repl.py')])
+
+# Publish to NPM
+subprocess.check_call(['npm', 'login'])
+subprocess.check_call(['npm', 'publish', base])