The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Bio::Das::ProServer::SourceAdaptor::Transport::file

VERSION

$Revision: 567 $

SYNOPSIS

DESCRIPTION

A simple data transport for tab-separated files. Access is via the 'query' method. Expects a tab-separated file with no header line.

Can optionally cache the file contents upon first usage. This may improve subsequence response speed at the expense of memory footprint.

SUBROUTINES/METHODS

query - Execute a basic query against a text file

 Queries are of the form:

 $filetransport->query(qq(field1 = 'value'));
 $filetransport->query(qq(field1 lceq 'value'));
 $filetransport->query(qq(field3 like '%value%'));
 $filetransport->query(qq(field0 = 'value' && field1 = 'value'));
 $filetransport->query(qq(field0 = 'value' and field1 = 'value'));
 $filetransport->query(qq(field0 = 'value' and field1 = 'value' and field2 = 'value'));

 "OR" compound queries not (yet) supported

last_modified - machine time of last data change

  $dbitransport->last_modified();

DESTROY - object destructor - disconnect filehandle

  Generally not directly invoked, but if you really want to - 

  $filetransport->DESTROY();

DIAGNOSTICS

Run ProServer with the -debug flag.

CONFIGURATION AND ENVIRONMENT

Configured as part of each source's ProServer 2 INI file:

  [myfile]
  ... source configuration ...
  transport = file
  filename  = /data/features.tsv
  unique    = 1 # optional
  cache     = 1 # optional

DEPENDENCIES

File::stat
Bio::Das::ProServer::SourceAdaptor::Transport::generic

INCOMPATIBILITIES

BUGS AND LIMITATIONS

Only AND compound queries are supported.

AUTHOR

Roger Pettett <rmp@sanger.ac.uk> and Andy Jenkinson <aj@ebi.ac.uk>

LICENSE AND COPYRIGHT

Copyright (c) 2008 The Sanger Institute and EMBL-EBI

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See DISCLAIMER.txt for disclaimers of warranty.