{"id":13411232,"url":"https://github.com/zdf-opensource/recommendations-pa-base","last_synced_at":"2025-03-14T16:34:10.851Z","repository":{"id":214255563,"uuid":"645774885","full_name":"zdf-opensource/recommendations-pa-base","owner":"zdf-opensource","description":null,"archived":false,"fork":false,"pushed_at":"2023-12-13T13:12:48.000Z","size":96,"stargazers_count":83,"open_issues_count":1,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-07-31T20:45:16.267Z","etag":null,"topics":["automation","media","recommender-system"],"latest_commit_sha":null,"homepage":"https://algorithmen.zdf.de","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zdf-opensource.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-05-26T12:05:44.000Z","updated_at":"2024-07-25T15:46:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"e2dc2c5d-fef7-4a87-bf1a-ace3152dfbc9","html_url":"https://github.com/zdf-opensource/recommendations-pa-base","commit_stats":null,"previous_names":["zdf-opensource/recommendations-pa-base"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zdf-opensource%2Frecommendations-pa-base","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zdf-opensource%2Frecommendations-pa-base/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zdf-opensource%2Frecommendations-pa-base/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zdf-opensource%2Frecommendations-pa-base/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zdf-opensource","download_url":"https://codeload.github.com/zdf-opensource/recommendations-pa-base/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243610939,"owners_count":20319053,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","media","recommender-system"],"created_at":"2024-07-30T20:01:12.331Z","updated_at":"2025-03-14T16:34:10.770Z","avatar_url":"https://github.com/zdf-opensource.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# P/A base\nThis repository contains models, logic and abstractions for P/A components.\n\nThere are also some models in this repository which are currently under development/evaluation.\n\n***\n\n## Installation of pa-base in dependent projects\n\n### Editable \"installation\"\nClone the repo side-by-side with dependent projects\nand just add the path to PYTHONPATH. This can easily be done in PyCharm/IntelliJ\nby marking both folders (`pa-base` and the dependent project's root)\nas \"sources root\" within the same PyCharm/IntelliJ workspace.\n\n### Versioned installation\nVersioned install can be done either from GitLab PyPI using `pip` or by\ncloning the repo, checking out a version tag, building it locally\nand installing the build artifact, i.e.,\n```bash\n# checkout specific version tag \"v0.0.9\"\ngit checkout v0.0.9\n# build version 0.0.9\npoetry build -f wheel\n\n# install build artifact in target environment\npip install dist/pa-base-0.0.9-py3-none-any.whl\n```\n\n***\n\n## Development Workflow\nNew features must be implemented on feature branches. Please create a merge request to\n`main` when your feature is ready for rollout.\n\n`main` is always shippable. New versions may be created from `main` at any time.\n\n```mermaid\ngraph LR\n    work   -- \"git commit\" --\u003e commit;\n    commit --\u003e work;\n    commit -- \"./tag_new_version.sh\" --\u003e tag;\n    commit -- \"git push\"--\u003e push;\n    tag    -- \"git push --follow-tags\" --\u003e push;\n    push   --\u003e tests;\n    tag    -- \"if tag push is rejected:\\ngit pull --tags -f\" --\u003e increase_version;\n    increase_version   --\u003e commit;\n\n    subgraph \"CI Pipeline\"\n    tests  --\u003e build;\n    build  -- \"tagged\" --\u003e release;\n    end\n```\n\n## Dev Environment\n```bash\npoetry install --all-extras\n```\nThis creates a new venv. Use it either through `poetry run ...` or in a `poetry shell`.\nThe environment can be set in VS Code / IntelliJ using the path returned by `poetry env info`.\n\n## Tests\nRun tests locally (automatically loads environment variables from  `.env` file using python-dotenv from dev dependencies):\n```bash\npoetry run pytest\n```\nTests run automatically in the CI pipeline.\n\n## Releases\nReleases must be tagged with a version `vX.Y.Z`, e.g., `v1.2.3`.\nThis is used by consumers for version pinning.\nVersion tags must never be changed and can only be released once.\n```bash\ngit tag v0.0.9 -m \"Version 0.0.9\"\n```\nIf poetry is installed, a correct tag can be autogenerated from the version given in `pyproject.toml`:\n```bash\n./tag_new_version.sh\n```\n\n***\n\n## Maintainers\nThis project is maintained by the Personalization \u0026 Automation Team at ZDF.\n\n***\n\n## License\nSee [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzdf-opensource%2Frecommendations-pa-base","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzdf-opensource%2Frecommendations-pa-base","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzdf-opensource%2Frecommendations-pa-base/lists"}