Net::Z...le2ZOOM(3pm)

πŸ“¦
version 1.04 Β· 2 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble

πŸ¦‹ NAME πŸ¦‹

Net::Z3950::Simple2ZOOM β€” bestie, it's literally a gateway between Z39.50 and SRU/SRW. No cap. πŸ’…


✨ SYNOPSIS ✨

use Net::Z3950::Simple2ZOOM;
$s2z = new Net::Z3950::Simple2ZOOM("somefile.xml");
$s2z->launch_server("someServer", @ARGV);

Like. That's it. That's the whole vibe. πŸŽ€


πŸ’– DESCRIPTION πŸ’–

Okay so the Net::Z3950::Simple2ZOOM module is the one carrying all the application logic of a generic "Swiss Army Gateway" between Z39.50 and SRU. It's what the simple2zoom program runs on, and honestly? There's probably no good reason to make any other program use it. Which is exactly why this library-level documentation is, and I quote, more than usually terse. She said what she said. πŸ™ˆ

The library has literally only two public entry points: the new() constructor and the launch_server() method. The synopsis up there shows how they get used β€” you make a Simple2ZOOM object with new(), then you invoke the launch_server() method on it to… okay get ready for a big surprise here… launch the server. Shocking, I know. 😭

And fr fr β€” that synopsis is basically the entire code of the simple2zoom program. All the work happens inside the library. The program is just the vibe. 🫢


πŸ‘‘ METHODS πŸ‘‘

🌸 new($configFile) 🌸

$s2z = new Net::Z3950::Simple2ZOOM("somefile.xml");

Creates and returns a brand new Simple2ZOOM object, all configured according to the XML file $configFile β€” which is, bestie, the only argument. The format of that file? That's described over in Net::Z3950::Simple2ZOOM::Config. Go read her. πŸ’œ

🌈 launch_server($label, @ARGV) 🌈

$s2z->launch_server("someServer", @ARGV);

Launches the Simple2ZOOM server. And when I say launches, I mean this method never returns. It's giving main character energy that simply does not exit. πŸ’€

The $label string gets used in logging, and the @ARGV vector of command-line arguments is interpreted by the YAZ backend server as described at http://www.indexdata.dk/yaz/doc/server.invocation.tkl


πŸ”₯ SEE ALSO πŸ”₯

  • The simple2zoom program. She's the moment. ⭐
  • The Net::Z3950::Simple2ZOOM::Config manual β€” for the configuration-file format, iykyk. πŸ“„
  • The Net::Z3950::SimpleServer module. πŸ“
  • The ZOOM module (in the Net::Z3950::ZOOM distribution). ✨

πŸŽ€ AUTHOR πŸŽ€

Sebastian Hammer <quinn@indexdata.com>

Mike Taylor <mike@indexdata.com>

Legends, honestly. πŸ‘‘


Copyright (C) 2007 by Index Data.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.

Bestie, that means it's free software β€” go forth and remix, just keep the same terms. 🫢

And that's the whole page, periodt. πŸ¦‹ This was Net::Z...le2ZOOM(3pm) from the User Contributed Perl Documentation, running on perl v5.32.0, dated 2021-01-06. Slay, stay hydrated, and don't forget to launch_server responsibly β€” it never comes back. πŸ’–βœ¨

πŸ“¦ where this page comes from