wilt 3.3.0

Wilt - both a browser and server based CouchDB client library

Introduction

Wilt is based on the lightweight SAG PHP CouchDB library available here. Users of this library should recognise the structure of Wilt easily. A common processing body is specialised by the use of browser(dart:html) or server(dart:io) HTTP adapters to allow operation in the browser or the server.

Wilt implements the document/attachment/database storage and manipulation interfaces of SAG along with the utility functions such as get session information etc. It does not directly implement the manipulation of design documents, clients however can manipulate these items by constructing their own URL's and using the basic httpRequest method.

Asynchronicity through the HTTP adapter is provided by the use of a standard Dart futures based interface or by using client supplied completion callbacks.

Authentication is provided using the Basic HTML method, cookie authentication is not supported, see the CouchDB_and CORS.txt document in the doc directory for more details here.

Wilt is a fully functional standalone library, however it is envisaged that higher level client specific application layers will be wrapped around Wilt to add specific CouchDB response parsing as Wilt returns JSON Objects(or strings) to the client. It has no knowledge of correct/incorrect responses such as conflict errors for instance, i.e it has no real CouchDB intelligence other than supplying success or error responses from its HTTP interface adapter.

Please read the STARTHERE.txt document in the docs directory for more detailed information.

Examples

Numerous examples of Wilt usage in both browser and server environments are coded as tests in the unit test suite under the test directory. Please read the Testing.txt document in doc/testing for further details.

Contact

Wilt is hosted here. Please use github to raise issues, any other queries you can direct to me at <steve.hamblett@linux.com>

3.3.0

Update to latest packages/Dart environment. Retire the completion tests.

3.2.0

Issues 15, 21, 22 and 23.

3.1.2

Update to latest HTTP package

3.1.1

Issue 17, CouchDb 1.6.1 updates

3.1.0

Updates for Issues 13, 11 and 14

3.0.1

Updates for Dart V1.5.3, all tests running.

3.0.0

Issues 8 and 9, this makes Wilt both Browser and Server capable

2.3.0

Issue 7 fixed

2.2.2

Issue 6 fixed

2.2.1

Issue 5 fixed

2.2.0

Issues 3 and 4 fixed.

2.1.0

Standalone attachments added Change notification interface added

2.0.0

Updated for Dart 1.0 release Unit tests now use expectAsync0(() Native adapter success/error response hardening Various bugs NOTE - No API changes.

1.2.0

API docs generated

Updated to use dart:convert

1. Depend on it

Add this to your package's pubspec.yaml file:

dependencies:
  wilt: "^3.3.0"

2. Install it

You can install packages from the command line:

$ pub get

Alternatively, your editor might support 'pub get'. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:

import 'package:wilt/wilt.dart';

Platforms

Server
Web

About

A browser/server based CouchDB library

Author

Email steve.hamblett@linux.com S. Hamblett

Homepage

github.com/shamblett/wilt

Documentation

www.dartdocs.org/documentation/wilt/3.3.0/

Source code (hyperlinked)

www.crossdart.info/p/wilt/3.3.0/

Uploader

stevehamblett@gmail.com

License

AGPL 3.0

Published

Jul 19, 2017

Share