workforce


Nameworkforce JSON
Version 1.0.20 PyPI version JSON
download
home_pagehttps://github.com/theoportlock/workforce
SummaryRun bash commands with python multiprocessing according to a tsv file edgelist.
upload_time2024-10-31 09:13:07
maintainerNone
docs_urlNone
authorTheo Portlock
requires_python>=3.5
licenseMIT license
keywords workforce
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            =========
workforce
=========


.. image:: https://img.shields.io/pypi/v/workforce.svg
        :target: https://pypi.python.org/pypi/workforce

.. image:: https://img.shields.io/travis/theoportlock/workforce.svg
        :target: https://travis-ci.com/theoportlock/workforce

.. image:: https://readthedocs.org/projects/workforce/badge/?version=latest
        :target: https://workforce.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status


Build and run a pipeline of bash commands with python multiprocessing according to a tsv file edgelist.

* Free software: MIT license
* Documentation: https://workforce.readthedocs.io.


Installation
------------
Installation can be done with:

.. code-block:: bash

   pip install workforce

Building a workforce workflow
-----------------------------
To launch the pipeline builder, run:

.. code-block:: bash

   workforce

To open a previously constructed pipeline, run:

.. code-block:: bash

   workforce <PIPELINE.tsv>

Running workforce
-----------------
To run a sample plan from workforce github project:

.. code-block:: bash

   workforce -r example_plan.tsv

To run individual process(es) from the builder, select the process(es) in the order that you wish them to be excecuted and click the 'Run' button. The command line from where the builder was launched will display the standard output and error for each process.

Deleting processes from the project can be done by selecting a process and clicking the 'Delete' button

The simplest way to edit a process is to click the edge that the process is connected to. This will fill the 'Input' box with the connection details. You can then add a new node with those connections and delete the old process.

To import and use in a python shell, use the following command:

.. code-block:: python

   from workforce.workforce import worker
   worker("<PLAN.CSV>")

The schema should be in the format of a tsv with two columns. On the left and right column is the source and target process respectively (see example).

This is tested on mac and linux but requires work for windows integration except for wsl2


=======
History
=======

0.1.0 (2021-01-16)
------------------

* First release on PyPI.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/theoportlock/workforce",
    "name": "workforce",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.5",
    "maintainer_email": null,
    "keywords": "workforce",
    "author": "Theo Portlock",
    "author_email": "zn.tportlock@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/e1/8b/70540f3beadd4838860cc8eacfbd812eee3ddec55e836b7525de43062f13/workforce-1.0.20.tar.gz",
    "platform": null,
    "description": "=========\nworkforce\n=========\n\n\n.. image:: https://img.shields.io/pypi/v/workforce.svg\n        :target: https://pypi.python.org/pypi/workforce\n\n.. image:: https://img.shields.io/travis/theoportlock/workforce.svg\n        :target: https://travis-ci.com/theoportlock/workforce\n\n.. image:: https://readthedocs.org/projects/workforce/badge/?version=latest\n        :target: https://workforce.readthedocs.io/en/latest/?badge=latest\n        :alt: Documentation Status\n\n\nBuild and run a pipeline of bash commands with python multiprocessing according to a tsv file edgelist.\n\n* Free software: MIT license\n* Documentation: https://workforce.readthedocs.io.\n\n\nInstallation\n------------\nInstallation can be done with:\n\n.. code-block:: bash\n\n   pip install workforce\n\nBuilding a workforce workflow\n-----------------------------\nTo launch the pipeline builder, run:\n\n.. code-block:: bash\n\n   workforce\n\nTo open a previously constructed pipeline, run:\n\n.. code-block:: bash\n\n   workforce <PIPELINE.tsv>\n\nRunning workforce\n-----------------\nTo run a sample plan from workforce github project:\n\n.. code-block:: bash\n\n   workforce -r example_plan.tsv\n\nTo run individual process(es) from the builder, select the process(es) in the order that you wish them to be excecuted and click the 'Run' button. The command line from where the builder was launched will display the standard output and error for each process.\n\nDeleting processes from the project can be done by selecting a process and clicking the 'Delete' button\n\nThe simplest way to edit a process is to click the edge that the process is connected to. This will fill the 'Input' box with the connection details. You can then add a new node with those connections and delete the old process.\n\nTo import and use in a python shell, use the following command:\n\n.. code-block:: python\n\n   from workforce.workforce import worker\n   worker(\"<PLAN.CSV>\")\n\nThe schema should be in the format of a tsv with two columns. On the left and right column is the source and target process respectively (see example).\n\nThis is tested on mac and linux but requires work for windows integration except for wsl2\n\n\n=======\nHistory\n=======\n\n0.1.0 (2021-01-16)\n------------------\n\n* First release on PyPI.\n",
    "bugtrack_url": null,
    "license": "MIT license",
    "summary": "Run bash commands with python multiprocessing according to a tsv file edgelist.",
    "version": "1.0.20",
    "project_urls": {
        "Homepage": "https://github.com/theoportlock/workforce"
    },
    "split_keywords": [
        "workforce"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "fb751478a874c599aa7adc9ea1c7fcee50493917d2d11dcf8b9e92fd5554a83a",
                "md5": "56eaf556699aeff363b7beeb39de4cbe",
                "sha256": "f06eabe344d86aae2d2b381abf66b9698d5cff5701c1f9a2a31b1661fa30288e"
            },
            "downloads": -1,
            "filename": "workforce-1.0.20-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "56eaf556699aeff363b7beeb39de4cbe",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.5",
            "size": 7620,
            "upload_time": "2024-10-31T09:13:05",
            "upload_time_iso_8601": "2024-10-31T09:13:05.438455Z",
            "url": "https://files.pythonhosted.org/packages/fb/75/1478a874c599aa7adc9ea1c7fcee50493917d2d11dcf8b9e92fd5554a83a/workforce-1.0.20-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "e18b70540f3beadd4838860cc8eacfbd812eee3ddec55e836b7525de43062f13",
                "md5": "7422e284b2ac4297bee6fe76c859bd8c",
                "sha256": "1cb22bf94acc269e3e1ddfec4f9dd910920f39c8b11efeeb086e5af1e26b97b0"
            },
            "downloads": -1,
            "filename": "workforce-1.0.20.tar.gz",
            "has_sig": false,
            "md5_digest": "7422e284b2ac4297bee6fe76c859bd8c",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.5",
            "size": 1681011,
            "upload_time": "2024-10-31T09:13:07",
            "upload_time_iso_8601": "2024-10-31T09:13:07.203416Z",
            "url": "https://files.pythonhosted.org/packages/e1/8b/70540f3beadd4838860cc8eacfbd812eee3ddec55e836b7525de43062f13/workforce-1.0.20.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-10-31 09:13:07",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "theoportlock",
    "github_project": "workforce",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "workforce"
}
        
Elapsed time: 0.35674s