SpiNNUtils
==========
This provides basic utility functions and classes to other parts of SpiNNaker's
tooling. Nothing in here knows anything about SpiNNaker functionality.
`spinn_utilities.abstract_base`
-------------------------------
Provides a simplified (and faster) version of the standard Python Abstract
Base Class functionality.
`spinn_utilities.conf_loader`
-----------------------------
The structure to handle loading of SpiNNaker-style configuration files.
`spinn_utilities.executable_finder`
-----------------------------------
Utility for discovering executables to load onto SpiNNaker nodes.
`spinn_utilities.helpful_functions`
-----------------------------------
Miscellaneous bits.
`spinn_utilities.ordered_set`
-----------------------------
A set class where the elements have an order defined by when they were
inserted.
`spinn_utilities.overrides`
---------------------------
Decorator for declaring where a method overrides another method.
`spinn_utilities.progress_bar`
------------------------------
Generalised progress bar printer.
`spinn_utilities.socket_address`
--------------------------------
Holder for the locations of network resources.
`spinn_utilities.timer`
-----------------------
General code timer utility.
Generating Aggregated Citation Files
====================================
The `spinn_utilities.citation.citation_aggregator` module can be executed to generate a .cff file consisting of the Citation.cff file from the given top-level module, plus references made up from the dependencies of the top-level module. If these dependencies have .cff files themselves, the references will contain the information from those files, otherwise it will use the version number and name of the module as a reference. The tool can also create a DOI for the version of the tools in use which can then be cited. This makes use of the Zenodo service.
To use the tool, run the following after installing SpiNNUtils:
```
python -m spinn_utilities.citation.citation_aggregator [-h] [--create_doi] [--publish_doi] [--doi_title DOI_TITLE] [--previous_doi PREVIOUS_DOI] [--zenodo_access_token ZENODO_ACCESS_TOKEN] output_path top_module
positional arguments:
output_path The file to store the result in
top_module The module to start with
optional arguments:
-h, --help show this help message and exit
--create_doi Create a DOI from the resulting citation on Zenodo
--publish_doi Publish the DOI created
--doi_title DOI_TITLE The title to give the created DOI
--previous_doi PREVIOUS_DOI The DOI this is a newer version of
--zenodo_access_token ZENODO_ACCESS_TOKEN Access token for Zenodo
```
Documentation
=============
[SpiNNUtils python documentation](http://spinnutils.readthedocs.io/en/7.2.1)
[Combined python documentation](http://spinnakermanchester.readthedocs.io/en/7.2.1)
Raw data
{
"_id": null,
"home_page": "https://github.com/SpiNNakerManchester/SpiNNUtils",
"name": "SpiNNUtilities",
"maintainer": "SpiNNakerTeam",
"docs_url": null,
"requires_python": "<4,>=3.8",
"maintainer_email": "spinnakerusers@googlegroups.com",
"keywords": "spinnaker, utilities",
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/0d/d4/fac72b50bac3aaa91ea402cc15f4ebf49e670f630ef090b40b96c79f180c/spinnutilities-1!7.2.1.tar.gz",
"platform": null,
"description": "\nSpiNNUtils\n==========\nThis provides basic utility functions and classes to other parts of SpiNNaker's\ntooling. Nothing in here knows anything about SpiNNaker functionality.\n\n\n`spinn_utilities.abstract_base`\n-------------------------------\nProvides a simplified (and faster) version of the standard Python Abstract\nBase Class functionality.\n\n`spinn_utilities.conf_loader`\n-----------------------------\nThe structure to handle loading of SpiNNaker-style configuration files.\n\n`spinn_utilities.executable_finder`\n-----------------------------------\nUtility for discovering executables to load onto SpiNNaker nodes.\n\n`spinn_utilities.helpful_functions`\n-----------------------------------\nMiscellaneous bits.\n\n`spinn_utilities.ordered_set`\n-----------------------------\nA set class where the elements have an order defined by when they were\ninserted.\n\n`spinn_utilities.overrides`\n---------------------------\nDecorator for declaring where a method overrides another method.\n\n`spinn_utilities.progress_bar`\n------------------------------\nGeneralised progress bar printer.\n\n`spinn_utilities.socket_address`\n--------------------------------\nHolder for the locations of network resources.\n\n`spinn_utilities.timer`\n-----------------------\nGeneral code timer utility.\n\nGenerating Aggregated Citation Files\n====================================\nThe `spinn_utilities.citation.citation_aggregator` module can be executed to generate a .cff file consisting of the Citation.cff file from the given top-level module, plus references made up from the dependencies of the top-level module. If these dependencies have .cff files themselves, the references will contain the information from those files, otherwise it will use the version number and name of the module as a reference. The tool can also create a DOI for the version of the tools in use which can then be cited. This makes use of the Zenodo service.\n\nTo use the tool, run the following after installing SpiNNUtils:\n\n```\npython -m spinn_utilities.citation.citation_aggregator [-h] [--create_doi] [--publish_doi] [--doi_title DOI_TITLE] [--previous_doi PREVIOUS_DOI] [--zenodo_access_token ZENODO_ACCESS_TOKEN] output_path top_module\n\npositional arguments:\n output_path The file to store the result in\n top_module The module to start with\n\noptional arguments:\n -h, --help show this help message and exit\n --create_doi Create a DOI from the resulting citation on Zenodo\n --publish_doi Publish the DOI created\n --doi_title DOI_TITLE The title to give the created DOI\n --previous_doi PREVIOUS_DOI The DOI this is a newer version of\n --zenodo_access_token ZENODO_ACCESS_TOKEN Access token for Zenodo\n```\n\nDocumentation\n=============\n[SpiNNUtils python documentation](http://spinnutils.readthedocs.io/en/7.2.1)\n\n[Combined python documentation](http://spinnakermanchester.readthedocs.io/en/7.2.1)\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Utility classes and functions for SpiNNaker projects",
"version": "1!7.2.1",
"project_urls": {
"Homepage": "https://github.com/SpiNNakerManchester/SpiNNUtils"
},
"split_keywords": [
"spinnaker",
" utilities"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "750fabd0cd96f496d99f6b02ef0102978d6e1dbe4dc1f72ffd415ed39a71e388",
"md5": "83b4eee0d73277a3bf381ab841404464",
"sha256": "3550268de823d3bc8ed2d778f3c423aef991cff300efbc77f4d4e0fac3f21cf4"
},
"downloads": -1,
"filename": "SpiNNUtilities-1!7.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "83b4eee0d73277a3bf381ab841404464",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4,>=3.8",
"size": 160115,
"upload_time": "2024-08-12T11:37:15",
"upload_time_iso_8601": "2024-08-12T11:37:15.935790Z",
"url": "https://files.pythonhosted.org/packages/75/0f/abd0cd96f496d99f6b02ef0102978d6e1dbe4dc1f72ffd415ed39a71e388/SpiNNUtilities-1!7.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0dd4fac72b50bac3aaa91ea402cc15f4ebf49e670f630ef090b40b96c79f180c",
"md5": "b5aab0e0ecc60930781f5859f02ba119",
"sha256": "9e20995448c46054e66a0b749b7c6b293e493d58d19c8100a698d92463dd98b7"
},
"downloads": -1,
"filename": "spinnutilities-1!7.2.1.tar.gz",
"has_sig": false,
"md5_digest": "b5aab0e0ecc60930781f5859f02ba119",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4,>=3.8",
"size": 118804,
"upload_time": "2024-08-12T11:37:18",
"upload_time_iso_8601": "2024-08-12T11:37:18.016346Z",
"url": "https://files.pythonhosted.org/packages/0d/d4/fac72b50bac3aaa91ea402cc15f4ebf49e670f630ef090b40b96c79f180c/spinnutilities-1!7.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-12 11:37:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "SpiNNakerManchester",
"github_project": "SpiNNUtils",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "spinnutilities"
}
JSON
