Skip to content

jeffshurtliff/freshpy

Repository files navigation

FreshPy

A Python toolset for utilizing the Freshservice API

Latest Stable Release PyPI
Latest Dev/Beta/RC Release PyPI
Build Status N/A
Supported Versions PyPI - Python Version
Documentation Documentation Status
License License (GitHub)
Issues GitHub open issues
GitHub closed issues
Pull Requests GitHub pull open requests
GitHub closed pull requests

Installation

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

pip install freshpy --upgrade

You may also clone the repository and install from source using below.

git clone git://github.com/jeffshurtliff/freshpy.git
cd freshpy/
python setup.py install

Usage

This section provides basic usage instructions for the package.

Importing the package

Rather than importing the base package, it is recommended that you import the primary FreshPy class using the syntax below.

from freshpy import FreshPy

Initializing a FreshPy object instance

The primary FreshPy object serves many purposes, the most important being to establish a connection to the Freshservice environment with which you intend to interact. As such, when initializing an instance of the FreshPy object, you will need to pass it the Freshservice URL (e.g. example.freshservice.com) and the API key it will use to authenticate so that the connection can be established.

Passing the information directly into the object

The domain and API key can be passed directly into the FreshPy object when initializing it, as demonstrated in the example below.

fresh = FreshPy(domain='example.freshservice.com', api_key='abc123DEF456')

Interacting with the Freshservice API

Once the FreshPy object instance has been initialized, it can be leveraged to interact with a Freshservice environment in many ways, which is fully documented in the official documentation. The example below demonstrates how information for a specific incident ticket can be retrieved in JSON format.

ticket_data = fresh.tickets.get_ticket(1299)

License

MIT License

Changelog

Refer to the changelog for version change information.

Reporting Issues

Issues can be reported within the GitHub repository.

Additional Resources

Additional resources for leveraging the Freshservice API can be found in the official Freshservice API Reference Documentation.

Donations

If you would like to donate to this project then you can do so using this PayPal link.

Disclaimer

This package is considered unofficial and is in no way endorsed or supported by Freshservice.

About

A Python toolset for utilizing the Freshservice API

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages