sci Package
===========
A Python 3 package or simply a collection of convenience and wrapper functions supporting tasks
frequently needed by scientists.
install
-------
| ``pip3 install sci`` or
| ``pip3 install --user --upgrade sci``
use the ``--user`` flag on shared computers where you do not have root access. It will install the
package in a place like ``~/.local/lib/python3.x/site-packages/sci`` . You can delete that folder
later to remove the package.
design goals
------------
1. Simplicity: wrap frequently used workflows into simple functions that make life easier for
scientists. Most import statements should move into functions (except for frequently used ones
like os, sys) to avoid confusion during autocomplete with VS Code and other IDEs.
2. Verbose but easily consumable docstrings: Docstrings are accessible via code autocomplete in IDEs
such as VS Code or Atom and through automated documentation environments such as sphinx. Each
docsting should start with an example use case for the function.
3. functional programming paradigm: While using classes is permitted we encourage writing fewer
classes and more functions (perhaps with decorators)
4. Cross-platform: The code should work on Linux (RHEL and Debian based), Windows and Mac OS X.
5. Python 3 only compatibility, Python 2.x is legacy and we do not want to invest any extra time in
it.
How to contribute your own code
-------------------------------
1. ``git clone git@github.com:FredHutch/sci-pkg.git``
2. create a new branch (eg : sci-yourname)
3. paste your function into module sci/new.py.
4. Make sure you add an example call in the first line of the doc string.
5. Add your test case to sci-pkg/sci/tests
Raw data
{
"_id": null,
"home_page": "https://github.com/FredHutch/sci-package",
"name": "Omar8few4",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "hpc,scientific computing",
"author": "Dirk Petersen",
"author_email": "dp@nowhere.com",
"download_url": "https://files.pythonhosted.org/packages/d0/49/61255848ab5499c14adc2bef56b075dd8fb872eccf95be6c8db297657a80/Omar8few4-0.1.8.tar.gz",
"platform": null,
"description": "sci Package\r\n===========\r\n\r\nA Python 3 package or simply a collection of convenience and wrapper functions supporting tasks\r\nfrequently needed by scientists.\r\n\r\ninstall\r\n-------\r\n\r\n| ``pip3 install sci`` or\r\n| ``pip3 install --user --upgrade sci``\r\n\r\nuse the ``--user`` flag on shared computers where you do not have root access. It will install the\r\npackage in a place like ``~/.local/lib/python3.x/site-packages/sci`` . You can delete that folder\r\nlater to remove the package.\r\n\r\ndesign goals\r\n------------\r\n\r\n1. Simplicity: wrap frequently used workflows into simple functions that make life easier for\r\n scientists. Most import statements should move into functions (except for frequently used ones\r\n like os, sys) to avoid confusion during autocomplete with VS Code and other IDEs.\r\n2. Verbose but easily consumable docstrings: Docstrings are accessible via code autocomplete in IDEs\r\n such as VS Code or Atom and through automated documentation environments such as sphinx. Each\r\n docsting should start with an example use case for the function.\r\n3. functional programming paradigm: While using classes is permitted we encourage writing fewer\r\n classes and more functions (perhaps with decorators)\r\n4. Cross-platform: The code should work on Linux (RHEL and Debian based), Windows and Mac OS X.\r\n5. Python 3 only compatibility, Python 2.x is legacy and we do not want to invest any extra time in\r\n it.\r\n\r\nHow to contribute your own code\r\n-------------------------------\r\n\r\n1. ``git clone git@github.com:FredHutch/sci-pkg.git``\r\n2. create a new branch (eg : sci-yourname)\r\n3. paste your function into module sci/new.py.\r\n4. Make sure you add an example call in the first line of the doc string.\r\n5. Add your test case to sci-pkg/sci/tests\r\n\r\n\r\n",
"bugtrack_url": null,
"license": "",
"summary": "a collection of convenience and wrapper functions supporting tasks frequently needed by scientists",
"version": "0.1.8",
"split_keywords": [
"hpc",
"scientific computing"
],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "d0931c0eb409153bbbf49ce02aadfdc9",
"sha256": "0c69e56d39b03a7d3eb26c740f3c3ec3f6b9015aa82d065c15b991cadb234e45"
},
"downloads": -1,
"filename": "Omar8few4-0.1.8.tar.gz",
"has_sig": false,
"md5_digest": "d0931c0eb409153bbbf49ce02aadfdc9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 19663,
"upload_time": "2022-12-29T18:56:26",
"upload_time_iso_8601": "2022-12-29T18:56:26.315290Z",
"url": "https://files.pythonhosted.org/packages/d0/49/61255848ab5499c14adc2bef56b075dd8fb872eccf95be6c8db297657a80/Omar8few4-0.1.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-29 18:56:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "FredHutch",
"github_project": "sci-package",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "omar8few4"
}
JSON
