easyvista-python-client 0.1.0__py3-none-any.whl

easyvista_python_client-0.1.0.dist-info/METADATA

@@ -0,0 +1,178 @@
+Metadata-Version: 2.4
+Name: easyvista-python-client
+Version: 0.1.0
+Summary: Typed Python client for the EasyVista Service Manager REST API
+Project-URL: Homepage, https://github.com/baraline/easyvista_python_client
+Project-URL: Documentation, https://easyvista-python-client.readthedocs.io/en/latest/
+Project-URL: Issues, https://github.com/baraline/easyvista_python_client/issues
+Project-URL: Source, https://github.com/baraline/easyvista_python_client
+Author: easyvista-python-client contributors
+License-Expression: MIT
+License-File: LICENSE
+Keywords: api,client,easyvista,itsm,rest,service-manager
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.8
+Requires-Dist: tenacity>=8.2
+Requires-Dist: typing-extensions>=4.7; python_version < '3.11'
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: mypy>=1.11; extra == 'dev'
+Requires-Dist: numpydoc>=1.8; extra == 'dev'
+Requires-Dist: pre-commit>=4.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Requires-Dist: sphinx-rtd-theme>=2.0; extra == 'dev'
+Requires-Dist: sphinx<8.2,>=7.2; extra == 'dev'
+Requires-Dist: tokenize-rt==6.2.0; extra == 'dev'
+Requires-Dist: tomli>=2.0; (python_version < '3.11') and extra == 'dev'
+Requires-Dist: twine>=5.1; extra == 'dev'
+Requires-Dist: unasync==0.6.0; extra == 'dev'
+Requires-Dist: vulture>=2.11; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: numpydoc>=1.8; extra == 'docs'
+Requires-Dist: sphinx-rtd-theme>=2.0; extra == 'docs'
+Requires-Dist: sphinx<8.2,>=7.2; extra == 'docs'
+Requires-Dist: tomli>=2.0; (python_version < '3.11') and extra == 'docs'
+Description-Content-Type: text/markdown
+
+# easyvista-python-client
+
+Typed Python client for the EasyVista Service Manager REST API. Sync + async,
+Pydantic models, Bearer or Basic auth.
+
+While the package is preparing for 1.0, alot of potential breaking change might happen between versions. A deprecation policy will be put in place once 1.0 is out and the package have been stabilized.
+
+## Documentation
+
+Full documentation: https://easyvista-python-client.readthedocs.io/
+
+Build it locally with `pip install -e ".[docs]"` then
+`sphinx-build -b html -W docs docs/_build/html`.
+
+## Install
+
+```bash
+pip install easyvista-python-client
+```
+
+## Usage (sync)
+
+```python
+from easyvista_python_client import (
+    EasyvistaClient,
+    EasyvistaConfig,
+    PostRequest,
+    ev_equals_filter,
+)
+
+config = EasyvistaConfig(server="https://my.easyvista.com", account="12345", token="...")
+with EasyvistaClient(config) as client:
+    # catalog_code, the *_id values and the close status_guid are instance-specific.
+    ticket = client.create_ticket(
+        PostRequest(
+            catalog_code="INC_STANDARD",
+            title="Printer down",
+            description="The 3rd-floor printer is offline",
+            origin=7,
+            department_id=9,
+            urgency_id=8,
+            impact_id=28,
+        )
+    )
+    fetched = client.get_ticket(ticket.rfc_number)
+    open_status = ev_equals_filter("STATUS_ID", 3)
+    results = client.search_tickets(search=open_status, max_rows=50)
+
+    # page through everything with the iterator (follows the API's offset paging)
+    for t in client.iter_tickets(search=open_status, page_size=100, max_records=1000):
+        ...  # async: `async for t in client.iter_tickets(...)`
+
+    # close it with your instance's "closed" status GUID
+    client.close_ticket(
+        ticket.rfc_number,
+        status_guid="{00000000-0000-0000-0000-000000000000}",
+        delete_actions=1,
+        comment="Resolved",
+    )
+```
+
+> Minimum fields for a create are catalog-specific (server-side). `catalog_code` + `title`
+> work for incident catalogs; a missing mandatory field raises `EasyvistaValidationError`
+> (HTTP 590, code 2013) — it is not retried.
+
+## Assets and documents
+
+```python
+from pathlib import Path
+from easyvista_python_client import (
+    EasyvistaClient,
+    EasyvistaConfig,
+    PostAsset,
+    ev_equals_filter,
+)
+
+with EasyvistaClient(EasyvistaConfig.from_env()) as client:
+    asset = client.create_asset(PostAsset(catalog_id=3153, asset_tag="LAPTOP-001"))
+    tag_filter = ev_equals_filter("ASSET_TAG", "LAPTOP-001")
+    found = client.search_assets(search=tag_filter, max_rows=50)
+
+    # attach a file to a ticket (uploaded as base64 inside the JSON body)
+    pdf = Path("report.pdf")
+    client.add_document("I240101_0001", filename=pdf.name, content=pdf.read_bytes())
+    attachments = client.list_documents("I240101_0001")
+```
+
+## Usage (async)
+
+```python
+from easyvista_python_client import AsyncEasyvistaClient, EasyvistaConfig
+
+async with AsyncEasyvistaClient(EasyvistaConfig.from_env()) as client:
+    ticket = await client.get_ticket("I240101_0001")
+```
+
+## Configuration via environment
+
+Set `EASYVISTA_URL` (or `EASYVISTA_SERVER`), `EASYVISTA_ACCOUNT`, and either
+`EASYVISTA_TOKEN` / `EASYVISTA_TOKEN_FILE` or `EASYVISTA_LOGIN` + `EASYVISTA_PASSWORD`,
+then call `EasyvistaConfig.from_env()`.
+
+## Agent skills
+
+`skills/` holds Agent Skills for driving this client from an AI agent — one per
+domain (client setup, search syntax, tickets, actions, documents, assets,
+directory, reporting and context). Each is a directory with a `SKILL.md`
+following the Agent Skills specification; see [skills/README.md](skills/README.md)
+for the index.
+
+They are source-tree material: present in the git repository and the source
+distribution, absent from the installed wheel.
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and quality checks.
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+## Sponsoring
+
+The development of this package is indirectly supported by
+[Novahé](https://www.novahe.fr/) & [Constellation](https://www.constellation.fr/).

easyvista_python_client-0.1.0.dist-info/RECORD

@@ -0,0 +1,42 @@
+easyvista_python_client/__init__.py,sha256=Z0sn4EYCSKKSc_829yG-C0o3jDuwkdNbZY2uIGChU3I,1966
+easyvista_python_client/_fields.py,sha256=vR2R7h3fnJ64Qh9cGTIjh5fKhjLTLsQnugqdJgUOzSM,928
+easyvista_python_client/_html.py,sha256=KftxdX4vHptQrOMqfWM-9I3g03UAA5YRmqwnLjI2Ir4,1276
+easyvista_python_client/_transport.py,sha256=IV-i-wHFaRx5jl5sCXK_7MEWiKULjK-XWoEPGNazwvg,1068
+easyvista_python_client/config.py,sha256=8re4ZUHixUfxyFVlApwpLfCHxGfHfVHy00dkDPnS6Zk,2377
+easyvista_python_client/context.py,sha256=_xIlsHsaOMc2KMuIIGoqJMAPK56wZrt5p5-axnLiHSY,5074
+easyvista_python_client/directory.py,sha256=riEs3aR5Z4XVAg2jWqWA4AeYpfDAeMCtsmoDxPEtUDc,1893
+easyvista_python_client/exceptions.py,sha256=ydxQ2aymKeWtZdX6VL-rNaO4YdicI4FmCPM7_kVTN_Q,1680
+easyvista_python_client/field_model.py,sha256=OGuq1DXSILOzF1AefK7L6Dbw376cWm3DBZ0eQ0yA3qI,2634
+easyvista_python_client/filters.py,sha256=Kk_2561n1BE62CAFvru0mmOdGWHOI4mpTa4PhlOHv7c,2885
+easyvista_python_client/pagination.py,sha256=y5orhpUiL3sFZ_c7v6QE4S2mDnC4VZNDAxm2IvvYiTU,3018
+easyvista_python_client/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+easyvista_python_client/references.py,sha256=L_IoOVVTsk49RAP3jrWGtmAzZtpB31p1mRF60nuNC6o,5510
+easyvista_python_client/reporting.py,sha256=b9wTsbDT4Hy0CWrVQg2ujOlIr5h7qXuf2aocHhIWK2A,5082
+easyvista_python_client/_async/__init__.py,sha256=pg5E76VOB1ruJNVpqzatRm9TJBdPhAcDhsmBKlcRotc,612
+easyvista_python_client/_async/_concurrency.py,sha256=5Ce9LZKRkGgT_AVSE93IeU2gl-Z3Jq84YxWK3EL-FMM,3826
+easyvista_python_client/_async/_transport.py,sha256=4Zlyxe9M76YumPWcSdElYZfsxdmcKwLYkxTBLD4R9y8,11144
+easyvista_python_client/_async/client.py,sha256=r3QOvMdoKc6lcs0BzqtLPKeVHdNP8TzvQjS8goQ404I,33266
+easyvista_python_client/_sync/__init__.py,sha256=TKnndsi6v7S43so4X6fg_hZy3wg45Jk40pYCQ2FkgR0,601
+easyvista_python_client/_sync/_concurrency.py,sha256=zeCtzdrMQa9thzdV6A5sdP8Ojojgjkhbx6X8pH7qWGw,1750
+easyvista_python_client/_sync/_transport.py,sha256=ESQzbK-rMix5_sLS4QD6B1yAEsuI6bbTQrqbTdA7rMM,11041
+easyvista_python_client/_sync/client.py,sha256=f-RBBpP0bHsFrN5ZrjTmVUMYUjL1LtWs1LJDNFLT5bY,32588
+easyvista_python_client/models/__init__.py,sha256=dCN1GPDWqu5zraEuGiCZaUGXyNQiK3yCuAC18Fh6NL4,47
+easyvista_python_client/models/action.py,sha256=94eX4If06OOlfuXkLJUCj67VCMV0yYGzpbVZt__MhY4,2997
+easyvista_python_client/models/asset.py,sha256=mx9tYBmAT4-Mn6dHOefc1mzh_t5NBo1Q5W51iLvNxJ0,1189
+easyvista_python_client/models/common.py,sha256=9gJVle_6__Z2Fb3vkERbOTheD_rf_vzUkiEggphJFV0,2916
+easyvista_python_client/models/department.py,sha256=eFvpna182TgrMMpv9_HnWubc-PLJgIXO-yPPxlq5TZ8,2588
+easyvista_python_client/models/document.py,sha256=SkSmwZLpZrS1_OTpAcaDjomP8GcEyn4STnQZzK0Xwi0,1341
+easyvista_python_client/models/employee.py,sha256=wOEIAOx_jDrlPZpdkWrGySu3UXkmN9zbL_oQnDev_F4,2967
+easyvista_python_client/models/request.py,sha256=ZPkudojJGbdoICpwXhq_EVNU5ZCAmgod0vREtwexTtY,8659
+easyvista_python_client/resources/__init__.py,sha256=UXwFN01OuF__HlYFPoYQt28P247kt3FoVKFClqNVCIk,73
+easyvista_python_client/resources/actions.py,sha256=APXcs8HEWfLmwl1wqYmf-u5CRxzkpWHcF_YxMBd5GZw,2955
+easyvista_python_client/resources/assets.py,sha256=YPmf4i2feS2c2uw6QU52-flHg7fsdawEL5Z48dL0o0k,1321
+easyvista_python_client/resources/departments.py,sha256=FylNkg91zvuXwIjA5LJGeKWbqn6LaGwAji0UfDGvCV4,1572
+easyvista_python_client/resources/descriptor.py,sha256=TR3bgnej76D3t_QCqCkVcmTMppMlsr8PBFA519gNpvo,3395
+easyvista_python_client/resources/documents.py,sha256=PaGOKhu32A93o_IB9Fg2CTQ4AH3PE1Pvq0Me17Dyv-c,2686
+easyvista_python_client/resources/employees.py,sha256=HYb7FK3nf7dkjf5FlGCWawf32O1vPFJOcFGLoQQhuCw,1516
+easyvista_python_client/resources/requests.py,sha256=SkO6uX2Wilqcm6tZP-6mXow5ShMcz29g86Qx6f3RfqI,2814
+easyvista_python_client-0.1.0.dist-info/METADATA,sha256=5t5DBcMlnfkE3qwnEtsRosxyyPaXcnHRle4TkMovhhM,6503
+easyvista_python_client-0.1.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+easyvista_python_client-0.1.0.dist-info/licenses/LICENSE,sha256=COAKFzPjsNCUJS82NnwBj20wPEHE34Dl8GzGZzaQWR0,1093
+easyvista_python_client-0.1.0.dist-info/RECORD,,

easyvista_python_client-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

easyvista_python_client-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 easyvista-python-client contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.