attio 0.1.1

data/.gitignore

@@ -0,0 +1,10 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/vendor/
+*.gem

data/.rspec

@@ -0,0 +1,4 @@
+--require spec_helper
+--color
+--format documentation
+--order random

data/.rubocop.yml

@@ -0,0 +1,133 @@
+require:
+  - rubocop-rspec
+
+AllCops:
+  TargetRubyVersion: 3.0
+  NewCops: enable
+  Exclude:
+    - 'vendor/**/*'
+    - 'bin/**/*'
+    - 'coverage/**/*'
+    - 'docs/**/*'
+    - 'tmp/**/*'
+    - '*.gemspec'
+    - 'Gemfile'
+    - 'Rakefile'
+
+# Layout and formatting
+Layout/LineLength:
+  Max: 120
+  AllowedPatterns: ['\A\s*#']
+
+Layout/MultilineMethodCallIndentation:
+  EnforcedStyle: indented
+
+# Metrics
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*'
+    - 'Rakefile'
+
+Metrics/MethodLength:
+  Max: 20
+  CountAsOne: ['array', 'hash', 'heredoc']
+
+Metrics/ClassLength:
+  Max: 150
+
+Metrics/ModuleLength:
+  Max: 150
+
+Metrics/AbcSize:
+  Max: 20
+
+Metrics/CyclomaticComplexity:
+  Max: 8
+
+Metrics/PerceivedComplexity:
+  Max: 8
+
+# Style
+Style/Documentation:
+  Enabled: false
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+
+Style/FrozenStringLiteralComment:
+  Enabled: true
+
+Style/TrailingCommaInArrayLiteral:
+  EnforcedStyleForMultiline: comma
+
+Style/TrailingCommaInHashLiteral:
+  EnforcedStyleForMultiline: comma
+
+Style/TrailingCommaInArguments:
+  EnforcedStyleForMultiline: no_comma
+
+Style/ClassAndModuleChildren:
+  EnforcedStyle: compact
+
+Style/EmptyMethod:
+  EnforcedStyle: expanded
+
+# Naming
+Naming/PredicateName:
+  ForbiddenPrefixes:
+    - is_
+
+Naming/AccessorMethodName:
+  Enabled: false
+
+# RSpec specific cops
+RSpec/ExampleLength:
+  Max: 15
+
+RSpec/MultipleExpectations:
+  Max: 5
+
+RSpec/NestedGroups:
+  Max: 4
+
+RSpec/DescribeClass:
+  Enabled: true
+
+RSpec/FilePath:
+  Enabled: true
+
+RSpec/ContextWording:
+  Prefixes:
+    - when
+    - with
+    - without
+    - if
+    - unless
+    - for
+
+RSpec/DescribedClass:
+  Enabled: true
+
+# Security
+Security/Eval:
+  Enabled: true
+
+Security/Open:
+  Enabled: true
+
+Security/YAMLLoad:
+  Enabled: true
+
+# Bundler
+Bundler/OrderedGems:
+  Enabled: true
+
+# Gemspec
+Gemspec/OrderedDependencies:
+  Enabled: true
+
+Gemspec/RequiredRubyVersion:
+  Enabled: true

data/.yardopts

@@ -0,0 +1,18 @@
+--markup markdown
+--markup-provider redcarpet
+--output-dir docs
+--private
+--protected
+--no-cache
+--embed-mixins
+--hide-void-return
+--readme README.md
+--main README.md
+--title "Attio Ruby Client Documentation"
+--template default
+--markup-provider=redcarpet
+--charset utf-8
+lib/**/*.rb
+-
+README.md
+CHANGELOG.md

data/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.1] - 2025-08-11
+
+### Changed
+- Updated gem description to remove "Official" designation
+
+## [0.1.0] - 2025-08-11 - Initial Release (yanked)
+
+### Added
+- Initial implementation of Attio Ruby client
+- Support for all major Attio API endpoints:
+  - Records (CRUD operations, querying)
+  - Objects (list, get schema)  
+  - Lists (list, get entries)
+  - Workspaces (list, get current)
+  - Attributes (list, create, update)
+  - Users (list, get current user)
+- Comprehensive error handling
+- Connection pooling and retry logic
+- Full test suite with RSpec
+- Code coverage reporting
+
+### Documentation
+- Complete API documentation with YARD
+- Usage examples and guides
+- Development setup instructions

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,37 @@
+# Code of Conduct
+
+## Our Pledge
+
+We pledge to make participation in our project a respectful and professional experience for everyone.
+
+## Our Standards
+
+Examples of positive behavior include:
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints
+* Gracefully accepting constructive feedback
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior include:
+* Unprofessional or unwelcome comments
+* Personal attacks
+* Public or private harassment
+* Publishing others' private information without permission
+* Other conduct which could reasonably be considered inappropriate
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying standards of acceptable behavior and are expected to take appropriate corrective action in response to unacceptable behavior.
+
+## Scope
+
+This Code of Conduct applies within project spaces and in public spaces when representing the project.
+
+## Enforcement
+
+Instances of unacceptable behavior may be reported to the project team. All complaints will be reviewed and investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the Contributor Covenant, version 2.0.

data/CONTRIBUTING.md

@@ -0,0 +1,280 @@
+# Contributing to Attio Ruby Client
+
+Thank you for your interest in contributing to the Attio Ruby client! This guide will help you get started with contributing to the project.
+
+## Table of Contents
+
+- [Getting Started](#getting-started)
+- [Development Setup](#development-setup)
+- [How to Contribute](#how-to-contribute)
+- [Reporting Issues](#reporting-issues)
+- [Submitting Pull Requests](#submitting-pull-requests)
+- [Coding Standards](#coding-standards)
+- [Testing](#testing)
+- [Documentation](#documentation)
+- [Release Process](#release-process)
+
+## Getting Started
+
+1. Fork the repository on GitHub
+2. Clone your fork locally:
+   ```bash
+   git clone https://github.com/YOUR_USERNAME/attio-ruby.git
+   cd attio-ruby
+   ```
+3. Add the upstream remote:
+   ```bash
+   git remote add upstream https://github.com/idl3/attio-ruby.git
+   ```
+
+## Development Setup
+
+1. Install Ruby 3.0 or higher
+2. Install dependencies:
+   ```bash
+   bundle install
+   ```
+3. Run tests to verify setup:
+   ```bash
+   bundle exec rspec
+   ```
+4. Run linting:
+   ```bash
+   bundle exec rubocop
+   ```
+
+### Setting up API credentials for testing
+
+Create a `.env` file in the project root:
+```bash
+ATTIO_API_KEY=your_test_api_key
+```
+
+## How to Contribute
+
+### Finding Issues to Work On
+
+- Check our [issue tracker](https://github.com/idl3/attio-ruby/issues) for open issues
+- Look for issues labeled `good first issue` or `help wanted`
+- Comment on an issue to let others know you're working on it
+
+### Creating New Features
+
+1. Open an issue to discuss the feature before starting work
+2. Wait for maintainer feedback and approval
+3. Follow the pull request process below
+
+## Reporting Issues
+
+### Bug Reports
+
+When reporting bugs, please include:
+- Ruby version (`ruby -v`)
+- Gem version
+- Minimal code example that reproduces the issue
+- Full error messages and stack traces
+- Expected vs actual behavior
+
+Use our [bug report template](.github/ISSUE_TEMPLATE/bug_report.md) when creating issues.
+
+### Feature Requests
+
+For feature requests:
+- Clearly describe the problem you're trying to solve
+- Provide use cases and examples
+- Explain why this would benefit other users
+
+Use our [feature request template](.github/ISSUE_TEMPLATE/feature_request.md).
+
+## Submitting Pull Requests
+
+### Before Submitting
+
+1. Create a feature branch:
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
+
+2. Make your changes following our coding standards
+
+3. Write or update tests for your changes
+
+4. Update documentation if needed
+
+5. Run the test suite:
+   ```bash
+   bundle exec rspec
+   bundle exec rubocop
+   ```
+
+6. Update CHANGELOG.md with your changes under "Unreleased"
+
+### Commit Messages
+
+We use [Conventional Commits](https://www.conventionalcommits.org/):
+
+- `feat:` New features
+- `fix:` Bug fixes
+- `docs:` Documentation changes
+- `style:` Code style changes (formatting, etc.)
+- `refactor:` Code refactoring
+- `test:` Test additions or changes
+- `chore:` Maintenance tasks
+- `perf:` Performance improvements
+
+Examples:
+```
+feat: add batch operations support for records
+fix: handle rate limit errors correctly
+docs: update README with pagination examples
+```
+
+### Pull Request Process
+
+1. Push your branch to your fork:
+   ```bash
+   git push origin feature/your-feature-name
+   ```
+
+2. Create a pull request from your fork to the main repository
+
+3. Fill out the PR template completely
+
+4. Wait for automated checks to pass
+
+5. Address any review feedback
+
+6. Once approved, a maintainer will merge your PR
+
+## Coding Standards
+
+### Ruby Style Guide
+
+We use RuboCop to enforce style guidelines. Key points:
+
+- Use 2 spaces for indentation
+- Maximum line length of 120 characters
+- Use descriptive variable and method names
+- Prefer symbols over strings for hash keys
+- Use guard clauses to reduce nesting
+
+### Code Organization
+
+- Keep classes focused and single-purpose
+- Extract complex logic into private methods
+- Use modules for shared behavior
+- Place one class per file
+
+### Error Handling
+
+- Create specific error classes for different error types
+- Include helpful error messages
+- Preserve original error context when re-raising
+
+## Testing
+
+### Writing Tests
+
+- Write tests for all new functionality
+- Maintain test coverage above 85%
+- Use descriptive test names
+- Test both success and failure cases
+- Use fixtures for API response data
+
+### Test Structure
+
+```ruby
+RSpec.describe Attio::Resources::Records do
+  describe '#list' do
+    context 'with valid parameters' do
+      it 'returns a list of records' do
+        # test implementation
+      end
+    end
+    
+    context 'with invalid parameters' do
+      it 'raises an appropriate error' do
+        # test implementation
+      end
+    end
+  end
+end
+```
+
+### Running Tests
+
+```bash
+# Run all tests
+bundle exec rspec
+
+# Run specific test file
+bundle exec rspec spec/attio/resources/records_spec.rb
+
+# Run with coverage report
+COVERAGE=true bundle exec rspec
+```
+
+## Documentation
+
+### Code Documentation
+
+- Document all public methods with YARD
+- Include parameter types and return values
+- Add usage examples for complex methods
+- Keep documentation up-to-date with code changes
+
+Example:
+```ruby
+# Creates a new record in Attio
+#
+# @param object [String] The object type (e.g., 'people', 'companies')
+# @param attributes [Hash] The record attributes
+# @return [Hash] The created record
+# @raise [Attio::InvalidRequestError] if parameters are invalid
+#
+# @example Create a person
+#   client.records.create(
+#     object: 'people',
+#     attributes: { name: 'John Doe', email: 'john@example.com' }
+#   )
+def create(object:, attributes:)
+  # implementation
+end
+```
+
+### README Updates
+
+Update the README when:
+- Adding new features
+- Changing API interfaces
+- Adding configuration options
+- Updating requirements
+
+## Release Process
+
+Releases are managed by maintainers. The process:
+
+1. Update version in `lib/attio/version.rb`
+2. Update CHANGELOG.md with release notes
+3. Create a git tag: `git tag v1.2.3`
+4. Push tag to trigger release workflow: `git push origin v1.2.3`
+5. GitHub Actions will automatically:
+   - Run tests
+   - Build the gem
+   - Publish to RubyGems
+   - Create GitHub release
+
+## Getting Help
+
+- Join our [discussions](https://github.com/idl3/attio-ruby/discussions)
+- Check existing issues and PRs
+- Reach out to maintainers if needed
+
+## Recognition
+
+Contributors will be recognized in:
+- CHANGELOG.md for their contributions
+- GitHub's contributor graph
+- Release notes when applicable
+
+Thank you for contributing to the Attio Ruby client!

data/Gemfile

@@ -0,0 +1,17 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in attio.gemspec
+gemspec
+
+gem "rake", "~> 13.0"
+gem "logger" # Required for Ruby 3.5.0+ compatibility
+
+group :development, :test do
+  gem "rspec", "~> 3.12"
+  gem "webmock", "~> 3.18"
+  gem "simplecov", "~> 0.22"
+  gem "simplecov-console", "~> 0.9"
+  gem "rubocop", "~> 1.50"
+  gem "rubocop-rspec", "~> 2.19"
+  gem "pry", "~> 0.14"
+end

data/Gemfile.lock

@@ -0,0 +1,127 @@
+PATH
+  remote: .
+  specs:
+    attio (0.1.0)
+      typhoeus (~> 1.4)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.8.7)
+      public_suffix (>= 2.0.2, < 7.0)
+    ansi (1.5.0)
+    ast (2.4.3)
+    bigdecimal (3.2.2)
+    coderay (1.1.3)
+    crack (1.0.0)
+      bigdecimal
+      rexml
+    diff-lcs (1.6.2)
+    docile (1.4.1)
+    ethon (0.16.0)
+      ffi (>= 1.15.0)
+    ffi (1.17.2)
+    ffi (1.17.2-arm64-darwin)
+    hashdiff (1.2.0)
+    json (2.13.2)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    method_source (1.1.0)
+    parallel (1.27.0)
+    parser (3.3.9.0)
+      ast (~> 2.4.1)
+      racc
+    prism (1.4.0)
+    pry (0.15.2)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    public_suffix (6.0.2)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.3.0)
+    regexp_parser (2.11.1)
+    rexml (3.4.1)
+    rspec (3.13.1)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.5)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.4)
+    rubocop (1.79.2)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.46.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.46.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    rubocop-capybara (2.22.1)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.72, >= 1.72.1)
+    rubocop-factory_bot (2.27.1)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.72, >= 1.72.1)
+    rubocop-rspec (2.31.0)
+      rubocop (~> 1.40)
+      rubocop-capybara (~> 2.17)
+      rubocop-factory_bot (~> 2.22)
+      rubocop-rspec_rails (~> 2.28)
+    rubocop-rspec_rails (2.29.1)
+      rubocop (~> 1.61)
+    ruby-progressbar (1.13.0)
+    simplecov (0.22.0)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-console (0.9.4)
+      ansi
+      simplecov
+      terminal-table
+    simplecov-html (0.13.2)
+    simplecov_json_formatter (0.1.4)
+    terminal-table (4.0.0)
+      unicode-display_width (>= 1.1.1, < 4)
+    typhoeus (1.4.1)
+      ethon (>= 0.9.0)
+    unicode-display_width (3.1.4)
+      unicode-emoji (~> 4.0, >= 4.0.4)
+    unicode-emoji (4.0.4)
+    webmock (3.25.1)
+      addressable (>= 2.8.0)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
+    yard (0.9.37)
+
+PLATFORMS
+  arm64-darwin-24
+  ruby
+
+DEPENDENCIES
+  attio!
+  logger
+  pry (~> 0.14)
+  rake (~> 13.0)
+  rspec (~> 3.12)
+  rubocop (~> 1.50)
+  rubocop-rspec (~> 2.19)
+  simplecov (~> 0.22)
+  simplecov-console (~> 0.9)
+  webmock (~> 3.18)
+  yard (~> 0.9)
+
+BUNDLED WITH
+   2.7.1

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Ernest Sim
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.