newage

Working with multiple blueprint files

This document describes 4 different solutions to work APIs that consist of multiple blueprint files. Every of this solution work with all Apiary.io features but editing. To edit a blueprint you have to do it outside of Apiary as Apiary editor does not support working with multiple files. In other words if you are using one of the solutions below avoid editing the blueprint in Apiary.

1. Hercule

Hercule is a CLI tool written in Node.js – available as an NPM package. It uses markdown referencing and linking syntax to transclude other files into a blueprint file. This solution is universal and would work with any Markdown files not just API Blueprint.

The major benefit – unlike any other solutions here – is also that the references are rendered as HTML links in any Markdown editor so the result is HTML that can be browsed!

newage

namespace Album;

 // Add these import statements:
 use Album\Model\Album;
 use Album\Model\AlbumTable;
 use Zend\Db\ResultSet\ResultSet;
 use Zend\Db\TableGateway\TableGateway;

 class Module
 {

newage

<?xml version="1.0" encoding="UTF-8"?>
<project name="ci-phing-behat-test" default="dev">

    <!-- load variable definitions -->
    <property file="build.properties"/>

    <property name="behat.basedir" value="${project.basedir}/../test"/>

    <!-- define custom tasks and types -->
    <typedef name="args" classname="phing.behat.types.BehatArguments"/>

newage

$adapter = $this->getAdapter();
$platform = $adapter->getPlatform();
$predicateIn = 'DATE('.$platform->quoteIdentifierChain(array('dt_created')).')';
$predicateIn .= " IN (";
$predicateIn .= $platform->quoteValueList($days);
$predicateIn .= ")";
$select->where(array($predicateIn));

newage

/**
 * Insert many rows as one query
 * @param array $data Insert array(array('field_name' => 'field_value'), array('field_name' => 'field_value_new'))
 * @return bool
 */
public function multiInsert(array $data)
{
    $sqlStringTemplate = 'INSERT INTO %s (%s) VALUES %s';
    $adapter = $this->tableGateway->adapter; /* Get adapter from tableGateway */
    $driver = $adapter->getDriver();

newage

/**
 * Use INSERT ... ON DUPLICATE KEY UPDATE Syntax
 * @since mysql 5.1
 * @param array $insertData For insert array('field_name' => 'field_value')
 * @param array $updateData For update array('field_name' => 'field_value_new')
 * @return bool
 */
public function insertOrUpdate(array $insertData, array $updateData)
{
    $sqlStringTemplate = 'INSERT INTO %s (%s) VALUES (%s) ON DUPLICATE KEY UPDATE %s';