TappNetwork / laravel-airtables

src/AirtableManager.php

<?php

namespace Tapp\Airtable;

use Illuminate\Support\Arr;
use InvalidArgumentException;
use Tapp\Airtable\Api\AirtableApiClient;

class AirtableManager
{
    /**
     * The application instance.
     *
     * @var \Illuminate\Foundation\Application
     */
    protected $app;

    /**
     * The active connection instances.
     *
     * @var array
     */
    protected $tables = [];

    /**
     * Create a new Airtable manager instance.
     *
     * @param  \Illuminate\Foundation\Application  $app
     * @return void

Adding a @return annotation to constructors is generally not recommended as a constructor does not have a meaningful return value.

     */
    public function __construct($app)
    {
        $this->app = $app;
    }

    /**
     * Get a airtable table instance.
     *
     * @param  string  $name
     * @return \Airtable\Table
     */
    public function table($name = null)
    {
        $name = $name ?: $this->getDefaultTable();

        return $this->tables[$name] = $this->get($name);
    }

    /**
     * Get the configuration for a table.
     *
     * @param  string  $name
     * @return array
     *
     * @throws \InvalidArgumentException
     */
    protected function configuration($name)
    {
        $name = $name ?: $this->getDefaultTable();

        // To get the aritable table configuration, we will just pull each of the
        // connection configurations and get the configurations for the given name.
        // If the configuration doesn't exist, we'll throw an exception and bail.
        $tables = $this->app['config']['airtable.tables'];

        if (is_null($config = Arr::get($tables, $name))) {
            throw new InvalidArgumentException("Table [{$name}] not configured.");
        }

        return $config;
    }

    /**
     * Get the default connection name.
     *
     * @return string
     */
    public function getDefaultTable()
    {
        return $this->app['config']['airtable.default'];
    }

    /**
     * Set the default connection name.
     *
     * @param  string  $name
     * @return void
     */
    public function setDefaultTable($name)
    {
        $this->app['config']['airtable.default'] = $name;
    }

    /**
     * Return all of the created connections.
     *
     * @return array
     */
    public function getTables()
    {
        return $this->tables;
    }

    /**
     * Set the given table instance.
     *
     * @param  string  $name
     * @param  mixed  $table
     * @return $this
     */
    public function set($name, $table)
    {
        $this->tables[$name] = $table;

        return $this;
    }

    /**
     * Attempt to get the table from the local cache.
     *
     * @param  string  $name
     * @return \Tapp\Airtable
     */
    protected function get($name)
    {
        return $this->tables[$name] ?? $this->resolve($name);
    }

    /**
     * Resolve the given table.
     *
     * @param  string  $name
     * @return Airtable
     *
     * @throws \InvalidArgumentException
     */
    protected function resolve($name)
    {
        $config = $this->getConfig($name);

        if ($config) {

The expression $config of type array is implicitly converted to a boolean; are you sure this is intended? If so, consider using ! empty($expr) instead to make it clear that you intend to check for an array without elements.

            return $this->createAirtable($config);
        } else {
            throw new InvalidArgumentException("Table [{$name}] is not configured.");
        }
    }

    protected function createAirtable($config)
    {
        $base = $this->app['config']['airtable.base'];
        $access_token = $this->app['config']['airtable.key'];

        $client = new AirtableApiClient($base, $config, $access_token);

        return new Airtable($client, $config);
    }

    /**
     * Get the table configuration.
     *
     * @param  string  $name
     * @return array
     */
    protected function getConfig($name)
    {
        return $this->app['config']["airtable.tables.{$name}"];
    }

    /**
     * Dynamically pass methods to the default connection.
     *
     * @param  string  $method
     * @param  array   $parameters
     * @return mixed
     */
    public function __call($method, $parameters)
    {
        return $this->table()->$method(...$parameters);
    }
}