{"id":20652311,"url":"https://github.com/openpolis/linkurious","last_synced_at":"2026-04-22T06:07:27.817Z","repository":{"id":62576267,"uuid":"384234977","full_name":"openpolis/linkurious","owner":"openpolis","description":"Python wrapper around linkurious API","archived":false,"fork":false,"pushed_at":"2021-07-09T09:37:53.000Z","size":28,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-08-30T22:37:11.261Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/openpolis.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-07-08T19:59:49.000Z","updated_at":"2022-01-10T09:43:08.000Z","dependencies_parsed_at":"2022-11-03T20:45:18.138Z","dependency_job_id":null,"html_url":"https://github.com/openpolis/linkurious","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/openpolis/linkurious","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openpolis%2Flinkurious","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openpolis%2Flinkurious/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openpolis%2Flinkurious/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openpolis%2Flinkurious/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openpolis","download_url":"https://codeload.github.com/openpolis/linkurious/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openpolis%2Flinkurious/sbom","scorecard":{"id":709937,"data":{"date":"2025-08-11","repo":{"name":"github.com/openpolis/linkurious","commit":"ca3cf2e3b0f8600347552fffb5903f9458d0a717"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":1.7,"checks":[{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Code-Review","score":0,"reason":"Found 0/6 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE.txt:0","Info: FSF or OSI recognized license: MIT License: LICENSE.txt:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":0,"reason":"13 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: PYSEC-2024-230 / GHSA-248v-346w-9cwc","Warn: Project is vulnerable to: PYSEC-2022-42986 / GHSA-43fp-rhv2-5gv8","Warn: Project is vulnerable to: PYSEC-2023-135 / GHSA-xqr8-7jwr-rhp7","Warn: Project is vulnerable to: PYSEC-2024-60 / GHSA-jjg7-2v4v-x38h","Warn: Project is vulnerable to: PYSEC-2022-42969","Warn: Project is vulnerable to: GHSA-9hjg-9r4m-mvj7","Warn: Project is vulnerable to: GHSA-9wx4-h78v-vm56","Warn: Project is vulnerable to: PYSEC-2023-74 / GHSA-j8r2-6x86-q33q","Warn: Project is vulnerable to: GHSA-34jh-p97f-mpxf","Warn: Project is vulnerable to: PYSEC-2023-212 / GHSA-g4mx-q9vg-27p4","Warn: Project is vulnerable to: GHSA-pq67-6m6q-mj2v","Warn: Project is vulnerable to: PYSEC-2023-192 / GHSA-v845-jxx5-vc9f","Warn: Project is vulnerable to: GHSA-jfmj-5v4g-7637"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-22T07:49:57.277Z","repository_id":62576267,"created_at":"2025-08-22T07:49:57.283Z","updated_at":"2025-08-22T07:49:57.283Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32123609,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-22T00:31:26.853Z","status":"online","status_checked_at":"2026-04-22T02:00:05.693Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2024-11-16T17:33:50.798Z","updated_at":"2026-04-22T06:07:27.802Z","avatar_url":"https://github.com/openpolis.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Latest Version](https://img.shields.io/pypi/v/linkurious.svg)](https://pypi.python.org/pypi/linkurious)\n[![Latest Version](https://img.shields.io/pypi/pyversions/linkurious.svg)](https://pypi.python.org/pypi/linkurious)\n[![License](https://img.shields.io/pypi/l/linkurious.svg)](https://pypi.python.org/pypi/linurious)\n[![Downloads](https://pepy.tech/badge/linkurious/month)](https://pepy.tech/project/linkurious/month)\n\n[![Twitter Follow](https://img.shields.io/twitter/follow/openpolislab)](https://twitter.com/openpolislab)\n\n\nlinkurious is a [tortilla](https://github.com/tortilla/tortilla) based python wrapper around the\n[Linkurious HTTP REST API](https://doc.linkurio.us/server-sdk/latest/apidoc/)\nthat allows users to remotely manage a Linkurious instance, performing the same tasks\nthat can be done through the web application.\n\nThis can be useful to:\n- automate some of the most tedious tasks\n- integrate the Linkurious instance within a wider multi-services application\n\n[Linkurious Enterprise](https://linkurio.us/product/) is a copyrighted graph visualization and analysis platform,\nthat allows users to perform queries and build visualizations on multiple graph databases (Neo4j, CosmosDB, JanusGraph).\n\n## Installation\n\nPython versions from 3.6 are supported.\n\nThe package is hosted on pypi, and can be installed, for example using pip:\n\n    pip install linkurious\n\n## Usage\nThe package only has one class (and one exception), creating a `Linkurious` instance passing username and password\nwill connect to the instance. All following operations will be performed using the same user session. \n\n    from linkurious import Linkurious\n    \n    # login\n    l = Linkurious(\n        host='https://linkurious.example.org', \n        username='user@mail.org', \n        password='****', \n        debug=False\n    )\n    \n    # query execution\n    query = \"\"\"\n    MATCH (p:Person)-[i]-(m:Movie) where m.id=12\n    return p, i, m\n    limit 100\n    \"\"\"\n    r = l.run_cypher_query(sourcekey='ae46c2f7', query=query)\n\n    # nodes and edges are transformed before being sent to the visualization \n    r_nodes = [\n        {\n            'id': n.data.properties.id, \n            'data': {\n                'geo': {}\n            }, \n            'attributes': {\n                'layoutable': True, \n                'x': 0, 'y': 0\n            }\n        } \n        for n in r['nodes']\n    ]\n    r_edges = [\n        {\n            'id': e.data.properties.id, \n            'attributes': {}\n        } \n        for e in r.edges\n    ]\n    \n    # visualization creation\n    v = l.create_visualization(\n        sourcekey='ae46c2f7', \n        title=\"Test from API\", \n        nodes=r_nodes, \n        edges=r_edges\n    )\n    # server-side auto layouting, in order to spread the nodes\n    l.patch_visualization(\n        sourcekey='ae46c2f7', id=v.id, \n        do_layout=True,\n    )\n    \n    # visualization styles are reset\n    v.design.styles.node = []\n    v.design.styles.edge = []\n    l.patch_visualization(\n        sourcekey='ae46c2f7', id=v.id,     \n        visualization={'design': dict(v.design)},\n        force_lock=True\n    )\n\n    # so that they can now be built anew\n    # see https://doc.linkurio.us/server-sdk/latest/apidoc/#api-Visualization-createVisualization\n    # and the links on INodeStyle and IEdgeStyle\n    v.design.styles.node = [\n        { ... }\n    ] \n    v.design.styles.edges = [\n        { ... }\n    ] \n    # design is updated in the visualization\n    # it must be transformed into a dict, as v is a Bunch (from tortilla),\n    # and it may causes all sorts of bad requests responses from Linkurious API\n    l.patch_visualization(\n        sourcekey='ae46c2f7', id=v.id,     \n        visualization={'design': dict(v.design)},\n        force_lock=True\n    )\n    \n    # the same can be done for \n    # - visualization filters (v.filters)\n    # - visualization captions (v.nodeFields, v.edgeFields)\n    \n\n## Support\n\nThere is no guaranteed support available, but authors will try to keep up with issues \nand merge proposed solutions into the code base.\n\n## Project Status\nThis project is currently being developed by the [Openpolis Foundation](https://www.openpolis.it/openpolis-foundation/)\nand does only cover those parts of the Linkurious API that are needed in the Foundation's projects. \nShould more be needed, you can either ask to increase the coverage, or try to contribute, following instructions below.\n\n## Contributing\nIn order to contribute to this project:\n* verify that python 3.6+ is being used (or use [pyenv](https://github.com/pyenv/pyenv))\n* verify or install [poetry](https://python-poetry.org/), to handle packages and dependencies in a leaner way, \n  with respect to pip and requirements\n* clone the project `git clone git@github.com:openpolis/linkurious.git` \n* install the dependencies in the virtualenv, with `poetry install`,\n  this will also install the dev dependencies\n* develop \n* create a [pull request](https://docs.github.com/en/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests)\n* wait for the maintainers to review and eventually merge your pull request into the main repository\n\n### Testing\nAs this is a tiny utility wrapper around an already tested and quite simple package (tortilla), \nthere are no tests.\n\n## Authors\nGuglielmo Celata - guglielmo@openpolis.it\n\n## Licensing\nThis package is released under an MIT License, see details in the LICENSE.txt file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenpolis%2Flinkurious","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenpolis%2Flinkurious","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenpolis%2Flinkurious/lists"}