cerulean


Namecerulean JSON
Version 1.0.0 PyPI version JSON
download
home_pageNone
SummaryA Python library for talking to HPC clusters and supercomputers
upload_time2025-02-05 19:18:48
maintainerNone
docs_urlNone
authorLourens Veen
requires_python>=3.8
licenseNone
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            .. image:: https://readthedocs.org/projects/cerulean/badge/?version=master
    :target: https://cerulean.readthedocs.io/en/latest/?badge=master
    :alt: Documentation Build Status

.. image:: https://github.com/NaturalHPC/cerulean/actions/workflows/ci.yaml/badge.svg?branch=master
    :target: https://github.com/NaturalHPC/cerulean/actions
    :alt: Build 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
<https://cerulean.readthedocs.io>`_.

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:

#. use the search functionality `here
   <https://github.com/MD-Studio/cerulean/issues>`__
   to see if someone already filed the same issue;
#. if your issue search did not yield any relevant results, make a new
   issue;
#. 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.

#. Use the search functionality `here
   <https://github.com/yatiml/yatiml/issues>`_
   to see if someone already filed the same issue.
#. 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.
#. 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 <https://cerulean.readthedocs.io>`_.

License
*******

Copyright (c) 2018-2019 The Netherlands eScience Center and VU University Amsterdam
Copyright (c) 2024-2025 The Netherlands eScience Center

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.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "cerulean",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": null,
    "author": "Lourens Veen",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/16/7c/5b2dc5c021151d8b8b30b532ce0e1fa94e6d3c000f23cf1e2da20b747253/cerulean-1.0.0.tar.gz",
    "platform": null,
    "description": ".. image:: https://readthedocs.org/projects/cerulean/badge/?version=master\n    :target: https://cerulean.readthedocs.io/en/latest/?badge=master\n    :alt: Documentation Build Status\n\n.. image:: https://github.com/NaturalHPC/cerulean/actions/workflows/ci.yaml/badge.svg?branch=master\n    :target: https://github.com/NaturalHPC/cerulean/actions\n    :alt: Build Status\n\n\n################################################################################\nCerulean\n################################################################################\n\nCerulean is a Python 3 library for talking to HPC clusters and supercomputers.\nIt lets you copy files between local and SFTP filesystems using a\n``pathlib``-like API, it lets you start processes locally and remotely via SSH,\nand it lets you submit jobs to schedulers such as Slurm and Torque/PBS.\n\nDocumentation and Help\n**********************\n\nCerulean can be installed as usual using pip:\n\n`pip install cerulean`\n\nInstructions on how to use Cerulean can be found in `the Cerulean documentation\n<https://cerulean.readthedocs.io>`_.\n\nCode of Conduct\n---------------\n\nBefore we get to asking questions and reporting bugs, we'd like to point out\nthat this project is governed by a code of conduct, as described in\nCODE_OF_CONDUCT.rst, and we expect you to adhere to it. Please be nice to your\nfellow humans.\n\nQuestions\n---------\n\nIf you have a question that the documentation does not answer for you, then you\nhave found a bug in the documentation. We'd love to fix it, but we need a bit of\nhelp from you to do so. Please do the following:\n\n#. use the search functionality `here\n   <https://github.com/MD-Studio/cerulean/issues>`__\n   to see if someone already filed the same issue;\n#. if your issue search did not yield any relevant results, make a new\n   issue;\n#. apply the \"Question\" label; apply other labels when relevant.\n\nWe'll answer your question, and improve the documentation where necessary.\nThanks!\n\nBugs\n----\n\nLike most software, Cerulean is made by humans, and we make mistakes. If you\nthink you've found a bug in Cerulean, please let us know! Reporting bugs goes as\nfollows.\n\n#. Use the search functionality `here\n   <https://github.com/yatiml/yatiml/issues>`_\n   to see if someone already filed the same issue.\n#. If your issue search did not yield any relevant results, make a new issue.\n   Please explain:\n   - what you were trying to achieve,\n   - what you did to make that happen,\n   - what you expected the result to be,\n   - what happened instead.\n   It really helps to have the actual code for a simple example that\n   demonstrates the issue, but excerpts and error messages and a\n   description are welcome too.\n#. Finally, apply any relevant labels to the newly created issue.\n\nWith that, we should be able to fix the problem, but we may ask for some more\ninformation if we can't figure it out right away.\n\nDevelopment\n-----------\n\nMore information for Cerulean developers may be found in `the Cerulean\ndocumentation <https://cerulean.readthedocs.io>`_.\n\nLicense\n*******\n\nCopyright (c) 2018-2019 The Netherlands eScience Center and VU University Amsterdam\nCopyright (c) 2024-2025 The Netherlands eScience Center\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "A Python library for talking to HPC clusters and supercomputers",
    "version": "1.0.0",
    "project_urls": null,
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "97cb1e67e6b59a34d524755a180a24ac9f761d5831f9bf269c58d83aca5b4ac9",
                "md5": "d979dd3407356e2a165d415bd2321e1b",
                "sha256": "d8973826532649868dec6d870f2f9eac69b944dec7e0a1e2d9daf90424fbc8bc"
            },
            "downloads": -1,
            "filename": "cerulean-1.0.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "d979dd3407356e2a165d415bd2321e1b",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 59831,
            "upload_time": "2025-02-05T19:18:46",
            "upload_time_iso_8601": "2025-02-05T19:18:46.689828Z",
            "url": "https://files.pythonhosted.org/packages/97/cb/1e67e6b59a34d524755a180a24ac9f761d5831f9bf269c58d83aca5b4ac9/cerulean-1.0.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "167c5b2dc5c021151d8b8b30b532ce0e1fa94e6d3c000f23cf1e2da20b747253",
                "md5": "4cc0d84107cd93c5fbc880e8a5b9afb1",
                "sha256": "e5aa5ff10a3124521ea1cfe4872a858c96267edada1cc0d16e659f7a91e077c8"
            },
            "downloads": -1,
            "filename": "cerulean-1.0.0.tar.gz",
            "has_sig": false,
            "md5_digest": "4cc0d84107cd93c5fbc880e8a5b9afb1",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 50906,
            "upload_time": "2025-02-05T19:18:48",
            "upload_time_iso_8601": "2025-02-05T19:18:48.870386Z",
            "url": "https://files.pythonhosted.org/packages/16/7c/5b2dc5c021151d8b8b30b532ce0e1fa94e6d3c000f23cf1e2da20b747253/cerulean-1.0.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-02-05 19:18:48",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "cerulean"
}
        
Elapsed time: 0.43123s