NAME
Mojo::CouchDB
SYNOPSIS
use Mojo::CouchDB;
# Create a CouchDB instance
my $couch = Mojo::CouchDB->new('http://localhost:6984', 'username', 'password');
my $db = $couch->db('books');
$db->create_db; # Create the database on the server
# Make a document
my $book = {
title => 'Nineteen Eighty Four',
author => 'George Orwell'
};
# Save your document to the database
$book = $db->save($book);
# If _id is assigned to a hashref, save will update rather than create
say $book->{_id}; # Assigned when saving or getting
$book->{title} = 'Dune';
$book->{author} = 'Frank Herbert'
# Re-save to update the document
$book = $db->save($book);
# Get the document as a hashref
my $dune = $db->get($book->{_id});
# You can also save many documents at a time
my $books = $db->save_many([{title => 'book', author => 'John'}, { title => 'foo', author => 'bar' }])->{docs};
db
my $db = $couch->db('books');
Create an instance of "Mojo::CouchDB::DB" that corresponds to the database name specified in the first parameter.
new
my $url = 'https://127.0.0.1:5984';
my $couch = Mojo::CouchDB->new($url, $username, $password);
Creates an instance of "Mojo::CouchDB". The URL specified must include the protocol either http
or https
as well as the port your CouchDB instance is using.
API
Mojo::CouchDB =item * Mojo::CouchDB::DB
AUTHOR
Rawley Fowler, rawleyfowler@proton.me
.
CREDITS
LICENSE
Copyright (C) 2023, Rawley Fowler and contributors.
This program is free software, you can redistribute it and/or modify it under the terms of the Artistic License version 2.0.