DSP-TOOLS Documentation
Installing dsp-tools
To install the latest version, run:
pip3 install dsp-tools
To update to the latest version run:
pip3 install --upgrade dsp-tools
🚨 If your Python version is older than ours, pip will silently install an outdated version of DSP-TOOLS.
DSP-TOOLS requires one of these Python versions:
The most recent version of DSP-TOOLS is
The dsp-tools package provides you with functionalities in the command line
to interact with the DSP-API, both remote and locally.
Additionally, it contains the xmllib which helps you construct the XML file required for a mass upload.
Where To Start?
dsp-tools provides you with the following core functionalities.
- Running a Local Stack: If you want to run your own DSP stack locally, take a look here.
- Data Modelling: There are several ways to create a data model with
dsp-tools- Take a look at the technical specification for the JSON file.
- Or take a look at our tool to convert Excel files into the JSON format.
- You can create a data model on the DSP-APP. To re-use that data model on another server you can use the CLI command described here.
- Data for Mass-Upload:
- If you want to create the XML file required for a mass-upload onto DSP, take a look at the
xmllib. - You can find an in-depth explanation of our XML file format here.
Please note, that we recommend to use the
xmlliblibrary to create the file as we will ensure interoperability between the DSP-API requirements and your input. - If you want to validate and upload your XML file take a look here. Please note, that only DaSCH employees are permitted to upload data on a production server.
- If you want to create the XML file required for a mass-upload onto DSP, take a look at the
List of CLI Commands
The following CLI Commands are available, listed here in alphabetical order.
| Command | Description | Documentation |
|---|---|---|
create |
Create a project on a server from a JSON filedsp-tools create project.json |
→ |
excel2json |
Create the project definition JSON from Excel filesdsp-tools excel2json excelfolder project.json |
→ |
excel2lists |
Create the list section of the project JSONdsp-tools excel2lists excelfolder lists.json |
→ |
excel2properties |
Create the properties section of the JSONdsp-tools excel2properties properties.xlsx properties.json |
→ |
excel2resources |
Create the resource section of the JSONdsp-tools excel2resources resources.xlsx resources.json |
→ |
get |
Retrieve a project definition JSON from a serverdsp-tools get -P 0XXX project.json |
→ |
id2iri |
Replace internal IDs with IRIs in an XML filedsp-tools id2iri new_data.xml id2iri_mapping.json |
→ |
ingest-files |
Kick off the ingest process and save the mapping CSVdsp-tools ingest-files 0XXX |
→ |
ingest-xmlupload |
Create resources from XML after files are ingesteddsp-tools ingest-xmlupload data.xml |
→ |
mapping config |
Create a mapping YAML config filedsp-tools mapping config -P 0XXX --ontology my-onto |
→ |
mapping update |
Replace external ontology mappings from an Excel filedsp-tools mapping update 0XXX-my-onto-mapping.yaml |
→ |
migration config |
Create a migration config YAML filedsp-tools migration config -P 0XXX |
→ |
migration complete |
Execute a complete migrationdsp-tools migration complete migration-0XXX.yaml |
→ |
migration export |
Download project data from the source serverdsp-tools migration export migration-0XXX.yaml |
→ |
migration import |
Import a downloaded export to another serverdsp-tools migration import migration-0XXX.yaml |
→ |
migration clean-up |
Clean up local files and server referencesdsp-tools migration clean-up migration-0XXX.yaml |
→ |
old-excel2json |
Create project definition JSON using the old Excel formatdsp-tools old-excel2json excelfolder project.json |
→ |
old-excel2lists |
Create the list section using the old Excel formatdsp-tools old-excel2lists excelfolder lists.json |
→ |
resume-xmlupload |
Resume a previously interrupted xmluploaddsp-tools resume-xmlupload |
→ |
start-stack |
Start a local DSP stackdsp-tools start-stack |
→ |
stop-stack |
Stop the local DSP stackdsp-tools stop-stack |
→ |
update-legal |
Move legal metadata onto <bitstream> attributesdsp-tools update-legal [mandatory options] data.xml |
→ |
upload-files |
Upload multimedia files referenced in an XML filedsp-tools upload-files data.xml |
→ |
validate-data |
Validate XML data against a data model on a serverdsp-tools validate-data data.xml |
→ |
xmlupload |
Create resources from an XML file on a serverdsp-tools xmlupload data.xml |
→ |
Release files for dsp-tools 19.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| dsp_tools-19.1.3.tar.gz | 355.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| dsp_tools-19.1.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 855.9 kB
Release files / dsp_tools-19.1.3.tar.gz
| Download URL | dsp_tools-19.1.3.tar.gz |
|---|---|
| Size | 355.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
141a31bcd1e36f3cbfea7de520ee95ea00be73e64df200b66f6ab6b87e9f0dbc
|
|
BLAKE2b-256 checksum How to use checksums |
35682c1386f01e5349e9082c837f203f8d1f52746e80ac384962ce64f2978ab3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.18 {"installer":{"name":"uv","version":"0.12.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / dsp_tools-19.1.3-py3-none-any.whl
| Download URL | dsp_tools-19.1.3-py3-none-any.whl |
|---|---|
| Size | 500.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d236480f638f5f9934c58af07747dfa2c65e93f05d8d07680229ace850f77968
|
|
BLAKE2b-256 checksum How to use checksums |
297ab58787881f484ea67c455b0354b91b77433d93b19749460e79fb4acfb2ec
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.18 {"installer":{"name":"uv","version":"0.12.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
