Skip to main content

Python wrapper for JSS API.

Project description

# python-jss

## Introduction: This project aims to offer simple, elegant, pythonic access to the Jamf Casper JSS API.

Jamf provides access to the JSS and most of its object types through a REST API. python-jss allows you interact with the API to create new objects, list or edit the existing ones, and to upload files to configured distribution points.

The level of coverage for convenience methods and properties is primarily centered on Computer management, and specifically, those aspects which factor into policy and package management.

Automating policy creation is streamlined; however, class MobileDeviceInvitations provides nothing beyond basic JSSObject methods and properties to the API. Those aspects which I use heavily in our organization, and in support of [JSSImporter](https://www.github.com/sheagcraig/JSSImporter), tend to be more fleshed out, whereas aspects of the JSS API that I never use tend to be minimalistic. However, based on the code here, it should be easy for anyone wishing to do so to implement a new() method for those objects they’re interested in, and I would be happy to include them. Send me your pull requests!

## Installing: The easiest method is to use pip to grab python-jss: $ pip install python-jss

However, if you use JSSImporter, its package installer uses easy_install since that is included on pre-10.10.5 OS X. You may want to use easy_install instead: $ easy_install -U python-jss.

If you don’t have pip, you should probably get it: https://pip.pypa.io/en/latest/installing.html

Alternately, download the source and copy the python-jss package wherever you normally install your packages.

Behind the scenes, python-jss requires the requests, pyasn1, and ndg-httpsclient packages. If you install using easy-install or pip, these dependencies are handled for you. Otherwise, you’ll have to acquire them yourself: easy_install -U pyasn1 ndg-httpsclient requests

## Linux: python-jss on Linux has some extra dependencies if you need to be able to mount distribution points. - AFP distribution points require the fuse-afp package. - SMB distribution points require the cifs-utils package.

As I’m currently developing on Fedora, these requirements are specific to RedHat-based distros. Feel free to test and comment on Debian so I can update!

## Usage: Please see [the wiki](https://github.com/sheagcraig/python-jss/wiki) for complete documentation.

Also, [my blog](http://sheagcraig.github.io) has a series of posts about using [python-jss](https://github.com/sheagcraig/python-jss), [JSSImporter](https://github.com/sheagcraig/JSSImporter), and [jss_helper](https://github.com/sheagcraig/jss_helper), and solving unique problems using these tools.

Project details


Download files

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

Source Distribution

python-jss-2.1.0.tar.gz (79.2 kB view details)

Uploaded Source

Built Distribution

python_jss-2.1.0-py3-none-any.whl (109.3 kB view details)

Uploaded Python 3

File details

Details for the file python-jss-2.1.0.tar.gz.

File metadata

  • Download URL: python-jss-2.1.0.tar.gz
  • Upload date:
  • Size: 79.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.23.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.10

File hashes

Hashes for python-jss-2.1.0.tar.gz
Algorithm Hash digest
SHA256 c7e238456413c145dcad44d71fb2601bc97233d1f61f8a49f68cbdf5d16eaa28
MD5 183cf182328945a7b705248b6a784beb
BLAKE2b-256 22eeb59041d8a7f6bbc4d476fd0e6fb57b5fd4f42235eed440a8404e43f6c1da

See more details on using hashes here.

File details

Details for the file python_jss-2.1.0-py3-none-any.whl.

File metadata

  • Download URL: python_jss-2.1.0-py3-none-any.whl
  • Upload date:
  • Size: 109.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.23.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.10

File hashes

Hashes for python_jss-2.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d1d9f845af02d2e2112ebeacfbad71cddf7a79e3593dc66469e3f1653ee07677
MD5 5300a949d63acbfab8752307b821d157
BLAKE2b-256 71d77c33f97c45a921dce03d598952beda74e69e22c6deb4cd3d25019633dc32

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page