LogoLogo
HomeGitHub RepoBook Demo
version-3.1.10
version-3.1.10
  • Introduction
  • Installation
  • Quickstart
  • Walkthrough
    • Editing a Package
    • Uploading a Package
    • Installing a Package
    • Getting Data from a Package
    • Working with the Catalog
    • Working with a Bucket
  • Advanced Usage
    • Filtering a Package
    • .quiltignore
    • Materialization
    • Working with Manifests
    • S3 Select
  • API Reference
    • quilt3
    • quilt3.Package
    • quilt3.Bucket
    • quilt3 CLI
  • References
    • Frequently Asked Questions
    • Technical Reference
    • Contributing
    • Further Reading
Powered by GitBook
On this page
  • config(*catalog_url, **config_values)
  • delete_package(name, registry=None, top_hash=None)
  • list_package_versions(name, registry=None)
  • list_packages(registry=None)
  • search(query, limit=10)

Was this helpful?

  1. API Reference

quilt3

Quilt API

config(*catalog_url, **config_values)

Set or read the QUILT configuration.

To retrieve the current config, call directly, without arguments:

    >>> import quilt3
    >>> quilt3.config()

To trigger autoconfiguration, call with just the navigator URL:

    >>> quilt3.config('https://example.com')

To set config values, call with one or more key=value pairs:

    >>> quilt3.config(navigator_url='http://example.com',
    ...               elastic_search_url='http://example.com/queries')

Default config values can be found in quilt3.util.CONFIG_TEMPLATE.

Arguments

  • catalog_url: A (single) URL indicating a location to configure from

  • **config_values: key=value pairs to set in the config

Returns

QuiltConfig: (an ordered Mapping)

delete_package(name, registry=None, top_hash=None)

Delete a package. Deletes only the manifest entries and not the underlying files.

Arguments

  • name (str): Name of the package

  • registry (str): The registry the package will be removed from

  • top_hash (str): Optional. A package hash to delete, instead of the whole package.

list_package_versions(name, registry=None)

Lists versions of a given package.

Returns a sequence of (version, hash) of a package in a registry. If the registry is None, default to the local registry.

Arguments

  • registry(string): location of registry to load package from.

Returns

A sequence of tuples containing the named version and hash.

list_packages(registry=None)

Lists Packages in the registry.

Returns a sequence of all named packages in a registry. If the registry is None, default to the local registry.

Arguments

  • registry(string): location of registry to load package from.

Returns

A sequence of strings containing the names of the packages

search(query, limit=10)

Execute a search against the configured search endpoint.

Arguments

  • query (str): query string to search

  • limit (number): maximum number of results to return. Defaults to 10

Returns

a list of objects with the following structure:

[{
`"_id"`: <document unique id>
`"_index"`: <source index>,
`"_score"`: <relevance score>
    "_source":
`"key"`: <key of the object>,
`"size"`: <size of object in bytes>,
`"user_meta"`: <user metadata from meta= via quilt3>,
`"last_modified"`: <timestamp from ElasticSearch>,
`"updated"`: <object timestamp from S3>,
`"version_id"`: <version_id of object version>
`"_type"`: <document type>
}, ...]
PreviousS3 SelectNextquilt3.Package

Last updated 5 years ago

Was this helpful?

Query Syntax:

simple query string query