Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Document pnpm dlx path #580

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Document pnpm dlx path #580

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
237bc0d
Document pnpm dlx location
karlhorky Sep 19, 2024
a007bb3
Fix Windows path
karlhorky Sep 19, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 7 additions & 1 deletion docs/cli/dlx.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,14 +14,20 @@ needing to install it under another project, you can run:
pnpm dlx create-react-app ./my-app
```

This will fetch `create-react-app` from the registry and run it with the given arguments.
This will fetch `create-react-app` from the registry, download it to a temporary location (see below) and run it with the given arguments.
Copy link
Contributor

Choose a reason for hiding this comment

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

pnpm dlx will download it to the store then reflink the files from the store to the dlx cache dir. This works similar to pnpm install.

Copy link
Author

Choose a reason for hiding this comment

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

ok right, I was unsure whether this was technically 100% correct wording here. I was trying to keep the explanation simple


You may also specify which exact version of the package you'd like to use:

```
pnpm dlx create-react-app@next ./my-app
```

The temporary location of the downloaded files is:

* On Windows: **~/AppData/Local/pnpm/dlx**
* On macOS: **~/Library/Caches/pnpm/dlx**
* On Linux: **~/.cache/pnpm/dlx**
Copy link
Author

Choose a reason for hiding this comment

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

is this the correct path on Linux? I couldn't find where it was being retrieved / generated, after looking through the code in pnpm/pnpm#7835

Copy link
Contributor

Choose a reason for hiding this comment

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

The correct path should be $CACHE_DIR/dlx for all platforms. The specific values of CACHE_DIR can be found here: https://pnpm.io/npmrc#cache-dir

The short answer is yes.


## Options

### --package <name\>
Expand Down
2 changes: 1 addition & 1 deletion docs/npmrc.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -238,7 +238,7 @@ After executing a dlx command, pnpm keeps a cache that omits the installation st
* On Linux: **~/.local/share/pnpm/store**
* Type: **path**

The location where all the packages are saved on the disk.
The location where all the packages are saved on the disk (exception: [`pnpm dlx`](./cli/dlx.md)).
Copy link
Author

@karlhorky karlhorky Sep 19, 2024 •
edited
Loading

Choose a reason for hiding this comment

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

Or, another idea: also link to the cache-dir heading on the same page:

Suggested change
The location where all the packages are saved on the disk (exception: [`pnpm dlx`](./cli/dlx.md)).
The location where all the packages are saved on the disk (exception: [cache data](#cache-dir) incl. [dlx](./cli/dlx.md)).

Copy link
Contributor

Choose a reason for hiding this comment

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

There is no exception. The files for dlx are still stored in the store directory. They are reflinked or hardlinked from the store directory to the dlx cache (same as when you pnpm install on one of your Node.js projects). In fact, pnpm dlx is just pnpm install on a temporary dlx cache directory.

Suggested change
The location where all the packages are saved on the disk (exception: [`pnpm dlx`](./cli/dlx.md)).
The location where all the packages are saved on the disk.

Copy link
Author

@karlhorky karlhorky Sep 19, 2024 •
edited
Loading

Choose a reason for hiding this comment

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

if the pnpm team thinks that there is no need to clarify in this position in the docs, then feel free to remove this change of mine

I added it because I think it's common to run into the "store location" docs when searching for locations for where pnpm stores files

but users won't always be looking for these particular paths, so linking elsewhere, where other paths can be found was my aim here

Alternative

an alternative would be a single page which ONLY listed out directory paths that pnpm used (regardless of whether it's the files or symlinks), so that it's centralized in one place...

bigger PR though

Copy link
Contributor

Choose a reason for hiding this comment

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

I guess the overarching concern is when cleaning up disk spaces, the user needs to know the locations to remove?

There are 3 types of locations need to be concern about:

  • Your projects' node_modules.
  • The store directory.
  • The cache directory.

The files used by dlx are well within the 3 confines above (technically 2). And if you remove the 3 above, you should clean up dlx.

Maybe you can document the 3 locations above (if the documentation doesn't have it already). But to word it as an "exception" would confuse the users.

Copy link
Author

@karlhorky karlhorky Sep 19, 2024 •
edited
Loading

Choose a reason for hiding this comment

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

I guess the overarching concern is when cleaning up disk spaces, the user needs to know the locations to remove?

no, I wasn't concerned with cleaning up disk space

my use case (mentioned in the PR description above) is to find the location of the files that are currently running when running the dlx commands, so that I can modify the files:

I was having trouble finding the location of packages such as create-playwright when running any of these commands (I was trying to edit them to verify that my PR to create-playwright would behave as I wanted):

pnpm dlx create-playwright

pnpx create-playwright

pnpm create playwright

Copy link
Contributor

Choose a reason for hiding this comment

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

Well, dlx is still not an exception here. It still uses the same store-dir and its "projects" are still in the same cache-dir.

Copy link
Author

Choose a reason for hiding this comment

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

I didn't mean to suggest that dlx was an exception

I'm trying to describe use cases of developers who:

  1. use pnpm (maybe using --global, maybe using dlx)
  2. who want to modify the node_modules files that are currently being run

the problems I'm trying to alleviate with this PR (maybe not clear, I'll copy this above to the PR description):

these developers need to find the files. it's currently not easy and centralized to find the locations of these files.

Copy link
Contributor

Choose a reason for hiding this comment

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

it's currently not easy and centralized to find the locations of these files.

I see. You should create an issue and discuss it with @zkochan.

Copy link
Author

Choose a reason for hiding this comment

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

I edited the PR description to provide a clearer picture into the motivations.

If it needs to be copied to an issue, I can do this too.

Copy link
Contributor

Choose a reason for hiding this comment

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

If it needs to be copied to an issue, I can do this too.

I meant regarding what you said about not easy to find a centralized location that list all these locations of --global, dlx, etc. I didn't mean just dlx.


The store should be always on the same disk on which installation is happening,
so there will be one store per disk. If there is a home directory on the current
Expand Down