SimplyCouch

gem 'simply_couch'

gem 'simply_couch', git: 'https://github.com/bterkuile/simply_couch.git'

gem 'couchrest'  # or couchbase, or any CouchDB HTTP client

class User
  include SimplyCouch::Model

  property :name
  property :email
  property :active, type: Boolean
  property :last_login, type: Time
  property :tags, type: Array

  has_many :posts
  belongs_to :company

  view :by_name, key: :name
  view :active_by_created, key: :created_at, conditions: 'doc.active == true'
end

class Post
  include SimplyCouch::Model

  property :title
  property :body

  belongs_to :user
end

# CRUD
user = User.create(name: 'Alice', email: 'alice@example.com', active: true)
user.update(name: 'Alice B.')
user.destroy

# Queries
User.find_by_name('Alice')
User.find_all_by_active(true)
User.active_by_created(descending: true)
User.all(page: 1, per_page: 40)

# Associations
user.posts                     # => [Post, ...]
user.posts(limit: 5, order: :desc)
user.post_count                # => 42

property :name
property :age,        type: Integer
property :price,      type: Float
property :active,     type: Boolean   # stored as true/false
property :last_login, type: Time
property :tags,       type: Array
property :metadata,   type: Hash

class Post
  include SimplyCouch::Model
  has_many :comments, dependent: :destroy
  has_many :authors, through: :comments, source: :user
  belongs_to :category
end

class User
  include SimplyCouch::Model
  has_and_belongs_to_many :networks, storing_keys: true
end

class Page
  include SimplyCouch::Model
  property :categories
  validates_containment_of :categories, in: %w[news blog docs]
end

view :by_status, key: :status
view :published, key: :created_at, conditions: 'doc.status == "published"'
view :by_tags, key: :tags  # array properties work too

Post.all(page: 2, per_page: 25)
User.active_by_created(page: 1, per_page: 50, descending: true)

class Document
  include SimplyCouch::Model
  enable_soft_delete  # defaults to :deleted_at
end

doc = Document.create(title: 'draft')
doc.destroy
Document.all                          # => [] (soft-deleted filtered out)
Document.all(with_deleted: true)      # => [doc] (recoverable)

class Page
  include SimplyCouch::Model
  property :title
  has_ancestry
end

# Build trees
parent = Page.create(title: 'Products')
child = Page.create(title: 'Widgets', parent: parent)

# Query trees
Page.roots                    # pages with no parent
Page.full_tree                # entire tree loaded in one query
parent.children               # direct children
parent.descendants            # all descendants (flattened)
child.ancestors               # path to root

# Scoped trees (different trees per property)
has_ancestry by_property: :locale

User.find_by_name('Alice')
User.find_all_by_active(true)
User.count_by_active(true)

Post.all(include: :user)              # loads users with posts
Post.all(include: [:user, :comments]) # multiple associations

User.auto_conflict_resolution_on_save = false  # disable

class ArchivedPost
  include SimplyCouch::Model
  use_database 'http://couchdb:5984/archive'
end

class Post
  include SimplyCouch::Model
  split_design_documents_per_view  # each view → own _design doc

  view :by_user_id, key: :user_id   # → _design/Post_view_by_user_id
  view :by_status,  key: :status    # → _design/Post_view_by_status
end

class Invoice
  include SimplyCouch::Model
  include SimplyCouch::Model::Attachments
end

invoice.put_attachment('receipt.pdf', file, content_type: 'application/pdf')
invoice.fetch_attachment('receipt.pdf')
invoice.delete_attachment('receipt.pdf')
invoice.attachment_names  # => ['receipt.pdf', 'logo.png']

gem 'aws-sdk-s3'

# config/initializers/simply_couch.rb
SimplyCouch.s3_defaults = {
  bucket: 'myapp-development',
  access_key: ENV['S3_ACCESS_KEY'],
  secret_access_key: ENV['S3_SECRET_KEY'],
  location: :eu  # :us or :eu, defaults to :us
}

# Or load from a YAML file with ERB:
SimplyCouch.load_s3_config(Rails.root.join('config', 's3.yml'))

# Or from Rails encrypted credentials:
SimplyCouch.s3_defaults = Rails.application.credentials.s3

class Report
  include SimplyCouch::Model

  has_s3_attachment :pdf  # uses defaults from SimplyCouch.s3_defaults
  has_s3_attachment :thumbnail, bucket: 'thumbnails'  # override bucket
end

report = Report.new
report.pdf = File.read('monthly.pdf')          # assign content
report.pdf = ['line1', 'line2']                # arrays serialized to JSON
report.save                                     # uploads to S3
report.pdf_size                                 # => 24501 (bytes)
report.pdf_url                                  # presigned URL

# Read back
report.pdf                                      # fetches from S3 on first access

# Delete
report.destroy                                  # also deletes from S3 if configured