A lightweight, high-level python library for running asynchronous commands in docker containers and handling their input and output files.
Nothing currently! It originally stood for Cloud Compute Cannon, which this project originally contained bindings for.
Normal installation:
pyccc
works with Python 2.7 and 3.5+. In normal operation, it also requires a local version of docker running.
pip install pyccc
Dev install:
git clone https://github.com/autodesk/py-cloud-compute-cannon
pip install -e py-cloud-compute-cannon
Run an executable in a docker container:
>>> engine = pyccc.engines.Docker()
>>> job = engine.launch(image='alpine',
command='echo hello world')
>>> job.wait()
>>> job.stdout
'hello world\n'
>>> job.exitcode
0
Call a python function inside a docker container and return the result:
>>> engine = pyccc.engines.Docker()
>>> def add_one_to_it(x):
... return x+1
>>> job = engine.launch(command=pyccc.PythonCall(add_one_to_it, 5),
... image='python:3.6-alpine')
>>> job.wait()
>>> job.result
6
Currently, whatever documentation exists, exists only in docstrings.
For Job options, see pyccc.Job.__doc__
.
pyccc
is developed and maintained by the Molecular Design Toolkit project. Please see that project's CONTRIBUTING document for details.
Copyright 2016-2018 Autodesk Inc.
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.