library apist {🖫 1,425, ⚐ 12, ★ 313}

sleeping-owl/apist

Package to provide api-like access to foreign sites based on html parsing

Wednesday, April 29, 2015
by sleeping-owl
Repository
27 Watchers
313 Stars
1,425 Installations

HTML
2 Dependents
0 Suggesters
43 Forks
2 Open issues
12 Versions
1 % Grown

The README.md

SleepingOwl Apist

, _(*1)

SleepingOwl Apist is a small library which allows you to access any site in api-like style, based on html parsing., _(*2)

Overview

This package allows you to write method like this:, _(*3)

class WikiApi extends Apist
{

    public function getBaseUrl()
    {
        return 'http://en.wikipedia.org';
    }

    public function index()
    {
        return $this->get('/wiki/Main_Page', [
            'welcome_message'  => Apist::filter('#mp-topbanner div:first')->text()->mb_substr(0, -1),
            'portals'          => Apist::filter('a[title^="Portal:"]')->each([
                'link'  => Apist::current()->attr('href')->call(function ($href)
                {
                    return $this->getBaseUrl() . $href;
                }),
                'label' => Apist::current()->text()
            ]),
            'languages'        => Apist::filter('#p-lang li a[title]')->each([
                'label' => Apist::current()->text(),
                'lang'  => Apist::current()->attr('title'),
                'link'  => Apist::current()->attr('href')->call(function ($href)
                {
                    return 'http:' . $href;
                })
            ]),
            'sister_projects'  => Apist::filter('#mp-sister b a')->each()->text(),
            'featured_article' => Apist::filter('#mp-tfa')->html()
        ]);
    }
}

and get the following result:, _(*4)

{
    "welcome_message": "Welcome to Wikipedia",
    "portals": [
        {
            "link": "http:\/\/en.wikipedia.org\/wiki\/Portal:Arts",
            "label": "Arts"
        },
        {
            "link": "http:\/\/en.wikipedia.org\/wiki\/Portal:Biography",
            "label": "Biography"
        },
        ...
    ],
    "languages": [
        {
            "label": "Simple English",
            "lang": "Simple English",
            "link": "http:\/\/simple.wikipedia.org\/wiki\/"
        },
        {
            "label": "العربية",
            "lang": "Arabic",
            "link": "http:\/\/ar.wikipedia.org\/wiki\/"
        },
        {
            "label": "Bahasa Indonesia",
            "lang": "Indonesian",
            "link": "http:\/\/id.wikipedia.org\/wiki\/"
        },
        ...
    ],
    "sister_projects": [
        "Commons",
        "MediaWiki",
        ...
    ],
    "featured_article": "<div style=\"float: left; margin: 0.5em 0.9em 0.4em 0em;\">...<\/div>"
}