Skip to main content

Asynchronous Python ServiceNow library

Project description

aiosnow: Asynchronous Python ServiceNow Library

image image image image image

aiosnow is a Python asyncio library for interacting with ServiceNow programmatically. It hopes to be:

  • Convenient: A good deal of work is put into making the library flexible and easy to use.
  • Performant: Uses non-blocking I/O to allow large amounts of API request tasks to run concurrently while being friendly on system resources.
  • Modular: Core functionality is componentized into modules that are built with composability and extensibility in mind.

Example code

import asyncio

import aiosnow
from aiosnow.models.table.declared import IncidentModel as Incident

async def main():
    client = aiosnow.Client("<instance>.service-now.com", basic_auth=("<username>", "<password>"))

    async with Incident(client, table_name="incident") as inc:
        # Fetch high-priority incidents
        for response in await inc.get(Incident.priority <= 3, limit=5):
            print(f"Number: {response['number']}, Priority: {response['priority'].value}")

asyncio.run(main())

Check out the examples directory for more material.

Documentation

API reference and more is available in the technical documentation.

Funding

The aiosnow code is permissively licensed, and can be incorporated into any type of application–commercial or otherwise–without costs or limitations. Its author believes it's in the commercial best-interest for users of the project to invest in its ongoing development.

Consider leaving a donation if you like this software, it will:

  • Directly contribute to faster releases, more features, and higher quality software.
  • Allow more time to be invested in documentation, issue triage, and community support.
  • Safeguard the future development of aiosnow.

Development status

Beta: Core functionality is done and API breakage unlikely to happen.

Contributing

Check out the contributing guidelines if you want to help out with code or documentation.

Author

Robert Wikman <rbw@vault13.org>

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for aiosnow, version 0.6.0
Filename, size File type Python version Upload date Hashes
Filename, size aiosnow-0.6.0-py3-none-any.whl (36.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size aiosnow-0.6.0.tar.gz (24.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page