Variables Path

Variables: Path <<"path">>

Path variables create file-level dependencies by referencing other files in the project.

Syntax

<< "FROM" >>

Example

Given two files:

file.js:

import Class from '../otherfile.js';

otherfile.js:

function Class () {
  ...
}

Crodox Definition

<:import:> import <<name>> from <<"FROM".js>> <:>

The <<"FROM".js>> variable captures the file path and creates a dependency between file.js and otherfile.js. The string symbols (", ', `) do not need to be referred to in the Crodox definition - string objects get combined to an §§§ input element within the input parser.

---

File Extension Handling

The file extension specified in the variable determines how the path is captured:

<<"From".endung>>:  a/b/c.endung
=> "From" = a/b/c

<<"From">>:  a/b/c.endung
=> "From" = a/b/c.endung

When the extension is part of the variable declaration (e.g., <<"From".endung>>), it is separated from the captured path. When no extension is specified, the full path including the extension is captured.

---

Connecting Files and Variables

File variables should share the same name as the file grammar definition to establish a connection:

<~"FROM".ts~>       <<"FROM".ts>>

The file definition <~"FROM".ts~> and the path variable <<"FROM".ts>> both use "FROM" - this is how Crodox links a file reference to the correct subgrammar.

---

---

In Practice

The Basics grammar uses path variables for imports:

<~"FROM".txt~>
    <:import:> import <| <<name:up>> <||> { <<name:up>> } |> from <<"FROM".txt>> <| ; <||> \n |> <:>

In the Test_Repo, testFile.txt contains:

import { C2 } from './bridgeTest2.txt';

1. <<"FROM".txt>> captures the path ./bridgeTest2 (extension stripped)
2. Crodox matches it to the file where FROM = ./bridgeTest2 (i.e., bridgeTest2.txt)
3. The imported name C2 (:up scope) becomes available in testFile.txt
4. References like C2.F3() now resolve into bridgeTest2.txt

See Repo Analysis - Cross-file Dependencies for the full dependency chain.

---

See also: Reference Variables · Uppercase Variables · All Variables