Skip to main content

No project description provided

Project description


Python SDK and CLI Client for ServiceX


The client relies on a YAML file to obtain the URLs of different servicex deployments, as well as tokens to authenticate with the service. The file should be named .servicex and the format of this file is as follows:

  - endpoint: http://localhost:5000
    name: localhost

  - endpoint:
    name: testing4
    token: ...

default_endpoint: testing4

cache_path: /tmp/ServiceX_Client/cache-dir

The default_endpoint will be used if otherwise not specified. The cache database and downloaded files will be stored in the directory specified by cache_path.

The library will search for this file in the current working directory and then start looking in parent directories until a file is found.

Command Line Interface

When installed, the client provides a new command in your shell, servicex. This command uses a series of subcommands to work with various functions of serviceX.

Common command line arguments:

Flag Long Flag What it does
-u --url The url of the serviceX ingress
-b --backend Named backend from the .servicex file endpoints list

If neither url nor backend are specified then the client will attempt to use the default_endpoint value to determine who to talk to.


This command will list the code generators deployed.


These commands interact with transforms that have been run


List transforms associated with the current user. Add the --complete flag to only show transforms that have completed.


List the files along with their size generated by a transform. Specify the transform request id with the -t or --transform-id flag


Download the files from a transform to a local directory. Specify the transform request id with -t and the directory to download to with -d. Defaults to downloading files to the current working directory.


These commands allow you to work with the query cache maintained by the serviceX client.


Show all of the cached transforms along with the run time, code generator, and number of resulting files


Delete a specific transform from the cache. Provide the transform request ID with the -t or --transform-id arg.


Clear all of the transforms from the cache.

Project details

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

servicex-3.0.0a1.tar.gz (18.4 kB view hashes)

Uploaded Source

Built Distribution

servicex-3.0.0a1-py3-none-any.whl (38.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page