set the title?

[r2evans]

Is your proposal related to a problem?

In a way, yes: I often have multiple R sessions running simultaneously. It would be great to be able to know from the browser tab (i.e., document.title) something about the R process I'm using.

For instance, since I use emacs/ess, the R process buffers are typically named something like *R:1:quux* where quux is the directory it was started from, and 1 is the nth R process buffer started.

With httpgd::hgd_browser(), the browser correctly opens the page, and the browser tab title says simply "httpgd", since that's what it is set to in index.html. I can go into the web-devtools object browser and change the title to something more meaningful to me in a multi-device workspace, such as:

Describe the solution you'd like

Options?

1. Since src/httpgd_webserver.cpp hard-codes that title, I don't know if it's easy to somehow make m_conf.wwwpath "per-instance", so the "index.html" could be a temporary copy of the template.

2. All that is required to do this programmatically is to somehow call

   document.title = "*R:1:quux*";

   Is it possible to send that js to the server?

3. If it's better/easier to "add an endpoint" to the server so that POSTing the string will change the title (security considerations), perhaps httpgd::hgd_settitle("*R:1:quux*") would allow me to update it more easily (than browser-console editing).

Describe alternatives you've considered

It is currently effective to manually edit the browser page in the web-browser dev console.

[nx10]

Do you think something like basename(getwd()) would be a sensible default?

[r2evans]

For my use-case, I do not. Granted, this is my use-case, but I tend to open multiple R sessions from the same base-path/project, so that would not enable differentiating them for me. I also run R sessions on remote (ssh) servers too, and I have been itching to use httpgd in that arena but the hang-bug prevented me from jumping into that last year. I'll be re-trying that now :-)

If you're keen on automating it and not allow the user to overwrite it, then some alternatives:

### hostname and port, works less well if a user is connecting to multiple different-host instances of httpgd
paste(Sys.info()["nodename"], httpgd::hgd_details()$port, sep=":")
# [1] "d2mac.local:55257"

### hostname and PID
paste(Sys.info()["nodename"], Sys.getpid(), sep="_")
# [1] "d2mac.local_93215"

ideally, though, I would prefer to be able to customize it myself.