npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

appc-apispy

v0.1.0

Published

Appcelerator API Docs Spy

Downloads

4

Readme

Appcelerator API Docs Spy

This NPM package allows you to query JS(ON) versions of Appcelerator API docs such as for Titanium and Alloy using JSPath and a simplified custom Path syntax.

Install

$ npm install appc-apidocs --save

Usage

Module

Use the module API as follows:

var spy = require('appc-apispy');

// load an object or a JS or JSON file with docs
spy.load('/path/to/docs.json', function(err, docs) {

	if (err) {
		return console.error(err);
	}

	// query the docs
	docs.query('."Ti.UI.View"', {
	
		// optional, since:
		// queries following . will default to 'jspath'
		// queries following / will default to 'path'
		ql: 'jspath',

	}, function(err, res) {
		
		if (err) {
			return console.error(err);
		}

		// should be an array of one
		console.log(res);
		
		// release the (huge) docs from memory
		docs.release();

	});
	
});

Or if you only need to run one query on the same doc that will be released right away:

var spy = require('appc-apispy');

// load an object or a JS or JSON file with docs
spy.query('/path/to/docs.json', '$."Ti.UI.View"', function(err, res) {
	
	if (err) {
		return console.error(err);
	}

	// should be an array of one
	console.log(res);
});

REPL

For easy testing and playing, it includes a REPL:

$ npm run repl

Usage:	query <ql> <query>	Run a query using the given QL.
		load <path>			Load the given API Docs JS/JSON file.
		help				Display this help.

If you've cloned the repo, you can load the 3.5.0 Titanium API:

$ npm run repl
> load test/fixtures/3.5.0.js

Examples queries

All properties of any object with support for Android

.*.properties{.platforms.name === "android"}

Names of all objects with support on iOS:

.*{.platforms.name==="iphone"}.name

Shortcuts

JSPath will automatically expand some shortcuts:

."Ti.UI.View"
."Titanium.UI.View"
.'Titanium.UI.View'	
."Titanium.UI.View"
."Titanium.UI.View.backgroundColor"
Ti.UI.View(.properties|.events|.methods).{.name==="backgroundColor"}

Path syntax

The custom 'path' syntax is a wrapper arround JSPath.

/Ti.UI.View.backgroundColor/*/platforms//name
."Ti.UI.View.backgroundColor".*.platforms..name

Contributing

This project is open source and licensed under the Apache Public License (version 2). Please consider forking this project to improve, enhance or fix issues. If you feel like the community will benefit from your fork, please open a pull request.

To protect the interests of the contributors, Appcelerator, customers and end users we require contributors to sign a Contributors License Agreement (CLA) before we pull the changes into the main repository. Our CLA is simple and straightforward - it requires that the contributions you make to any Appcelerator open source project are properly licensed and that you have the legal authority to make those changes. This helps us significantly reduce future legal risk for everyone involved. It is easy, helps everyone, takes only a few minutes, and only needs to be completed once.

You can digitally sign the CLA online. Please indicate your email address in your first pull request so that we can make sure that will locate your CLA. Once you've submitted it, you no longer need to send one for subsequent submissions.

Legal Stuff

Appcelerator is a registered trademark of Appcelerator, Inc. Arrow and associated marks are trademarks of Appcelerator. All other marks are intellectual property of their respective owners. Please see the LEGAL information about using our trademarks, privacy policy, terms of usage and other legal information at http://www.appcelerator.com/legal.