Skip to content

Add the Resyntax Grimoire#785

Merged
jackfirth merged 5 commits into
masterfrom
grimoire
Jul 2, 2026
Merged

Add the Resyntax Grimoire#785
jackfirth merged 5 commits into
masterfrom
grimoire

Conversation

@jackfirth

Copy link
Copy Markdown
Owner

This PR is the start of an effort to make Resyntax's internals more understandable by documenting them. However, while this is intended to make it easier to understand Resyntax's internals, it is not intended to encourage directly relying upon them. For that reason, I've chosen to name this section "The Resyntax Grimoire", because dangerous knowledge that may doom the arrogant awaits within. I reserve the right to change any API documented in the grimoire at any time, subject to my own judgment.

@jackfirth jackfirth added the documentation Improvements or additions to documentation label Jul 2, 2026
@coveralls

Copy link
Copy Markdown

Coverage Status

coverage: 93.739% (+0.06%) from 93.684% — grimoire into master

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Resyntax analyzed 11 files in this pull request and found no issues.

jackfirth and others added 2 commits July 1, 2026 23:29
The grimoire documents that reading and expanding a file source
parameterizes the current directory to the source's parent directory,
but that parameterization only happened in source-analyze, not in the
source module itself. Now source-read-syntax, source-read-language, and
source-expand (and thus source-can-expand?) each parameterize the
current directory for file-based sources, so relative module imports
resolve correctly no matter the caller's working directory. The
existing parameterization in source-analyze stays, since it calls
expand directly rather than source-expand.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Resyntax analyzed 11 files in this pull request and found no issues.

@jackfirth jackfirth enabled auto-merge (squash) July 2, 2026 06:40
@jackfirth jackfirth merged commit 9ebf2da into master Jul 2, 2026
5 checks passed
@jackfirth jackfirth deleted the grimoire branch July 2, 2026 06:41

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Resyntax analyzed 11 files in this pull request and found no issues.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants