myconsciousness/sweet-cookie-jar

A most easily usable cookie management library in Dart. With SweetCookieJar, you can easily manage cookie on your application.

A most easily usable cookie management library in Dart!

• 1. About
  • 1.1. Introduction
    • 1.1.1. Install Library
    • 1.1.2. Import It
    • 1.1.3. Use SweetCookieJar
  • 1.2. License
  • 1.3. More Information

1. About

SweetCookieJar is an open-sourced Dart library.
With SweetCookieJar, you can easily manage cookie on your application.

SweetCookieJar is a library that extends the functionality of the official Cookie class. It also works with Responses in the http package, and even if multiple set-cookie are set in the response header, which is a weak point in the http package, SweetCookieJar can manage these cookie information very easily!

No more difficult implementation is needed to handle multiple set-cookie set in response header in Dart. Just pass the Response to the constructor of SweetCookieJar!

1.1. Introduction

1.1.1. Install Library

With Dart:

 dart pub add sweet_cookie_jar

With Flutter:

 flutter pub add sweet_cookie_jar

1.1.2. Import It

import 'package:sweet_cookie_jar/sweet_cookie_jar.dart';

1.1.3. Use SweetCookieJar

import 'package:sweet_cookie_jar/sweet_cookie_jar.dart';

void main() {
    // The cookie set in the response header
    // will be extracted by the constructor process.
    final cookieJar = SweetCookieJar.from(response: response);

    if (cookieJar.isEmpty) {
        // It means that there is no cookie information
        // in the response header.
        return;
    }

    // You can find cookie by name easily.
    final cookie = cookieJar.find(name: 'AWSALB');
    print(cookie.name);
    print(cookie.value);

    // Also you can get cookie as JSON format.
    print(cookie.toJson());

    if (cookie.isExpired) {
        // Do something when cookie is expired.
        return;
    }
}

1.2. License

Copyright (c) 2021, Kato Shinya. All rights reserved.
Use of this source code is governed by a
BSD-style license that can be found in the LICENSE file.

1.3. More Information

SweetCookieJar was designed and implemented by Kato Shinya.

• Creator Profile
• License
• API Document
• Release Note
• Bug Report

sweet-cookie-jar's Issues

Can't use with http: 1.0.0 version

Hi,

Thanks for this Sweet Cookie Jar package, I'm trying to use this package with http package version 1.0.0.

But I'm facing the below version solving issue

Because sweet_cookie_jar 1.1.0 depends on http ^0.13.4 and no versions of sweet_cookie_jar match >1.1.0 <2.0.0, sweet_cookie_jar ^1.1.0 requires http ^0.13.4.
So, because team_appcommon depends on both http ^1.0.0 and sweet_cookie_jar ^1.1.0, version solving failed.

Can you release new version for Sweet Cookie Jar package?

Exception thrown when cookie values contain invalid characters

Hi, I'm encountering an exception on the SweetCookieJar.from() function when set-cookie header contains invalid characters.

// r.headers['set-cookie'] contains invalid characters in the cookie sent by server 
var cookieBin = SweetCookieJar.from(response: r); 

My current workaround is to perform string manipulation on the cookie string to replace those invalid characters..

merge two `SweetCookieJar`s

I'm working with https://github.com/jossef/requests which does http requests with seamless cookies in between them. I would like to use this package instead of a custom made CookieJar, but SweetCookieJar is lacking a way to edit the cookies inside it.

So I would like a way to alter the cookies inside a SweetCookieJar (and also a way to merge 2 SweetCookieJars).

This way a CookieJar can be altered with some newly set cookies by the server, and then resent on a new request.