Skip to main content

A Python 3 library for talking to HPC clusters and supercomputers

Project description

Documentation Build Status Build Status Codacy Grade Code Coverage Requirements Status

Cerulean

Cerulean is a Python 3 library for talking to HPC clusters and supercomputers. It lets you copy files between local and SFTP filesystems using a pathlib-like API, it lets you start processes locally and remotely via SSH, and it lets you submit jobs to schedulers such as Slurm and Torque/PBS.

Documentation and Help

Cerulean can be installed as usual using pip:

pip install cerulean

Instructions on how to use Cerulean can be found in the Cerulean documentation.

Code of Conduct

Before we get to asking questions and reporting bugs, we’d like to point out that this project is governed by a code of conduct, as described in CODE_OF_CONDUCT.rst, and we expect you to adhere to it. Please be nice to your fellow humans.

Questions

If you have a question that the documentation does not answer for you, then you have found a bug in the documentation. We’d love to fix it, but we need a bit of help from you to do so. Please do the following:

  1. use the search functionality here to see if someone already filed the same issue;

  2. if your issue search did not yield any relevant results, make a new issue;

  3. apply the “Question” label; apply other labels when relevant.

We’ll answer your question, and improve the documentation where necessary. Thanks!

Bugs

Like most software, Cerulean is made by humans, and we make mistakes. If you think you’ve found a bug in Cerulean, please let us know! Reporting bugs goes as follows.

  1. Use the search functionality here to see if someone already filed the same issue.

  2. If your issue search did not yield any relevant results, make a new issue. Please explain: - what you were trying to achieve, - what you did to make that happen, - what you expected the result to be, - what happened instead. It really helps to have the actual code for a simple example that demonstrates the issue, but excerpts and error messages and a description are welcome too.

  3. Finally, apply any relevant labels to the newly created issue.

With that, we should be able to fix the problem, but we may ask for some more information if we can’t figure it out right away.

Development

More information for Cerulean developers may be found in the Cerulean documentation.

License

Copyright (c) 2018, The Netherlands eScience Center and VU University Amsterdam

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

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

cerulean-0.3.7.tar.gz (34.4 kB view details)

Uploaded Source

Built Distribution

cerulean-0.3.7-py3-none-any.whl (45.4 kB view details)

Uploaded Python 3

File details

Details for the file cerulean-0.3.7.tar.gz.

File metadata

  • Download URL: cerulean-0.3.7.tar.gz
  • Upload date:
  • Size: 34.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/50.3.0 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.6.9

File hashes

Hashes for cerulean-0.3.7.tar.gz
Algorithm Hash digest
SHA256 f04f971448285460c8e0843225cb0a75b0ed58ef7a63c684755d58a6a671022d
MD5 41c750e58cf419a78b62f0934ac8f6b3
BLAKE2b-256 dd15011201f4ac87eb6aef43a83b693b8b0de2cc8d0f190fff4ffd02337d60b9

See more details on using hashes here.

File details

Details for the file cerulean-0.3.7-py3-none-any.whl.

File metadata

  • Download URL: cerulean-0.3.7-py3-none-any.whl
  • Upload date:
  • Size: 45.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/50.3.0 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.6.9

File hashes

Hashes for cerulean-0.3.7-py3-none-any.whl
Algorithm Hash digest
SHA256 21a95d09a1db90319e86cba21c92bd6d8b187df38bb890482bb6f07ec98ea83c
MD5 9e317ad93a85c6ff92e75f13abf1e789
BLAKE2b-256 ef26fb38643aee753d212abee2b4cd6e3d6a05ec20924fbd3378af8d5e245796

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