-
-
Notifications
You must be signed in to change notification settings - Fork 5.5k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #28309 from JuliaLang/kc/bump_pkg
Bump Pkg
- Loading branch information
Showing
46 changed files
with
1,214 additions
and
404 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,9 @@ | ||
name = "Base64" | ||
uuid = "2a0f44e3-6c83-55bd-87e4-b1978d98bd5f" | ||
|
||
[extras] | ||
Test = "8dfed614-e22c-5e08-85e1-65c5234f0b40" | ||
Random = "9a3f8284-a2c9-5f02-9a11-845980a1fd5c" | ||
|
||
[targets] | ||
test = ["Test", "Random"] |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,9 @@ | ||
name = "CRC32c" | ||
uuid = "8bf52ea8-c179-5cab-976a-9e18b702a9bc" | ||
|
||
[extras] | ||
Test = "8dfed614-e22c-5e08-85e1-65c5234f0b40" | ||
Random = "9a3f8284-a2c9-5f02-9a11-845980a1fd5c" | ||
|
||
[targets] | ||
test = ["Test", "Random"] |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,8 @@ | ||
name = "FileWatching" | ||
uuid = "7b1f6079-737a-58dc-b8bc-7a2ca5c1b5ee" | ||
|
||
[extras] | ||
Test = "8dfed614-e22c-5e08-85e1-65c5234f0b40" | ||
|
||
[targets] | ||
test = ["Test"] |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,11 @@ | ||
name = "LibGit2" | ||
uuid = "76f85450-5226-5b5a-8eaa-529ad045b433" | ||
|
||
[extras] | ||
Test = "8dfed614-e22c-5e08-85e1-65c5234f0b40" | ||
Random = "9a3f8284-a2c9-5f02-9a11-845980a1fd5c" | ||
Serialization = "9e88b42a-f829-5b0c-bbe9-9e923198166b" | ||
Sockets = "6462fe0b-24de-5631-8697-dd941f90decc" | ||
|
||
[targets] | ||
test = ["Test", "Random", "Serialization", "Sockets"] |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,8 @@ | ||
name = "Libdl" | ||
uuid = "8f399da3-3557-5675-b5ff-fb832c97cbdb" | ||
|
||
[extras] | ||
Test = "8dfed614-e22c-5e08-85e1-65c5234f0b40" | ||
|
||
[targets] | ||
test = ["Test"] |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,8 @@ | ||
name = "Logging" | ||
uuid = "56ddb016-857b-54e1-b83d-db4d58db5568" | ||
|
||
[extras] | ||
Test = "8dfed614-e22c-5e08-85e1-65c5234f0b40" | ||
|
||
[targets] | ||
test = ["Test"] |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,9 @@ | ||
name = "Mmap" | ||
uuid = "a63ad114-7e13-5084-954f-fe012c677804" | ||
|
||
[extras] | ||
Test = "8dfed614-e22c-5e08-85e1-65c5234f0b40" | ||
Random = "9a3f8284-a2c9-5f02-9a11-845980a1fd5c" | ||
|
||
[targets] | ||
test = ["Test", "Random"] |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -193,6 +193,9 @@ Since we haven't created our own project yet, we are in the default project, loc | |
|
||
To return to the `julia>` prompt, either press backspace when the input line is empty or press Ctrl+C. | ||
Help is available by calling `pkg> help`. | ||
If you are in an environment that does not have access to a REPL you can still use the REPL mode commands using | ||
the string macro `pkg` available after `using Pkg`. The command `pkg"cmd"` would be equivalent to executing `cmd` | ||
in the REPL mode. | ||
|
||
The documentation here describes using Pkg from the REPL mode. Documentation of using | ||
the Pkg API (by calling `Pkg.` functions) is in progress of being written. | ||
|
@@ -356,6 +359,7 @@ Note the info message saying that it is using the existing path. This means that | |
an already developed package. | ||
|
||
If `dev` is used on a local path, that path to that package is recorded and used when loading that package. | ||
The path will be recorded relative to the project file, unless it is given as an absolute path. | ||
|
||
To stop tracking a path and use the registered version again, use `free` | ||
|
||
|
@@ -689,13 +693,18 @@ Testing... | |
|
||
#### Test-specific dependencies | ||
|
||
Sometimes one might want to use some packages only at testing time but not enforce a dependency on them when the package is used. | ||
This is possible by adding dependencies to a "test target" to the Project file. Here we add the `Test` standard library as a | ||
test-only dependency by adding the following to the Project file: | ||
Sometimes one might want to use some packages only at testing time but not | ||
enforce a dependency on them when the package is used. This is possible by | ||
adding `[extra]` dependencies and adding a a "test target" to the Project file. | ||
Here we add the `Test` standard library as a test-only dependency by adding the | ||
following to the Project file: | ||
|
||
``` | ||
[targets.test.deps] | ||
[extras] | ||
Test = "8dfed614-e22c-5e08-85e1-65c5234f0b40" | ||
[targets] | ||
test = ["Test"] | ||
``` | ||
|
||
We can now use `Test` in the test script and we can see that it gets installed on testing: | ||
|
@@ -826,3 +835,30 @@ Simply clone their project using e.g. `git clone`, `cd` to the project directory | |
|
||
If the project contains a manifest, this will install the packages in the same state that is given by that manifest. | ||
Otherwise, it will resolve the latest versions of the dependencies compatible with the project. | ||
|
||
## References | ||
|
||
This section describes the "API mode" of interacting with Pkg.jl which is recommended for non-interactive usage, | ||
in i.e. scripts. In the REPL mode packages (with associated version, UUID, URL etc) are parsed from strings, | ||
for example, `"Package#master"`,`"[email protected]"`, `"www.mypkg.com/MyPkg#my/feature"`. | ||
It is possible to use strings as arguments for simple commands in the API mode (like `Pkg.add(["PackageA", "PackageB"])`, | ||
more complicated commands, that e.g. specify URLs or version range, uses a more structured format over strings. | ||
This is done by creating an instance of a [`PackageSpec`](@ref) which are passed in to functions. | ||
|
||
```@docs | ||
PackageSpec | ||
PackageMode | ||
UpgradeLevel | ||
Pkg.add | ||
Pkg.develop | ||
Pkg.activate | ||
Pkg.rm | ||
Pkg.update | ||
Pkg.test | ||
Pkg.build | ||
Pkg.pin | ||
Pkg.free | ||
Pkg.instantiate | ||
Pkg.resolve | ||
Pkg.setprotocol! | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.