Skip to main content

CLI for remote admin of Galaxy servers

Project description

Nebulizer Logo

Command-line utilities to help with managing users, data libraries and tools in a Galaxy instance, using the Galaxy API via the Bioblend library.

https://readthedocs.org/projects/pip/badge/?version=latest https://badge.fury.io/py/nebulizer.svg https://github.com/pjbriggs/nebulizer/workflows/Python%20CI/badge.svg

Quick Start

This quick start gives some examples of using nebulizer commands to perform remote administration tasks on a Galaxy instance from the command line.

Getting Nebulizer

It is recommended to install Nebulizer via pip in a virtualenv, for example:

% virtualenv .venv
% source .venv/bin/activate
% pip install nebulizer

This will provide an executable called nebulizer with a number of subcommands for performing different tasks remotely on Galaxy instances.

Nebulizer Basics

Generally Nebulizer commands take the form:

nebulizer COMMAND GALAXY [OPTIONS]

To interact remotely with a Galaxy instance using Nebulizer requires at minimum the URL of the instance and then either an API key or a user login name.

For example to list the data libraries available on Galaxy Main:

nebulizer -k 9b376af2250818d14949b3c list_libraries https://usegalaxy.org

or

nebulizer -u USER@DOMAIN list_libraries https://usegalaxy.org

In this second case Nebulizer will prompt for the Galaxy password to authenticate the user login, unless it’s supplied via the -P option.

To store the Galaxy URL-API key pair against an alias main, to avoid needing full authentication details each time:

nebulizer add_key main https://usegalaxy.org 9b376af2250818d14949b3c

or alternatively get Nebulizer to fetch the API key itself by supplying the user login:

nebulizer -u USER@DOMAIN add_key main https://usegalaxy.org

More information on managing API keys in Nebulizer can found here.

The stored alias is then used in subsequent commands, for example to list the data libraries again it is now sufficient to do just:

nebulizer list_libraries main

The following sections contain examples of how Nebulizer might be used to perform various administrive tasks.

Nebulizer provides subcommands to perform various administrive tasks:

Managing users:

  • list_users

  • create_user

  • create_batch_users

  • create_users_from_file

  • delete_user

Managing data libraries:

  • list_libraries

  • create_library

  • create_library_folder

  • add_library_datasets

Managing tools:

  • list_tools

  • list_tool_panel

  • install_tool

  • update_tool

  • uninstall_tool

  • search_toolshed

Managing quotas:

  • quotas

  • quota_add

  • quota_mod

  • quota_del

Querying Galaxy instances:

  • ping (check if a Galaxy instance is alive)

  • config (fetch configuration for a Galaxy instance)

See the tutorial for a walkthrough some of these commands.

Contributors

Nebulizer has been developed by Peter Briggs @pjbriggs, with contributions from:

Thanks to Peter van Heuseden (@pvanheus) for porting Nebulizer into Bioconda.

Project details


Download files

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

Source Distribution

nebulizer-0.7.1.tar.gz (54.9 kB view details)

Uploaded Source

Built Distribution

nebulizer-0.7.1-py3-none-any.whl (57.5 kB view details)

Uploaded Python 3

File details

Details for the file nebulizer-0.7.1.tar.gz.

File metadata

  • Download URL: nebulizer-0.7.1.tar.gz
  • Upload date:
  • Size: 54.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.7.10

File hashes

Hashes for nebulizer-0.7.1.tar.gz
Algorithm Hash digest
SHA256 0e14c98fa256e6a5041064f575707ff3263afc09ad2619243217a48aa932e643
MD5 61709600e4c479187cf52eb612ca57e1
BLAKE2b-256 a5ffea1ac1ff5209a6c87c3d651aaba119a318350d5333986bf31c12bbbee5bd

See more details on using hashes here.

File details

Details for the file nebulizer-0.7.1-py3-none-any.whl.

File metadata

  • Download URL: nebulizer-0.7.1-py3-none-any.whl
  • Upload date:
  • Size: 57.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.7.10

File hashes

Hashes for nebulizer-0.7.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e0cbdf2d26533ee6d7649fb48514f2fb599db5591c8baa0b31d14faec8165f7a
MD5 629e43f6edf03d68869c9435bb2917d6
BLAKE2b-256 e29a8a759f4349c8b24541be402c747fceb34c885b9057174de6f220d27c2686

See more details on using hashes here.

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