snow 0.3.0

Python asyncio library for ServiceNow

snow: Python asyncio library for ServiceNow

Snow is a simple and lightweight yet powerful and extensible library for interacting with ServiceNow. It works with modern versions of Python, utilizes asyncio and can be used for simple scripting as well as for building high-concurrency backend applications on top of the ServiceNow platform.

Example code

from snow import Snow
from snow.schemas.table import IncidentSchema as Incident

app = Snow(
    "https://my-instance.service-now.com",
    basic_auth=("<username>", "<password>")
)

# Make a TableModel object from the built-in Incident schema
async with app.get_table(Incident) as inc:
    # Get incident with number INC01234
    response = await inc.get_one(Incident.number == "INC01234")
    print(response["description"])

Documentation

The Snow API reference and more is available in the documentation.

Examples

Check out some usage examples to quickly get a feel for the library.

Funding

The Snow 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 Snow.

Development status

The fundamental components (models, client code, error handling, documentation, etc) of the library is considered complete. However, automatic testing and real-world use is somewhat lacking, i.e. there are most likely bugs lurking about, and the software should be considered Alpha, shortly Beta.

Contributing

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

Author

Robert Wikman <[e-mail]>