{"id":18329495,"url":"https://github.com/biolink/ontobio","last_synced_at":"2025-05-16T02:04:00.657Z","repository":{"id":20058393,"uuid":"88679857","full_name":"biolink/ontobio","owner":"biolink","description":"python library for working with ontologies and ontology associations","archived":false,"fork":false,"pushed_at":"2025-02-11T19:03:51.000Z","size":70083,"stargazers_count":128,"open_issues_count":135,"forks_count":32,"subscribers_count":20,"default_branch":"master","last_synced_at":"2025-05-11T09:47:15.798Z","etag":null,"topics":["bioinformatics","gene-ontology","graph","obo","obofoundry","ontology","ontology-tools","python","rdf","semantic-web","sparql"],"latest_commit_sha":null,"homepage":"https://ontobio.readthedocs.io/en/latest/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/biolink.png","metadata":{"files":{"readme":"README-developers.md","changelog":"CHANGELOG.rst","contributing":"CONTRIBUTING.md","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":"2017-04-18T23:36:22.000Z","updated_at":"2025-03-21T23:00:51.000Z","dependencies_parsed_at":"2022-08-07T14:00:05.688Z","dependency_job_id":"14c1d268-5a5d-4d41-8558-a98753a846c8","html_url":"https://github.com/biolink/ontobio","commit_stats":{"total_commits":1439,"total_committers":26,"mean_commits":55.34615384615385,"dds":0.7776233495482974,"last_synced_commit":"4d591cd3b31d6ac3771ea8d143318764f6fe460f"},"previous_names":[],"tags_count":198,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biolink%2Fontobio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biolink%2Fontobio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biolink%2Fontobio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biolink%2Fontobio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/biolink","download_url":"https://codeload.github.com/biolink/ontobio/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254453646,"owners_count":22073616,"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":["bioinformatics","gene-ontology","graph","obo","obofoundry","ontology","ontology-tools","python","rdf","semantic-web","sparql"],"created_at":"2024-11-05T19:17:39.057Z","updated_at":"2025-05-16T02:04:00.567Z","avatar_url":"https://github.com/biolink.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"* Note: pandoc must be installed before this works. You can install with\nbrew or apt-get or yum.\n\nThis section is only relevant for project maintainers. In order to release you must have a pypi account and be a \"maintainer\" on the ontobio project\n\nTo create a new release, do the following:\n\n## Release Instructions -- Makefile\n\n1. Ensure you're on master and up to date. Ensure also that twine is installed (`pip install twine`)\n  \u003e I always do this in my virtual environment activated\n2. Obeying Semantic Versioning (https://semver.org/) bump the version number in `ontobio/ontobio/__init__.py` at the `__version__` variable.\n  \u003e At this point you should have one modified file, saved: `ontobio/ontobio/__init__.py`. You can check with `git diff` and/or `git status`.\n3. Run the make relase target\n   ```\n   $ make USER=sauron release\n   ```\n  where the `USER` should be set to your pypi.org username.\n\n  This will perform all the steps outlined in the below manual release section.\n\n4. pypi will ask for your password. (You may also setup credentials with pypi, but that's now how the author who is writing this documentation has it setup.)\n\n### Failure\n\nIf at any point this fails (wrong password, master is not updated, etc) you will have to just perform the steps manually as outlined in the below section.\n\nLikely you will not be able to just rerun the release as the git portion of the release is not idempotent. Just note where you had an error and continue the steps corrected manually. I usually use the the Makefile as a direct reference if a command fails.\n\n## Release instructions -- Manual\n\n1. First check whether the `__version__` in [`ontobio/__init__.py`](ontobio/__init__.py) matches with the latest tag or PyPI release. If the version is the same then you need to bump the version to make a new release. Follow semantic versioning guidelines to decide whether the bump in version is major or minor.\n\n2. If you did bump the version then run the following commands:\n\n```sh\nTAG=v`python setup.py --version`\ngit add ontobio/__init__.py\ngit commit --message=\"Upgrade to $TAG\"\ngit push\ngit tag --annotate $TAG --message=\"Upgrade to $TAG\"\ngit push --tags\n  ```\n\n3. Releasing on PyPI\n\n\u003e To ensure this is successful, make sure you have relevant permissions to Ontobio package on [PyPI](https://pypi.org/project/ontobio/)\n\nRun the following commands (note, you will need a pypi token to do this work, see: https://pypi.org/help/#apitoken\nand make a ~/.pypirc file to store your token):\n\n```sh\nmake cleandist\npython setup.py sdist bdist_wheel\ntwine upload --repository-url https://upload.pypi.org/legacy/ --username __token__ dist/*\n```\n\n****************************************************************************************************\n\n#### to use a poetry development environment\n\n1. create the pyproject.toml file and generate the .venv directory\n```bash\nmake poetry\n```\nthis command deletes any existing pyproject.toml and poetry.lock files as well as the .venv virtual environment\nif it finds one.  It then creates a new pyproject.toml file out of the requirements.txt file, \ncreates a .venv directory, and finally installs the dependencies into it.  This also creates a poetry.lock file.\nAt the moment, the poetry.lock and pyproject.toml files are both in .gitignore so that the source of truth for\nthe built environment is still requirements.txt.\n\n2. to recreate the poetry virtual environment, just run the same `make poetry` command again, or if you want to avoid\nreinstalling all the dependencies, just `rm -rf .venv` which will remove the local virtual environment and then\nrun `poetry install` to install via the `poetry.lock` file created in step 1 above. \n\nhelpful poetry commands:\n```bash\npoetry install # install dependencies from poetry.lock\npoetry run \u003ccommand\u003e # run a command in the poetry virtual environment\npoetry env list # list all virtual environments and tags the one currently in use for the project\npoetry show --why --tree [pypi_package_name] # show the dependency tree for pypi_package_name\npoetry show [pypi_package_name] # show the version of pypi_package_name that is install in the current venv.\n```\n\nIf we use a pyproject.toml file then we can use poetry to manage the dependencies and the virtual environment.\nBut for now, managing the dependencies in the requirements.txt file means that we don't want to add/update/remove\ndependencies from pyproject.toml directly, nor do we want it to ever be the source of truth for the dependencies.\n\n```bash\npoetry add \u003cpackage\u003e # add a package to the pyproject.toml file and install it in the virtual environment\npoetry remove \u003cpackage\u003e # remove a package from the pyproject.toml file and uninstall it from the virtual environment\npoetry update # update all packages in the pyproject.toml file and the poetry.lock file\npoetry update \u003cpackage\u003e # update the specified package in the pyproject.toml file and the poetry.lock file\npoetry lock --no-update # update the poetry.lock file without updating the pyproject.toml file -- used when editing the \n# pyproject.toml file directly. \n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbiolink%2Fontobio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbiolink%2Fontobio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbiolink%2Fontobio/lists"}