# NR model
This github project generates:
* `nr-metadata` - runtime support containing marshmallow, serializers, ... for NR metadata (documents and data)
* `oarepo-model-builder-nr` - a plugin for oarepo-model-builder to generate
## Incompatible changes
None yet. If you introduce any incompatible changes (vs previous major version),
enumerate them here and link the readme file from the previous major version
for reference.
## Usage
See the `examples/model.yaml` file for a skeleton of a repository
which uses nr metadata document model. An even easier way is to use the
[nrp](https://narodni-repozitar.github.io/developer-docs/docs/technology/invenio/nrp-toolchain/)
command to generate a documents- or data- compatible repository.
See the same pages to get help about the model contents.
## Branches
Branches are always named "aa.bb" and denote the version of the contained metadata schema.
## Updating package
Package needs to be updated whenever the version of oarepo-model-builder and
other builder plugins changes and influences the generated files.
The package version is always in the form of `aa.bb.ccc`, where `aa.bb` is the version
of the metadata schema and `ccc` is the version of the python package.
To rebuild python packages:
- [ ] Create a development branch (named after the issue inside linear or github issue)
- [ ] Implement your changes
- [ ] Increase the version number in `version` file
- [ ] Run `build.sh` (note - this has to be run after modification to the `version` file)
- [ ] Create a merge request to the `aa.bb` branch
- [ ] Create a new github release.
## Updating model
To update the model version,
- [ ] start by creating a new branch with the name `aa.bb`, where `aa.bb` represents the new model version.
For example, if the current version is `2.0` and your changes are minor,
the new version should be `2.1`, while major changes warrant
a version bump to `3.0`.
- [ ] Set this branch as the default branch on GitHub.
- [ ] Rename files inside the `model` directory to include the correct version
- [ ] Change the model version inside the `build.sh` script
- [ ] Make your modifications to the files within the model directory
- [ ] Update the content of the `version` file to reflect the new version as
`aa.bb.0`
- [ ] Execute the `build.sh` script to ensure that everything builds correctly
- [ ] Push your changes to GitHub
- [ ] Mark the branch as the default branch
- [ ] Create a new GitHub release.
Raw data
{
"_id": null,
"home_page": "https://github.com/Narodni-repozitar/oarepo-model-builder-nr",
"name": "oarepo-model-builder-nr",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "invenio Czech NR model builder",
"author": "Miroslav Simek",
"author_email": "simek.miroslav@techlib.cz",
"download_url": "https://files.pythonhosted.org/packages/33/b9/702f61003a7d12e5f62c42b86ec5692f491bc4828a9da6c30ec004ac6f1a/oarepo_model_builder_nr-2.0.44.tar.gz",
"platform": "any",
"description": "# NR model\n\nThis github project generates:\n\n* `nr-metadata` - runtime support containing marshmallow, serializers, ... for NR metadata (documents and data)\n* `oarepo-model-builder-nr` - a plugin for oarepo-model-builder to generate \n\n## Incompatible changes\n\nNone yet. If you introduce any incompatible changes (vs previous major version),\nenumerate them here and link the readme file from the previous major version\nfor reference.\n\n## Usage\n\nSee the `examples/model.yaml` file for a skeleton of a repository \nwhich uses nr metadata document model. An even easier way is to use the\n[nrp](https://narodni-repozitar.github.io/developer-docs/docs/technology/invenio/nrp-toolchain/) \ncommand to generate a documents- or data- compatible repository. \nSee the same pages to get help about the model contents.\n\n## Branches\n\nBranches are always named \"aa.bb\" and denote the version of the contained metadata schema.\n\n## Updating package\n\nPackage needs to be updated whenever the version of oarepo-model-builder and \nother builder plugins changes and influences the generated files.\n\nThe package version is always in the form of `aa.bb.ccc`, where `aa.bb` is the version\nof the metadata schema and `ccc` is the version of the python package.\n\nTo rebuild python packages:\n\n- [ ] Create a development branch (named after the issue inside linear or github issue)\n- [ ] Implement your changes\n- [ ] Increase the version number in `version` file\n- [ ] Run `build.sh` (note - this has to be run after modification to the `version` file)\n- [ ] Create a merge request to the `aa.bb` branch\n- [ ] Create a new github release.\n\n## Updating model\n\nTo update the model version, \n- [ ] start by creating a new branch with the name `aa.bb`, where `aa.bb` represents the new model version. \n\n For example, if the current version is `2.0` and your changes are minor, \n the new version should be `2.1`, while major changes warrant \n a version bump to `3.0`.\n\n- [ ] Set this branch as the default branch on GitHub. \n\n- [ ] Rename files inside the `model` directory to include the correct version\n- [ ] Change the model version inside the `build.sh` script\n\n- [ ] Make your modifications to the files within the model directory \n- [ ] Update the content of the `version` file to reflect the new version as \n`aa.bb.0`\n- [ ] Execute the `build.sh` script to ensure that everything builds correctly \n- [ ] Push your changes to GitHub\n- [ ] Mark the branch as the default branch\n- [ ] Create a new GitHub release.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "\"A model builder plugin with Czech National Repository compatible metadata schema\"",
"version": "2.0.44",
"project_urls": {
"Homepage": "https://github.com/Narodni-repozitar/oarepo-model-builder-nr"
},
"split_keywords": [
"invenio",
"czech",
"nr",
"model",
"builder"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "fa29486808497b03e31713380c3cb5c3a45d407378674362e27f0eb6d8c5a9ed",
"md5": "41967be2700fc882382b9b0a23198fdd",
"sha256": "3c744572cd5707721c48884e3bf45e462e27c36f6b5fab5c75c583743026727e"
},
"downloads": -1,
"filename": "oarepo_model_builder_nr-2.0.44-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "41967be2700fc882382b9b0a23198fdd",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.9",
"size": 20817,
"upload_time": "2024-10-30T08:24:42",
"upload_time_iso_8601": "2024-10-30T08:24:42.165447Z",
"url": "https://files.pythonhosted.org/packages/fa/29/486808497b03e31713380c3cb5c3a45d407378674362e27f0eb6d8c5a9ed/oarepo_model_builder_nr-2.0.44-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "33b9702f61003a7d12e5f62c42b86ec5692f491bc4828a9da6c30ec004ac6f1a",
"md5": "98737d08740dda642829859f1c8158ae",
"sha256": "b708dd70bf690a789d3941ba4a17df1bbef1c759c300d622e69227f22b64c3d0"
},
"downloads": -1,
"filename": "oarepo_model_builder_nr-2.0.44.tar.gz",
"has_sig": false,
"md5_digest": "98737d08740dda642829859f1c8158ae",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 18055,
"upload_time": "2024-10-30T08:24:43",
"upload_time_iso_8601": "2024-10-30T08:24:43.750013Z",
"url": "https://files.pythonhosted.org/packages/33/b9/702f61003a7d12e5f62c42b86ec5692f491bc4828a9da6c30ec004ac6f1a/oarepo_model_builder_nr-2.0.44.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-30 08:24:43",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Narodni-repozitar",
"github_project": "oarepo-model-builder-nr",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "oarepo-model-builder-nr"
}