Creating a Spotfire Package for Python Packages on the Node Manager
An installation of Spotfire Service for Python on the node manager includes a Python interpreter and a set of packages to enable using Python in Spotfire.
About this task
The package named 'spotfire' provides tools for building SPKs to share Python packages with other data function authors in an organization, or to enable Spotfire Business Authors and Consumers to use Python-enabled analyses in a web browser.
- If you are building an SPK for Linux only, then the SPK is deployed to the node manager. The packages it contains are used by data functions in analyses accessed through a web browser by Business Author and Consumer users.
- If you are building an SPK for Windows only, then the SPK can be deployed to the node manager, to other Spotfire Analyst users, or to both. Packages deployed to the node manager are used by data functions in analyses accessed through a web browser by Business Author and Consumer users. (Alternatively, you can build the SPK from an installation of Spotfire Analyst. For those details, see Creating a Spotfire Package for Python Packages from a Windows Computer.)
The package builder relies on pip, the Python command-line application to install Python packages. The package builder uses a requirements.txt file to specify the packages to include in your SPK.
By default, the file requirements.txt searches the PyPI package site for the specified package and version.- To include a package from
a different repository or in a local file path, in the
requirements.txt file, use the option
-i
or--index-url
, followed by the location URL.#example # mylib -i http://my.domain.org/lib/1.0.0/mylib/
- To include a
.whl package, in the
requirements.txt file, provide the relative path
to the package from the current working directory.
#simple-example # ./my_path/my_package.whl packaging==1.0.0
If you are building an SPK intended for the Spotfire Service for Python, then you must avoid installing packages that are already included in the installation. Installing a different version of a package that is included in the service installation can cause unexpected errors. If a package you are installing depends on or requires one of the included packages, then it is filtered out when the SPK is built. For a list of included packages, see Included Packages.
For more information about creating a requirements.txt file for your package list, see its documentation at the following location.
WARNING: Target directory <<temporary location>>/<<package>> already exists. Specify --upgrade to force replacement.
The text of the warning can vary depending on the contents of the
third-party wheel packages and operating system. This warning is from the PIP
system; for our purposes, it is of no importance and can be disregarded.
- https://pip.readthedocs.io/en/stable/user_guide/#requirements-files
- https://pip.readthedocs.io/en/stable/reference/pip_install/#requirements-file-format
This task creates an SPK for the Spotfire Service for Python, running on a node available to Spotfire Server. If you need to build a package to distribute to Spotfire Analyst users, see Python Data Functions in Spotfire®.
Perform this task from a command prompt on the Linux or Windows computer where the installed node manager includes the installation of the Spotfire Service for Python.
Before you begin
- You must have write access to the computer running the node manager where the Spotfire Service for Python is installed.
- You must have created the
file
requirements.txt containing the list of packages
to include in your SPK.
The following example specifies these packages and versions from PyPI.
####### example-requirements.txt ###### # scipy == 1.11.2 matplotlib == 3.7.2 statsmodels == 0.14.0
Procedure
Results
For an overview of the entire process, see Spotfire Server.