GNU bug report logs - #78750
Add archive-visit-inner-file function

Previous Next

To reply to this bug, email your comments to 78750 AT debbugs.gnu.org.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Kenta USAMI <zonuexe <at> zonu.me>
To: bug-gnu-emacs <at> gnu.org
Subject: Add archive-visit-inner-file function
Date: Wed, 11 Jun 2025 02:18:42 +0900

[Message part 1 (text/plain, inline)]

Currently, a buffer for an archive file can be opened by selecting the
entry from archive-mode, but there is no way to access it from Lisp
without manually selecting the entry.

An API like archive-visit-inner-file, introduced in this patch, would be
useful to implement the ability to directly access an archive entry.

My use case is to be able to jump directly to classes and functions
defined in PHP scripts stored inside a Phar archive file.

- https://github.com/emacs-php/archive-phar.el
- https://www.php.net/manual/en/book.phar.php

I'm not hung up on the function names or detailed API of this patch.

[Message part 2 (text/html, inline)]

[0001-lisp-arc-mode.el-Add-archive-visit-inner-file.patch (application/octet-stream, attachment)]

Message #8 received at 78750 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Kenta USAMI <zonuexe <at> zonu.me>
Cc: 78750 <at> debbugs.gnu.org
Subject: Re: bug#78750: Add archive-visit-inner-file function
Date: Wed, 11 Jun 2025 15:13:36 +0300

> From: Kenta USAMI <zonuexe <at> zonu.me>
> Date: Wed, 11 Jun 2025 02:18:42 +0900
> 
> Currently, a buffer for an archive file can be opened by selecting the
> entry from archive-mode, but there is no way to access it from Lisp
> without manually selecting the entry.
> 
> An API like archive-visit-inner-file, introduced in this patch, would be
> useful to implement the ability to directly access an archive entry.

Thanks, sounds useful.  AFAIU, this will work with any archive
supported by arc-mode.el?

> My use case is to be able to jump directly to classes and functions
> defined in PHP scripts stored inside a Phar archive file.
> 
> - https://github.com/emacs-php/archive-phar.el
> - https://www.php.net/manual/en/book.phar.php
> 
> I'm not hung up on the function names or detailed API of this patch.

Why do we need to have "inner" in the name?  Can we call this API
archive-find-file instead?

Also, would you mind to add one or more tests for this API?

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.