From: M <maximedevos@telenet.be>
To: Christina O'Donnell <cdo@mutix.org>,
"guile-user@gnu.org" <guile-user@gnu.org>
Cc: "help-guix@gnu.org" <help-guix@gnu.org>
Subject: RE: Getting all symbols in a Scheme file as a list
Date: Sun, 4 Feb 2024 22:03:28 +0100 [thread overview]
Message-ID: <20240204220328.j93T2B00C1cshW70193U6r@laurent.telenet-ops.be> (raw)
In-Reply-To: <03f7199a-daf2-e070-8156-6837d7e20e32@mutix.org>
>Onderwerp: Getting all symbols in a Scheme file as a list
The following will give you a list of all the symbols (unless I made some syntax errors) (also replace ‘ by a proper quote, e-mail program is corrupting it):
(use-modules (ice-9 match))
(define (all-symbols s-exp)
(match s-exp
((? symbol? a) (list a))
((a . b) (append (all-symbols a) (all-symbols b)))
;; insert rules for vectors and arrays
[…]
(_ ‘())))
[ also open file with open-input-file, apply ‘read’ to the port and pass the result to all-symbols, in a loop, and append the results together. ].
Doesn’t seem useful for what you are mentioning later, though …
>I'm trying to write a Guile script to trace symbol definition and reference
between modules in a large Guile repo (GNU/Guix), for the purposes of large
scale refactoring.
There is no such thing as symbol definitions in Scheme – you can make symbols with symbol->string, but you can’t define a symbol to anything, symbols simply are.
You can, however, define variables, which have a symbol as name (and that name may depend on context in case of hygienic macros or renamed imports/exports in modules).
>I'm wondering how I could programmatically get all the values in a
Scheme file
as an S-expression. From the manual, I know that the REPL has meta keyword
',binding' and ',apropos'
<https://www.gnu.org/software/guile/manual/guile.html#index-apropos>
which let
you search and list all bindings in accessible to a module. These are
exactly
what I need only, since they're meta-commands, they don't produce Scheme
expressions.
>Does anyone have any pointers? Should I go down the route of,
> (open-input-pipe (string-append "guile -l" file "-c ,binding"))
>? Seems a little bit baroque to me, I'd expect a simpler way of doing
it. Any
libraries anyone knows of?
No. The quoting is incorrect when file has spaces, \, …, guile in PATH might not be the Guile that is being run, … (For the former, consider open-input-pipe*.)
You can probably find a simpler way of doing it by locating where “,binding” is implemented (in the Guile source code). It probably uses the module reflection API. This API is documented in
https://www.gnu.org/software/guile/manual/html_node/Module-System-Reflection.html
However, the documentation is incomplete – IIRC there is a procedure ‘module-bindings’ to find a list of top-level definitions, but it doesn’t seem to be documented.
To find what modules a module uses, there is module-uses, though I doubt it is reliable w.r.t. optimisation, inlining, uses of (@ (module name) variable), …
So, instead, I would propose to instead work on the Tree-IL level (https://www.gnu.org/software/guile/manual/html_node/Tree_002dIL.html). In particular, see <toplevel-define> for definitions and <module-ref>,<module-set!> for uses of other modules.
This also allows for more fine-grained information – e.g. these <module-ref> etc. objects contain the location in the source code, and if a <module-ref> is inside a <toplevel-define> then you know that it is the procedure (assuming it is a procedure) of the <toplevel-define> that uses the variable of the <module-ref>.
(See https://www.gnu.org/software/guile/manual/html_node/The-Scheme-Compiler.html for how to compile stuff – also, IIRC, the compilation procedure accepts ports instead of only S-expressions, despite what the example suggests.)
Best regards,
Maxime Devos
next prev parent reply other threads:[~2024-02-04 21:03 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2024-02-04 19:50 Getting all symbols in a Scheme file as a list Christina O'Donnell
2024-02-04 21:03 ` M [this message]
2024-02-05 13:04 ` Christina O'Donnell
2024-02-04 21:39 ` Matt Wette
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.gnu.org/software/guile/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20240204220328.j93T2B00C1cshW70193U6r@laurent.telenet-ops.be \
--to=maximedevos@telenet.be \
--cc=cdo@mutix.org \
--cc=guile-user@gnu.org \
--cc=help-guix@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).