grink's Journal

Config::JFDI 0.04 released

grink — 2008-10-09T23:38:52+00:00

Config-JFDI 0.04 should be on CPAN shortly

Config::JFDI mimics Catalyst::Plugin::ConfigLoader (without the need to load Catalyst). The new features in this release are:

Value substitution, just like C::P::CL (__HOME__, __path_to(...)__, __literal(...)__, etc.)
Ability to accept a default hash for a baseline configuration

Config::JFDI 0.04 released

POD-like documentation for JavaScript: Doc::Simply

grink — 2008-10-09T05:06:09+00:00

I've just released Doc::Simply, a tool for generating documentation from JavaScript (or C, C++, etc.) comments.

I use it to for my b9j documentation

The idea came to me while developing some JavaScript: I was craving a way to drop in free-form documentation in a .js file as easily as I could in a .pm with perlpod.

The Doc::Simply format is modeled after Plain-Old-Documentation, but it is not an exact mimic. Body formatting, for example, is in Markdown (no C<>, L<>, ...)

However, if you are craving pure POD, then it shouldn't be too difficult to bolt a proper parser/generator on top of Doc::Simply

You can run it from the command-line as doc-simply doc-simply < source.js > documentation.html doc-simply --help

An example:
   /*
    * @head1 NAME
    *
    * Calculator - Add 2 + 2 and return the result
    *
    */

   // @head1 DESCRIPTION
   // @body Add 2 + 2 and return the result (which should be 4)

   /*
    * @head1 FUNCTIONS
    *
    * @head2 twoPlusTwo
    *
    * Add 2 and 2 **and** return 4
    *
    */

   function twoPlusTwo() {
       return 2 + 2; // Should return 4
   }

/*
* @head1 AUTHOR
*
* Alice <alice@example.com>
*
* [http://example.com](http://example.com)
*
*/

... which will generate this document

You can download it from http://search.cpan.org/CPAN/authors/id/R/RK/RKRIMEN/Doc-Simply-0.02.tar.gz

... or install it via cpan:cpan -i Doc::Simply

POD-like documentation for JavaScript: Doc::Simply

JavaScript URI/URL object

grink — 2008-09-11T23:21:11+00:00

I've put together an interactive example of my JavaScript URI object:

b9j.uri.URI example

The example will also show the code necessary to perform the given operation (next to the result)

b9j.uri.URI overview:

Parses using Steven Levithan's parseUri 1.2
Easy path traversal (ascend to parent, descend to a child)
Set or add to the URI query (with proper encoding), get/interrogate the query (with proper decoding)
Add arbitrary data (unencoded) to the end of the query string, for extra flexibility
Manipulate/interrogate the scheme, user information (username & password), host, port, fragment, and more in a piecewise fashion
Add, change or strip the extension (html, js, css, ...) from a given URI

The code is available at http://appengine.bravo9.com/b9j/b9j.uri.js (19kb compressed / 5kb gzipped)

Large Hadron Collider (LHC) webcam

grink — 2008-09-10T22:36:51+00:00

Large Hadron Collider webcam, pretty interesting:

http://www.cyriak.co.uk/lhc/lhc-webcams.html

(thanks gcohen!)

URI handling in JavaScript with b9j.uri

grink — 2008-09-04T18:47:50+00:00

Following my b9j.path release, I just finished up work on URI object-class for javascript.

It uses Steven Levithan's parseUri 1.2 to do the parsing.

Some example usage:var uri = new b9j.uri.URI( "http://example.com/a/b?a=1&b=2&c=3&c=4&c=5" ) var host = uri.host() var child = uri.child("c.html") // http://example.com/a/b/c.html?a=1& b=2& ... child.query().add({ c: [ 6, 7 ], d: 8 }) // ... ?a=1&b=2&c=3&c=4&c=5&c=6&c=7&d =8 child.query().set("b", 9) // ... ?a=1&b=9&c ... return child.toString()

Again, while CPAN has URI.pm for URI-handling, JavaScript didn't really have an equivalent (parsing yes -- modifying/generating no).

b9j.uri - URI parsing, manipulation, and generation

URI handling in JavaScript with b9j.uri: a URI/URI-query parser, manipulator, and generator

Path handling in JavaScript with b9j.path

grink — 2008-08-28T02:10:34+00:00

b9j.path provides a way to parse, manipulate, and generate URI/UNIX-style paths.

CPAN provides lots of different options for path-handling and path-manipulation, but there didn't seem to be anything really available in JavaScript-land.

To fill the gap, I've released b9j.path: var path = new b9j.path.Path("/a/b/c") // /a/b/c/xyzzy var child = path.child("xyzzy") // /a/b var parent = path.parent() // ... and much, much, more...

It's part of my b9j javascript pack available at: http://appengine.bravo9.com/b9j/b9j-latest.zip

» Download

» Documentation

» Test

Path handling in JavaScript with b9j.path: a UNIX-style path parser, manipulator, and generator

b9jTest: Simplifying and enhancing YUI Test

grink — 2008-08-26T23:22:55+00:00

YUI Test is a great tool for javascript testing, but it has a couple of small issues:

Setting up the HTML document requires many different .js and .css assets
The actual javascript code to set up the test environment is not trivial (setting up the TestRunner, setting up the TestLogger, etc.)
A failed assertion will abort the test function immediately, preventing later tests from running

b9jTest addresses the problems above by:

Bundling all the required .js and .css assets into just two separate files
Providing some boilerplate javascript so you can jump right into testing without a lot of setup

An example b9jTest document:<html> <head> <meta http-equiv="content-type" content="text/html; charset=utf-8"> <title>b9jTest example</title> <link rel="stylesheet" type="text/css" href="http://appengine.bravo9.com/b9j/b9jTest.css"> <script type="text/javascript" src="http://appengine.bravo9.com/b9j/b9jTest.js"></script> </head> <body class="yui-skin-sam"> <div id="testLogger"></div> <script type="text/javascript"> b9jTest(function(test) { test.areEqual("xyzzy", "xyzzy"); test.areEqual("apple", "apple"); test.areEqual("banana", "banana"); }); </script> </body>

b9jTest() is a global function that accepts a function that is called with a testing object. The testing object provides access to the standard YUI assertions and more.

Documentation:

http://appengine.bravo9.com/b9j/documentation/b9jTest.html

Download:

b9jTest.js
b9jTest.css

b9jTest: Simplifying and enhancing YUI Test

Copying text into the clipboard with javascript

grink — 2008-08-24T01:30:25+00:00

Example of copying text into the clipboard

Firefox won't allow copying text into the clipboard via javascript for a variety of reasons.

For better or worse, you can get around this problem with a little .swf (Flash): function copyIntoClipboard(text) { var flashId = 'flashId-HKxmj5'; /* Replace this with your clipboard.swf location */ var clipboardSWF = 'http://appengine.bravo9.com/copy-into-clipboard/clip board.swf'; if(!document.getElementById(flashId)) { var div = document.createElement('div'); div.id = flashId; document.body.appendChild(div); } document.getElementById(flashId).innerHTML = ''; var content = '<embed src="' + clipboardSWF + '" FlashVars="clipboard=' + encodeURIComponent(text) + '" width="0" height="0" type="application/x-shockwave-flash"></embed >'; document.getElementById(flashId).innerHTML = content; }

The above trick will also work in Safari, IE, and Opera.

Download clipboard.swf

Alternatively, you can use the Google App Engine hosted version at
http://appengine.bravo9.com/copy-into-clipboard/clipboard.swf

(Originally adapted from http://www.jeffothy.com/weblog/clipboard-copy/)

Copying text into the clipboard with javascript in Firefox, Safari, IE, Opera, ...

Getopt::Chain released: git(1) style command-line processing

grink — 2008-08-17T20:30:48+00:00

Getopt::Chain

Option and subcommand processing in the style svn(1) and git(1)

Getopt::Chain will help you make your command-line scripts work like this: ./script --opt --opt=<value> cmd --opt ... ./script cmd ...

NOTE: Any option specification covered by Getopt::Long is fair game.

Here is some example usage: #!/usr/bin/perl -w use strict; use Getopt::Chain; # A partial, pseudo-reimplementation of git(1): Getopt::Chain->process( options => [qw/ version bare git-dir=s /] run => sub { my $context = shift; my @arguments = @_; # Remaining, unparsed arguments # ... do stuff before any subcommand ... } commands => { init => { options => [qw/ quiet|q --template=s /] run => sub { my $context = shift; my @arguments = @_; # Again, remaining unparsed arguments # ... do init stuff ... } } commit => { options => [qw/ all|a message|m=s /] run => sub { my $context = shift; # ... do commit stuff .. } } add => ... help => ... ... } ) # The above will allow the following (example) usage: # # ./script --version # ./script --git-dir path/to/repository init # ./script --git-dir path/to/repository commit -a --message '...' # ./script commit -m '~'

The source repository is on GitHub: http://github.com/robertkrimen/getopt-chain/tree/master

Getopt::Chain released: git(1) and svn(1) style command-line processing

Hash::Param released

grink — 2008-08-16T16:20:04+00:00

Hash::Param

A CGI/Catalyst::Request-like parameter-hash accessor/mutator my $params = Hash::Param->new(parameters => { qw/a 1 b 2 c 3/, d => [qw/4 5 6 7/], }) $result = $params->param( a ) # Returns 1 $result = $params->param( d ) # Returns 4 @result = $params->param( d ) # Returns 4, 5, 6, 7 @result = $params->params # Returns a, b, c, d $result = $params->params # Returns { a => , b => 2, c => 3, d => [ 4, 5, 6, 7 ] } @result = $params->params( a, b, d ) # Returns 1, 2, [ 4, 5, 6, 7 ] %result = $params->slice( a, b ) # Returns a => 1, b => 2 $params->param( a => 8 ) # Sets a to 8 $params->param( a => 8, 9 ) # Sets a to [ 8, 9 ]

The source repository is on GitHub: http://github.com/robertkrimen/hash-param/tree/master

Hash::Param released

String::Comments::Extract released

grink — 2008-08-14T06:14:32+00:00

String::Comments::Extract my $comments = String::Comments::Extract::C->extract($source)

String::Comments::Extract is a tool for extracting comments from C/C++/JavaScript/Java. The extractor is implemented using an actual tokenizer (written in C via XS [adapted from JavaScript::Minifier::XS]). By using a tokenizer, it can correctly deal with notoriously problematic cases, such as comment-like structures embedded in strings: std::cout << "This is not a // real C++ comment " << std::endl printf("/* This is not a real C comment */\n"); # The extractor will ignore both of the above

The source repository is on GitHub: http://github.com/robertkrimen/string-comments-extract/tree/master

String::Comments::Extract released

A simple lightbox (modal) dialog with YUI

grink — 2008-08-12T20:12:54+00:00

Example of a simple lightbox (modal) dialog with YUI

A lightbox (modal) dialog is an effective way to bring attention to an input form or important message.

You'll need the following YUI assets: <link rel="stylesheet" type="text/css" href="http://yui.yahooapis.com/2.5.2/ build/reset-fonts-grids/reset-fonts-grids.css"> <link rel="stylesheet" type="text/css" href="http://yui.yahooapis.com/2.5.2/ build/container/assets/skins/sam/container.css"> <script type="text/javascript" src="http://yui.yahooapis.com/2.5.2/build/yah oo-dom-event/yahoo-dom-event.js"></script> <script type="text/javascript" src="http://yui.yahooapis.com/2.5.2/build/con tainer/container-min.js"></script>

The easiest way to make a lightbox in YUI is to construct a YAHOO.widget.Panel and use .setBody to put in content: var panel = new YAHOO.widget.Panel( "panel", // The element id { width: "480px", fixedcenter: true, close: false, draggable: false, zindex: 4, modal: true, visible: false } ); panel.setBody("<p>Aliquam ultrices. Nulla dictum, augue et condimentum commo do.</p>"); panel.render(document.body); panel.show();

One gotcha to keep in mind is that the class attribute of the page <body> must include yui-skin-sam. The yui-skin-sam class is necessary to provide:

Basic styling for the panel (such as border and drop shadow)
Darkening of the contents behind the panel

Another gotcha with the example is that you cannot change the content after rendering (doing so will cause the close link to stop working). This has to do with associating an event handler with a DOM node and then destroying that node when you change the content. Event delegation is a good solution to this problem.

A simple lightbox (modal) dialog with YUI

CPAN: Where is the source repository for $DIST?

grink — 2008-08-10T00:19:11+00:00

Something that would be nice to have:

The ability to embed a link to the project's source repository so that search.cpan.org could display it.

You can do this by sticking something in the POD, but having it in a standard place (like Links:) would be much, much better:
* You could find the project's repository without hunting through the POD * You could tell, at a glance, if a project has a repository that the author would like to share * It would encourage users to contribute documentation and bug fixes

URI::PathAbstract released

grink — 2008-08-04T08:38:59+00:00

I've just released URI::PathAbstract into the wild, which is a melding of URI and Path::Abstract

You can use it to do things like:
my $uri = URI::PathAbstract->new("http://example.com?a=b")

$uri->down("apple") # http://example.com/apple?a=b

$uri->query("c=d&e=f") # http://example.com/apple?c=d&e=f

$uri->path("grape/blueberry/pineapple") # http://example.com/grape/blueberry/pineapple?c=d&e=f

$uri = $uri->parent # http://example.com/grape/blueberry?c=d&e=f

Google::AJAX::Library released

grink — 2008-06-07T02:20:57+00:00

Just released Google::AJAX::Library for accessing the Google AJAX Libraries API in Perl.

Here is some example usage: use Google::AJAX::Library; my $library = Google::AJAX::Library->jquery; $library->uri # http://ajax.googleapis.com/ajax/libs/jquery/1/jquery.min.js $library->html # <script src="http://ajax.googleapis.com/ajax/libs/jquery/1/jquery.min.js" type="text/javascript"></script>

Google::AJAX::Library released