Pylon API Ruby Client

gem 'pylon-api'

require 'pylon'

client = Pylon::Client.new(api_key: 'your_api_key')

# Enable debug mode to see request/response details
client = Pylon::Client.new(api_key: 'your_api_key', debug: true)

# Instead of accessing attributes like a hash: issue['title']
# You can use object methods: issue.title

# Collections are enumerable and can be iterated over
issues.each do |issue|
  puts "#{issue.id}: #{issue.title} (#{issue.status})"
end

# Get current user details
me = client.get_current_user
puts "Logged in as: #{me.email} (#{me.name})"

# List accounts with pagination
accounts = client.list_accounts(page: 1, per_page: 20)
accounts.each do |account|
  puts "#{account.id}: #{account.name}"
end

# Get a specific account
account = client.get_account('account_id')
puts "Account name: #{account.name}"

# Access the raw response if needed
response = account._response

# List issues (requires time range, max 30 days)
start_time = Time.now.utc - 86400 # 24 hours ago
end_time = Time.now.utc

issues = client.list_issues(
  start_time: start_time.iso8601,
  end_time: end_time.iso8601,
  page: 1,
  per_page: 20,
  status: 'open' # optional filter
)

# Iterate through issues
issues.each do |issue|
  puts "#{issue.id}: #{issue.title} (#{issue.status})"
end

# Create an issue
issue = client.create_issue(
  title: 'New Issue',
  description: 'Issue description'
)

# Access issue properties directly
puts "Created issue #{issue.id}: #{issue.title}"

# List teams
teams = client.list_teams(page: 1, per_page: 20)

# Create a team
team = client.create_team(name: 'Engineering')

# Get a specific team
team = client.get_team('team_id')

# List users
users = client.list_users(page: 1, per_page: 20)

# Create a user
user = client.create_user(
  email: 'user@example.com',
  name: 'New User'
)

# Get a specific user
user = client.get_user('user_id')

# Update a user
updated_user = client.update_user('user_id', { name: 'Updated Name' })

# List tags
tags = client.list_tags(page: 1, per_page: 20)

# Create a tag
tag = client.create_tag(
  name: 'bug',
  color: '#ff0000'
)

# List ticket forms
forms = client.list_ticket_forms(page: 1, per_page: 20)

# Create a ticket form
form = client.create_ticket_form(
  name: 'Bug Report',
  fields: [
    { name: 'severity', type: 'select' }
  ]
)

# Create an attachment from raw content
attachment = client.create_attachment(file_content)

# Create an attachment from a file
file = File.open('document.pdf', 'rb')
attachment = client.create_attachment(file)

# Create an attachment from a URL with description
attachment = client.create_attachment(nil, 
  file_url: 'https://example.com/document.pdf',
  description: 'Important document'
)

begin
  client.get_issue('non_existent_id')
rescue Pylon::ResourceNotFoundError => e
  puts "Issue not found: #{e.message}"
rescue Pylon::ApiError => e
  puts "API error: #{e.message}"
end

require 'pylon'

client = Pylon::Client.new(api_key: ENV['PYLON_API_KEY'], debug: true)

begin
  me = client.get_current_user
  puts "Successfully connected as: #{me['email']}"
rescue => e
  puts "Error: #{e.message}"
end