Metadata-Version: 2.1
Name: userkit
Version: 1.0.0
Summary: Python bindings for UserKit: user login and account management
Home-page: https://github.com/workpail/userkit-python
Author: Workpail
Author-email: info@workpail.com
License: MIT
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/markdown
Requires-Dist: requests

# Python UserKit

## Summary
A UserKit client library for Python 3.

## Installation

You can use pip to install userkit:

```
pip install userkit
```

Or [download](https://github.com/workpail/userkit-python/archive/master.zip), then copy or symlink the `userkit-python/userkit` sub-directory into
your project.

## Documentation

For full examples and docs checkout [UserKit documentation][userkit-docs].

## Example usage

```python
import userkit
uk = userkit.UserKit("<YOUR_APP_SECRET_KEY>")

# Create a user
user = uk.users.create_user(email="jane.smith@example.com",
                            password="secretpass")

# Fetch a user
user = uk.users.get_user("<USER_ID>")

# Update a user
user = uk.users.update_user("<USER_ID>", name="Jane Smith")

# Login a user
session = uk.users.login_user("jane.smith@example.com", "secretpass")

# Fetch a logged in user by their session-token
user = uk.users.get_current_user(session.token)
if user:
    print("User is logged in:")
    print(user)
else:
    print("No logged in user, invalid session token")
```

## Test

To run tests you need to create a test-app.

Set the `USERKIT_KEY` environment variable to your test app key, then
run python's unittest:
```
USERKIT_KEY=<YOUR_APP_SECRET_KEY> python -m unittest discover
```


[userkit-docs]: https://docs.userkit.io


