drf_client

Description:

drf client

Helps you to automatically authenticate and store tokens and refresh them, also make api requests using them.
This project is under development. View the GitHub code and contribute 👉 https://github.com/Otajonov/drf_client
Features #

✅ Automatically store tokens using Flutter Secure Storage
✅ Automatically refresh tokens
✅ Supports Oauth2 by Django Oauth Toolkit
✅ Easy REST API call with auth credentials
✅ More coming soon ...

Getting started #
To start using package, add it to your dependencies by running this:
flutter pub add drf_client
copied to clipboard
or add this line into your pubspec.yaml under dependencies:
dependencies:
flutter:
sdk: flutter
# your other dependencies ...

drf_client: <latest_version>
copied to clipboard
Then import the package in desired files:
import 'package:drf_client/drf_client.dart';
copied to clipboard
Enjoy coding!
Usage #
Firstly, initialize the config:

void main() {

// existing code

DrfClient client = DrfClient();
client.addConfig('your-app', DrfConfig(
authType: AuthType.drfBuiltInAuth,
baseUrl: 'https://your-app.com/api',
tokenUrl: 'https://your-app.com/api/token',
refreshTokenUrl: 'https://your-app.com/api/token/refresh',

usernameField: 'username', // default username, change this if you are using custom user model in django
passwordField: 'password', // def password, change this if you changed password field in you user model
refreshField: 'refresh_token', // change this to comply with your token refresh logic if JWT used


// Set this if u are using Authorization Code over Django-oauth-toolkit
// oauthConfig: OauthConfig(
// clientId: "",
// clientSecret: "",
// authorizationEndpointUrl: "https://ilmchat.com/auth/authorize/",
// redirectScheme: 'you-app-shceme'
//
// )
));
}

copied to clipboard
You can also set multiple config so that you can make request and authenticate multiple django servers at the same code by giving specific app name in config.
Authenticating users #
via drfBuiltInAuth:

DrfClient client = DrfClient();

client.loginDrfBuiltIn()


copied to clipboard
making requests #

DrfClient client = DrfClient();

client.get() // post() put() patch() delete()


copied to clipboard
It will use stored user token in requests if logged in.
You can remove Token from auth header by includeToken: false