==========
radarly-py
==========
.. image:: https://img.shields.io/pypi/v/radarly-py.svg
:alt: PyPI - Python Version
:target: https://pypi.org/project/radarly-py/
.. image:: https://img.shields.io/pypi/pyversions/radarly-py.svg
:alt: PyPI - Python Version
:target: https://pypi.org/project/radarly-py/
.. image:: https://img.shields.io/pypi/l/radarly-py.svg
:alt: PyPI - Python Version
:target: https://pypi.org/project/radarly-py/
:Author: Linkfluence
:Version: 1.0.17
.. _documentation: https://api.linkfluence.com/
This package is a Python client in order to use Radarly API. Thanks to
this client, you can fetch most of the endpoints described in the
`documentation`_.
Installation
^^^^^^^^^^^^
You can use ``pip`` to install this package. The commmand
``pip install radarly-py`` will install the package and all its dependencies.
.. note:: ``pandas`` is not a dependency of ``radarly-py`` but it is strongly
advise to use to explore all objects storing quantitative data.
Quickstart
^^^^^^^^^^
First thing first, you must initialize an API.
>>> from radarly import RadarlyApi
>>> credentials = dict(client_id="XXXXX", client_secret="XXXXX")
>>> RadarlyApi.init(**credentials)
<RadarlyAPI.client_id=XXXXXXX>
Then, you can explore Radarly API with the different objects defined by
the client.
For example, you can explore all information about you (your projects,
your settings...).
>>> from radarly.user import User
>>> me = User.find(uid='me')
>>> me
<User.id=1.email='user.email@company.com'>
>>> me.draw_structure(max_depth=1)
User (User)
| account_id (int)
| apps (list[str])
| can_create_project (bool)
| connected (int)
| connection_count (int)
| created (datetime)
| current_project_id (int)
| email (str)
| engagement (dict)
| id (int)
| is_disabled (bool)
| is_internal (bool)
| is_manager (bool)
| is_pending (bool)
| is_root (bool)
| level (str)
| locale (str)
| name (str)
| picture_id (None)
| projects (list[InfoProject])
| theme (str)
| timezone (Europe/Paris)
| updated (datetime)
Then, you can explore a specific project.
>>> from radarly.project import Project
>>> my_project = Project.find(pid=2)
>>> my_project
<Project.pid=2.label=IGIT>
>>> my_project.draw_structure(max_depth=1)
Project (Project)
| account_id (int)
| alcmeon_company (str)
| benchmark_entities (list[dict])
| brand_logos (list)
| client_reference (str)
| corpora (list[dict])
| created (datetime)
| credentials (dict)
| dashboards (list[Dashboard])
| docs_count (int)
| docs_version (int)
| flags (dict)
| focuses (list[Focus])
| id (int)
| industries (list[dict])
| label (str)
| limits (dict)
| milestones (list[dict])
| mm3_id (None)
| out_of_reach_count (int)
| picture_id (int)
| platforms (list[str])
| project_manager_id (int)
| renew (datetime)
| research_manager_id (int)
| sinaweibo_options (dict)
| social_accounts (list[SocialAccount])
| social_wall_text (str)
| start (datetime)
| stop (datetime)
| tags (list[Tag])
| total_indexed_docs_count (int)
| updated (datetime)
>>> my_project['$.focuses.id'][:5] # Top five focuses'id in the project
[154262, 154263, 154374, 5, 140519]
You can now get some publications stored in this project. For example, we will
retrieve five publications of the project, published in 2017 and matching the
query with the id 137622 (see ``project['focuses']`` to explore the queries
of your project).
>>> from radarly.parameters import SearchPublicationParameter()
>>> from datetime import datetime
>>> start, end = datetime(2017, 1, 1), datetime(2017, 31, 12)
>>> parameter = SearchPublicationParameter() \
.publication_date(start, end) \
.pagination(start=0, limit=5) \
.focuses(include=[137622])
>>> publications = project.get_publications(parameter)
>>> publications
[<Publication.uid='r3_prod_2-10...6268444865350'>,
<Publication.uid='r3_prod_2-10...6268441960350'>,
<Publication.uid='r3_prod_2-989433433368748032'>,
<Publication.uid='r3_prod_2-10...6268434280350'>,
<Publication.uid='r3_prod_2-10...6268433470350'>]
This client gives you many possibilities to explore and navigate in
our API. Plese read the official `documentation`_ of the API and the
client to check all that is possible.
Raw data
{
"_id": null,
"home_page": "",
"name": "radarly-py",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.4",
"maintainer_email": "",
"keywords": "radarly linkfluence api",
"author": "Linkfluence",
"author_email": "help@linkfluence.com",
"download_url": "https://files.pythonhosted.org/packages/db/c3/48f3294ccb645b9e3c4c53c584e61cd64bffe543f939c4264818407a1522/radarly-py-1.0.17.tar.gz",
"platform": null,
"description": "==========\nradarly-py\n==========\n\n.. image:: https://img.shields.io/pypi/v/radarly-py.svg\n :alt: PyPI - Python Version\n :target: https://pypi.org/project/radarly-py/\n\n.. image:: https://img.shields.io/pypi/pyversions/radarly-py.svg\n :alt: PyPI - Python Version\n :target: https://pypi.org/project/radarly-py/\n\n.. image:: https://img.shields.io/pypi/l/radarly-py.svg\n :alt: PyPI - Python Version\n :target: https://pypi.org/project/radarly-py/\n\n\n\n:Author: Linkfluence\n:Version: 1.0.17\n\n\n\n.. _documentation: https://api.linkfluence.com/\n\nThis package is a Python client in order to use Radarly API. Thanks to\nthis client, you can fetch most of the endpoints described in the\n`documentation`_.\n\n\nInstallation\n^^^^^^^^^^^^\nYou can use ``pip`` to install this package. The commmand\n``pip install radarly-py`` will install the package and all its dependencies.\n\n.. note:: ``pandas`` is not a dependency of ``radarly-py`` but it is strongly\n advise to use to explore all objects storing quantitative data.\n\n\nQuickstart\n^^^^^^^^^^\nFirst thing first, you must initialize an API.\n\n>>> from radarly import RadarlyApi\n>>> credentials = dict(client_id=\"XXXXX\", client_secret=\"XXXXX\")\n>>> RadarlyApi.init(**credentials)\n<RadarlyAPI.client_id=XXXXXXX>\n\nThen, you can explore Radarly API with the different objects defined by\nthe client.\n\nFor example, you can explore all information about you (your projects,\nyour settings...).\n\n>>> from radarly.user import User\n>>> me = User.find(uid='me')\n>>> me\n<User.id=1.email='user.email@company.com'>\n>>> me.draw_structure(max_depth=1)\nUser (User)\n | account_id (int)\n | apps (list[str])\n | can_create_project (bool)\n | connected (int)\n | connection_count (int)\n | created (datetime)\n | current_project_id (int)\n | email (str)\n | engagement (dict)\n | id (int)\n | is_disabled (bool)\n | is_internal (bool)\n | is_manager (bool)\n | is_pending (bool)\n | is_root (bool)\n | level (str)\n | locale (str)\n | name (str)\n | picture_id (None)\n | projects (list[InfoProject])\n | theme (str)\n | timezone (Europe/Paris)\n | updated (datetime)\n\n\nThen, you can explore a specific project.\n\n>>> from radarly.project import Project\n>>> my_project = Project.find(pid=2)\n>>> my_project\n<Project.pid=2.label=IGIT>\n>>> my_project.draw_structure(max_depth=1)\nProject (Project)\n | account_id (int)\n | alcmeon_company (str)\n | benchmark_entities (list[dict])\n | brand_logos (list)\n | client_reference (str)\n | corpora (list[dict])\n | created (datetime)\n | credentials (dict)\n | dashboards (list[Dashboard])\n | docs_count (int)\n | docs_version (int)\n | flags (dict)\n | focuses (list[Focus])\n | id (int)\n | industries (list[dict])\n | label (str)\n | limits (dict)\n | milestones (list[dict])\n | mm3_id (None)\n | out_of_reach_count (int)\n | picture_id (int)\n | platforms (list[str])\n | project_manager_id (int)\n | renew (datetime)\n | research_manager_id (int)\n | sinaweibo_options (dict)\n | social_accounts (list[SocialAccount])\n | social_wall_text (str)\n | start (datetime)\n | stop (datetime)\n | tags (list[Tag])\n | total_indexed_docs_count (int)\n | updated (datetime)\n>>> my_project['$.focuses.id'][:5] # Top five focuses'id in the project\n[154262, 154263, 154374, 5, 140519]\n\n\nYou can now get some publications stored in this project. For example, we will\nretrieve five publications of the project, published in 2017 and matching the\nquery with the id 137622 (see ``project['focuses']`` to explore the queries\nof your project).\n\n>>> from radarly.parameters import SearchPublicationParameter()\n>>> from datetime import datetime\n>>> start, end = datetime(2017, 1, 1), datetime(2017, 31, 12)\n>>> parameter = SearchPublicationParameter() \\\n .publication_date(start, end) \\\n .pagination(start=0, limit=5) \\\n .focuses(include=[137622])\n>>> publications = project.get_publications(parameter)\n>>> publications\n[<Publication.uid='r3_prod_2-10...6268444865350'>,\n <Publication.uid='r3_prod_2-10...6268441960350'>,\n <Publication.uid='r3_prod_2-989433433368748032'>,\n <Publication.uid='r3_prod_2-10...6268434280350'>,\n <Publication.uid='r3_prod_2-10...6268433470350'>]\n\n\nThis client gives you many possibilities to explore and navigate in\nour API. Plese read the official `documentation`_ of the API and the\nclient to check all that is possible.\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Python client for Radarly API",
"version": "1.0.17",
"project_urls": {
"Documentation": "https://api.linkfluence.com"
},
"split_keywords": [
"radarly",
"linkfluence",
"api"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b9df014793896fffc4510c2db6ef4e7dbf8dd7d2b33ec022c3ce9b48b3f4f003",
"md5": "23358af77c68c5a2d4f558a48fa4de15",
"sha256": "357b7616fef51adc82234a4f4ef83db5000cf135c6caffbecfad947b52dc5799"
},
"downloads": -1,
"filename": "radarly_py-1.0.17-py3-none-any.whl",
"has_sig": false,
"md5_digest": "23358af77c68c5a2d4f558a48fa4de15",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.4",
"size": 65243,
"upload_time": "2023-08-03T12:29:06",
"upload_time_iso_8601": "2023-08-03T12:29:06.726963Z",
"url": "https://files.pythonhosted.org/packages/b9/df/014793896fffc4510c2db6ef4e7dbf8dd7d2b33ec022c3ce9b48b3f4f003/radarly_py-1.0.17-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "dbc348f3294ccb645b9e3c4c53c584e61cd64bffe543f939c4264818407a1522",
"md5": "0d9c6200e1e69c4939a9231bfe92c0b7",
"sha256": "67c3cb85aa489ab78e3e88a91be36c6cca6787c10983e21a4c2312cec8ec1c28"
},
"downloads": -1,
"filename": "radarly-py-1.0.17.tar.gz",
"has_sig": false,
"md5_digest": "0d9c6200e1e69c4939a9231bfe92c0b7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.4",
"size": 49114,
"upload_time": "2023-08-03T12:29:08",
"upload_time_iso_8601": "2023-08-03T12:29:08.404372Z",
"url": "https://files.pythonhosted.org/packages/db/c3/48f3294ccb645b9e3c4c53c584e61cd64bffe543f939c4264818407a1522/radarly-py-1.0.17.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-03 12:29:08",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "radarly-py"
}
JSON