Metadata-Version: 2.1
Name: idms
Version: 0.2.1
Summary: Python class to talk to idms REST and Search API, better known as iDMS.
Home-page: https://github.com/Provincie-Zuid-Holland/idms
Author: Daniel Overdevest
Author-email: d.overdevest@pzh.nl
Project-URL: Bug Reports, https://github.com/ProvZH/idms/issues
Project-URL: Source, https://github.com/ProvZH/idms
Keywords: idms,contentserver,restapi,searchapi
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.5, <4
Description-Content-Type: text/markdown
Provides-Extra: dev
Provides-Extra: test
License-File: LICENSE.txt

# iDMS

![Upload Python Package](https://github.com/ProvZH/iDMS/workflows/Upload%20Python%20Package/badge.svg)


Python class to talk to iDMS REST and Search API within Provincie Zuid-Holland.

# Goal
The goal of the package is to have an easy interface to use the API in Python.

Mainly focussed to work with Content Server 21.4, see [API docs](
https://developer.opentext.com/apis/14ba85a7-4693-48d3-8c93-9214c663edd2/d7540c64-7da2-4554-9966-069c56a9341d/09aaed57-c70b-4092-bace-762b42520293).

# Quick start
## Requirements
1. `pip install idms`
2. `pip install pandas` (optional - for easy data transformation)
3. `pip install openpyxl` (optional - to write to Excel file)

##  Sample code
```python
import getpass
import idms.api.contentserver as cs
import pandas # optional

baseUrl = "idms-url"
idms_username = getpass.getpass(prompt='IDMS username:')
idms_password = getpass.getpass(prompt='IDMS password:')
idms = cs.crawler(baseUrl, idms_username, idms_password)

array = idms.search("overdevest prox[1,f] daniel)")
print(f"Found {len(array)} search results")

# optional load results in a data frame to export results.
df = pd.DataFrame(arr)
print(df)

# Export results to Excel
df.to_excel("searchresults.xlsx")
```

# Development
Package is hosted on GitHub. After each change increase version number and create a new Release on GitHub. The pipeline will trigger a release to PyPi (see status batch above).

## Collaborate?
Send a PR!

# Disclaimer
The developers of this package are not affiliated with OpenText.
