GitLocker: The Coding Marketplace

Description:

khorosjx 3.2.0

Khoros JX Python Library
The khorosjx library acts as a Python software development kit (SDK) to administer and manage
Khoros JX
(formerly Jive-x)
and Jive-n online community platforms.

Latest Stable Release

Build Status

Supported Versions

Documentation

License

Issues

Pull Requests

Installation
The package can be installed via pip using the syntax below.
pip install khorosjx

You may also clone the repository and install from source using the syntax below.
git clone git://github.com/jeffshurtliff/khorosjx.git
cd khorosjx/
python setup.py install

Change Log
The change log is located in the documentation here: https://khorosjx.readthedocs.io/en/latest/changelog.html
Usage
This section provides basic usage instructions for the package.
Importing the package
The package can be imported into a Python script using the syntax below.
import khorosjx

Initializing the modules
While it is certainly possible to import modules directly (e.g. from khorosjx import users), it is recommended that you instead leverage the init_module() function as shown below.
khorosjx.init_module('content', 'users')

In the example above, both the khorosjx.content and the khoros.users modules have been initiated.

Note: It is not necessary to import the khorosjx.core module as it is imported by default.

Establishing the API connection
Before leveraging the API in function calls, you must first establish your connection by providing the base URL for the environment (e.g. https://community.example.com) and the username and password for the unfederated service account through which the API calls will be made. This is demonstrated below.
base_url = 'https://community.example.com'
credentials = ('adminuser', 'password123!')
khorosjx.core.connect(base_url, credentials)

Note: At this time the library only allow connections using basic authentication, but there are plans to include the ability to leverage OAuth 2.0 in a future release.

Once the connection has been established, you can proceed to leverage the library of functions in the various modules as needed.
Requirements
The following packages are leveraged within the khorosjx package:

numpy 1.17.4
pandas-0.25.3
python-dateutil 2.8.1
pytz 2019.3
requests 2.22.0
urllib3 1.25.7

The full requirements list can be found in the requirements.txt file.
Documentation
The documentation is located here: https://khorosjx.readthedocs.io/en/latest/
License
MIT License
Reporting Issues
Issues can be reported within the GitHub repository.
Disclaimer
This package is considered unofficial and is in no way endorsed or supported by the Khoros or Aurea Software, Inc. companies.