MongoDB Perl Driver v1.0.2 released

The MongoDB Perl driver v1.0.2 has been released on CPAN.

This is a stable bugfix release. Changes include:

  • PERL-198 Validate user-constructed MongoDB::OID objects.
  • PERL-495 Preserve fractional seconds when using dt_type 'raw'.
  • PERL-571 Include limits.h explicitly.
  • PERL-526 Detect stale primaries by election_id (only supported by MongoDB 3.0 or later).
  • PERL-575 Copy inflated booleans instead of aliasing them.

Please see the Changes file if you wish additional detail.

We always appreciate feedback from the user community. Please submit comments, bug reports and feature requests via JIRA.

NOTE: If you use the MongoDB Perl driver, please click the "++" button on the MongoDB release page.

Posted in mongodb | Tagged , , | Comments closed

My Github name has changed from dagolden to xdg

For a long time, my Github identity matched my CPAN ID and I was 'dagolden' on Github. Today, I'm switching to be 'xdg' on Github, to match my Twitter and IRC handles.

The 'dagolden' Github account has become an organization to avoid breaking links and avoid the pain of manually migrating 100's of repositories.

So, henceforth, if you want to highlight me on Github, use "@xdg", not "@dagolden".

Posted in meta | Tagged , , | Comments closed

How to trim PDF margins and edit metadata

I often download academic articles as PDFs to read later. I regularly find two really annoying problems:

  1. Huge margins make the PDF nearly unreadable on my Kindle Fire
  2. Title and authors are missing from PDF metadata, making them harder to find later via search

Today, I found an answer to the first and wrote an answer to the second.

For fixing huge margins, I found the free briss tool, which shows a composite image of all odd and even pages and lets you set a crop box around them.

briss in action cropping PDF margins

briss in action cropping PDF margins

To fix the metadata, I did a bit of Googling for tools, then realized I could whip up a tool with Perl and PDF::API2 faster than hunting for an existing one.

This program reads PDF metadata, opens an editor with the data in JSON format, and takes the result and saves it to a new PDF.

#!/usr/bin/env perl
use v5.10;
use strict;
use warnings;

use JSON::MaybeXS;
use PDF::API2;
use Path::Tiny;

die "Usage: $0 <infile> <outfile>\n" unless @ARGV == 2;

my ( $infile, $outfile ) = @ARGV;

unless ( $infile || -r $infile ) {
    die "Input file '$infile' can't be read\n";

my $pdf = PDF::API2->open($infile);
my $json = JSON::MaybeXS->new( utf8 => 1, pretty => 1 );
my $temp = Path::Tiny->tempfile;
$temp->spew( $json->encode( { $pdf->info } ) );

if ( $ENV{EDITOR} ) {
    system( $ENV{EDITOR}, $temp )
      and die "Error editing temp file: $!\n";
else {
    die "No EDITOR environment variable set.\n";

$pdf->info( %{ $json->decode( $temp->slurp ) } );
Posted in hacks, perl programming | Tagged , , , | Comments closed

MongoDB v1.0.0 released

About to ship v1.0.0
No more release candidates! Earlier this week, with great joy, I shipped MongoDB v1.0.0 to CPAN.

I wrote an article for the MongoDB websiteIntroducing the 1.0 Perl Driver

Also, if you use MongoDB with Perl, I'd greatly appreciate if you could give it a "++" click on MetaCPAN.

Posted in mongodb, perl programming | Tagged , , , | Comments closed

MongoDB Perl driver v1.0.0 RC 3 available – last chance to test

Today, I released the MongoDB Perl Driver v1.0.0 RC3 to CPAN as MongoDB-v0.999.999.6-TRIAL. It has only a handful of small changes, so might be your last chance to test a release candidate before a stable release is shipped.

I've blogged about RC1 and RC2 already, so I don't have much more to add.

As mentioned earlier, please read the MongoDB::Upgrading document, which describes the major changes from the "v0" series to v1.0.0.

Testing the release candidate

You can install RC3 from CPAN like this:

$ cpan MONGODB/MongoDB-v0.999.999.6-TRIAL.tar.gz

If you encounter problems or have questions, please open tickets on the MongoDB Perl driver bug tracker.

Barring any show-stoppers or urgent changes, the stable v1.0.0 MongoDB Perl driver will be shipped to CPAN around the end of August.

Posted in mongodb, perl programming | Tagged , , , | Comments closed