arsduo/koala

Koala is a Ruby gem that serves as a client library for the Facebook Platform, providing a unified interface for interacting with Facebook's Graph and REST APIs. It handles core social media operations including OAuth token management, batch API execution, real-time update subscriptions, and test user utilities. The system manages HTTP communication via Faraday, enforcing HTTPS by default and supporting complex request structures like file uploads and pagination.

5 changes.

This period established the foundational structure of the Koala gem, including project scaffolding, documentation, and community guidelines. It involved the removal of legacy Facebook Graph API client code and the introduction of a unified Ruby client library for Facebook's APIs. The work culminated in defining the core architecture with Faraday-based HTTP requests and a consolidated API interface.

8 changes.

This period focused on establishing a comprehensive RSpec test suite with fixtures and coverage tools to validate the library's core functionality. Concurrently, the HTTP service layer was refactored to enforce HTTPS by default and introduce dedicated request and response objects, improving security and code structure.

This change establishes the foundational structure for the Koala gem by adding essential configuration and documentation files. It introduces a .gitignore to exclude build artifacts and IDE files, an .rspec file to enable randomized test execution, and .yardopts for documentation generation. It also adds standard repository metadata including a LICENSE, a Manifest of gem contents, a Rakefile for running specs, and a comprehensive changelog.md. Furthermore, it provides GitHub issue and pull request templates to guide community contributions, along with a Code of Conduct to define community standards.

(repo-wide) · high confidence

Introduces the Koala gem, a Ruby client for the Facebook Platform. The library provides a unified API for interacting with Facebook's Graph and REST APIs, OAuth token management, real-time update subscriptions, and test user utilities. It defaults to using Faraday for HTTP requests and includes a configuration system for managing API credentials and HTTP options.

lib · high confidence

The \src/facebook.rb\ file containing the \Facebook::GraphAPI\ class and its associated error handling has been deleted. This removes the built-in Net::HTTP-based client for interacting with the Facebook Graph API, including methods for fetching objects, managing connections, and posting to walls.

src · high confidence

This release introduces a unified \Koala::Facebook::API\ class that consolidates Graph API methods, replacing the previous separation of GraphAPI and RestAPI. It adds a global \Koala::Configuration\ object for managing settings like access tokens, app secrets, and rate limit hooks, and updates the HTTP service to use Faraday by default. The \Koala::Facebook::APIError\ class now exposes detailed error information including Facebook trace IDs and rate limit usage. Additionally, \TestUsers\ and \RealtimeUpdates\ are now standalone classes with improved initialization and validation, and the library version is bumped to 3.7.0.

lib/koala · high confidence

The HTTP service layer has been restructured to use dedicated \Request\ and \Response\ classes, standardizing how API calls are constructed and how responses are parsed. A key behavioral change is that HTTPS is now enforced by default for all requests, improving security out of the box. Additionally, the \UploadableIO\ component has been updated to accept \Tempfile\ objects directly, simplifying file upload handling in various frameworks.

_lib/koala/http\service · high confidence

The batch API execution logic has been restructured to improve reliability and support for complex requests. Batch operations now explicitly handle access tokens and appsecret proofs for individual calls within a batch, ensuring correct authentication even when tokens differ. Pagination URL parsing has been updated to use the Addressable::URI library, fixing issues with non-encoded URLs returned by Facebook. Additionally, the batch API now supports recursive calls and better handles edge cases such as empty bodies or invalid JSON responses, while extracting error checking into a dedicated class for clearer error reporting.

lib/koala/api · high confidence

Added integration test for Graph Collections; Added test coverage for HTTPService Request and Response classes; Added test fixtures for OAuth, Graph API, and Batch API mocking; Added test support infrastructure and shared examples; Comprehensive test suite for Koala core components; Initialize RSpec test suite with coverage and configuration.

Koala 1.0 is now available, requiring Ruby 2.1 or higher. The library has switched its HTTP client from the deprecated Faraday-stack to Faraday and faraday-multipart, providing a more flexible and feature-rich connection layer. Runtime dependencies have been updated to include addressable, json (\>= 1.8), rexml, base64, ostruct, and cgi, while development and test dependencies now use RSpec 3.0, VCR, WebMock, and SimpleCov.

(dependencies) · high confidence

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

• CAI 64 → 63 (-1.5)
• Rubric changed (rubric-2026.09.8 → rubric-2026.09.16) — scores are not directly comparable.

• Code Health 99 → 99 (+0.0)
• Architecture 100 → 74 (-26.4)
• Maturity 49 → 49 (+0.0)
• Readiness 67 → 70 (+2.4)
• Security 81 → 85 (+4.9)

• High: security finding (details withheld)

• Ambiguous naming for configuration access. configure likely sets global state, while config likely retrieves it. However, without signatures (getters/setters), it is unclear if config is a getter or a setter. If config is a setter, it duplicates configure. If it is a getter, the naming convention is inconsistent with typical Ruby idioms where config might imply the object itself rather than an action.
• Inconsistent HTTP request abstraction. Koala.make_request takes raw parameters (path, args, verb, options) directly, while HTTPService.make_request expects a structured Request object. This forces users to either bypass the service layer or manually construct Request objects, creating a split in how HTTP calls are initiated.
• Inconsistent pluralization vs singular naming for similar operations. While get_object vs get_objects is a common pattern, the presence of get_connection (singular) vs get_connections (plural, used in put_connections/delete_connections context) suggests a potential inconsistency in how single vs multiple resources are handled. Specifically, get_connection fetches a specific connection, but there is no get_connections to fetch multiple connections at once, whereas get_object/get_objects exists.
• Redundant methods in Koala.Facebook.API. Both graph_call and api appear to perform the same HTTP request operation with identical signatures (minus post_processing on api, which might be optional or handled internally). This creates confusion about which method to use for standard API calls.

• 1 commits — 1 feature/other, 0 fixes

• (root) — 1 commit

• change: CI: Remove Code Climate coverage reporting (#706)

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

arsduo/koala was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.