MOCO Ruby Gem

require 'moco'

moco = MOCO::Client.new(
  subdomain: "your-subdomain", # Your MOCO subdomain
  api_key: "your-api-key"      # Your MOCO API key
)

projects    = moco.projects
activities  = moco.activities
users       = moco.users
# ... and so on for all supported entities

# Get all entities in a collection
all_projects = moco.projects.all

# Get entities matching specific criteria
active_projects = moco.projects.where(active: true)
recent_activities = moco.activities.where(date: ">=2024-01-01")

# Get a specific entity by ID
project = moco.projects.find(12345)
user = moco.users.find(678)

# Create a new project
new_project = moco.projects.create(
  name: "New Website Project",
  customer_id: 987,
  billable: true
)
puts "Created project: #{new_project.name} (ID: #{new_project.id})"

# Create a new time entry (activity)
new_activity = moco.activities.create(
  date: "2024-04-10",
  project_id: new_project.id,
  task_id: new_project.tasks.first.id, # Assumes project has tasks
  hours: 3.5,
  description: "Implemented feature X"
)
puts "Created activity: #{new_activity.description} on #{new_activity.date}"

project = moco.projects.find(12345)
project.name = "Updated Project Name"
project.billable = false

if project.save
  puts "Project updated successfully."
else
  puts "Failed to update project: #{project.errors.full_messages.join(", ")}" # Assuming error handling exists
end

# You can also update directly via the collection
moco.projects.update(12345, name: "Another Update", active: false)

# Delete by object
activity = moco.activities.find(9876)
if activity&.delete
  puts "Activity deleted."
end

# Delete by ID via collection
if moco.activities.delete(9876)
  puts "Activity deleted."
end

project = moco.projects.find(12345)

# Get tasks associated with the project
tasks = project.tasks # Returns a collection proxy for tasks
puts "Tasks for project '#{project.name}': #{tasks.map(&:name).join(', ')}"

# Get activities for the project
project_activities = project.activities
puts "Activities count: #{project_activities.size}"

# Get the customer (company) for the project
customer = project.customer # Returns a MOCO::Company object
puts "Customer: #{customer.name}"

# ---

activity = moco.activities.find(9876)

# Get the associated project, task, and user
act_project = activity.project
act_task = activity.task
act_user = activity.user
puts "Activity by #{act_user.firstname} on project '#{act_project.name}' (Task: #{act_task.name})"

project = moco.projects.find(12345)

# Create a new task for the project
new_task = project.tasks.create(
  name: "New Feature Development",
  billable: true,
  active: true,
  budget: 40,
  hourly_rate: 120
)
puts "Created task: #{new_task.name} (ID: #{new_task.id})"

# Delete all tasks for a project
project.tasks.destroy_all

# Query tasks with conditions
billable_tasks = project.tasks.where(billable: true).all
puts "Billable tasks: #{billable_tasks.map(&:name).join(', ')}"

# Find a specific task
dev_task = project.tasks.find_by(name: "Development")