Find local installations of the Wolfram Language and Wolfram applications.
This crate provides:
- The
wolfram-app-discoveryRust crate (API docs) - The
wolfram-app-discoverycommand-line tool (CLI docs, Installation)
Locate the default Wolfram Language installation on this computer:
use wolfram_app_discovery::WolframApp;
let app = WolframApp::try_default()
.expect("unable to locate any Wolfram applications");
// Prints a path like:
// $InstallationDirectory: /Applications/Mathematica.app/Contents/
println!("$InstallationDirectory: {}", app.installation_directory().display());See also: WolframApp::try_default()
Locate the default Wolfram Language installation on this computer:
$ wolfram-app-discovery default
App type: Mathematica
Wolfram Language version: 13.1.0
Application directory: /Applications/Wolfram/Mathematica.appSee CommandLineHelp.md for more information on the
wolfram-app-discovery command-line interface.
Suppose you have the following C program that provides a function via the Wolfram LibraryLink interface, which you would like to compile and call from Wolfram Language:
#include "WolframLibrary.h"
/* Adds one to the input, returning the result */
DLLEXPORT int increment(
WolframLibraryData libData,
mint argc,
MArgument *args,
MArgument result
) {
mint arg = MArgument_getInteger(args[0]);
MArgument_setInteger(result, arg + 1);
return LIBRARY_NO_ERROR;
}To successfully compile this program, a C compiler will need to be able to find
the included "WolframLibrary.h" header file. We can use wolfram-app-discovery
to get the path to the appropriate directory:
# Get the LibraryLink includes directory
$ export WOLFRAM_C_INCLUDES=`wolfram-app-discovery default --raw-value library-link-c-includes-directory`And then pass that value to a C compiler:
# Invoke the C compiler
$ clang increment.c -I$WOLFRAM_C_INCLUDES -shared -o libincrementThe resulting compiled library can be loaded into Wolfram Language using
LibraryFunctionLoad
and then called:
func = LibraryFunctionLoad["~/libincrement", "increment", {Integer}, Integer];
func[5] (* Returns 6 *)Download wolfram-app-discovery releases.
Precompiled binaries for the wolfram-app-discovery command-line tool are
available for all major platforms from the GitHub Releases page.
wolfram-app-discovery can be installed using cargo
(the Rust package manager) by executing:
$ cargo install --features=cli wolfram-app-discoveryThis will install the latest version of
wolfram-app-discovery from crates.io.
The default method used to locate a Wolfram Language installation
(WolframApp::try_default()) will use the following
steps to attempt to locate any local installations, returning the first one found:
- The location specified by the
WOLFRAM_APP_DIRECTORYenvironment variable, if set. - If
wolframscriptis onPATH, use it to locate the system installation. - Check in the operating system applications directory.
Specify a particular Wolfram Language installation to use (on macOS):
$ export WOLFRAM_APP_DIRECTORY="/Applications/Mathematica.app"This environment variable is checked by both the wolfram-app-discovery library and
command-line executable.
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Wolfram applications are covered by different licensing terms than wolfram-app-discovery.
Wolfram Engine Community Edition is a free distribution of the Wolfram Language, licensed for personal and non-production use cases.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
See CONTRIBUTING.md for more information.
See Development.md for instructions on how to perform common development tasks when contributing to this project.
See Maintenance.md for instructions on how to maintain this project.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent