Bio::T...::soap(3pm)

πŸ“¦
version 1.7.3 Β· 3 versions
, in debian bookworm, ubuntu noble

πŸ’– NAME πŸ’–

Bio::Tools::Run::AnalysisFactory::soap β€” a SOAP-based access to the list of analysis tools ✨

okay bestie, real talk: this whole page is about Bio::T...::soap(3pm) from the User Contributed Perl Documentation crew, and it's lowkey iconic for one very specific job. let's get into it πŸ’…


🌸 SYNOPSIS 🌸

bestie. do not use this object directly, fr fr. the move is to access it and use it through the Bio::Tools::Run::AnalysisFactory module:

use Bio::Tools::Run::AnalysisFactory;
my $list = Bio::Tools::Run::AnalysisFactory->new(-access => 'soap')
   ->available_analyses;
print join ("\n", @$list) . "\n";

that's it. that's the whole vibe. she does one thing and she ate πŸ”₯


πŸ¦‹ DESCRIPTION πŸ¦‹

all the public methods are documented over in the interface module Bio::Factory::AnalysisI. that's where the lore lives, go read that one πŸ’œ


🫢 FEEDBACK 🫢

πŸ’Œ Mailing Lists

user feedback is an integral part of the evolution of this and other Bioperl modules β€” like, genuinely, your comments and suggestions matter so much. send them preferably to the Bioperl mailing list. your participation is much appreciated, no cap πŸ₯Ή

bioperl-l@bioperl.org                  - General discussion
http://bioperl.org/wiki/Mailing_lists  - About the mailing lists

πŸŽ€ Support

please direct usage questions and support issues to the mailing list:

bioperl-l@bioperl.org

rather than to the module maintainer directly. why? because there are so many experienced and responsive experts on there who can look at your problem and quickly address it β€” group chat energy, but make it bioinformatics πŸ’… please include a thorough description of the problem with code and data examples if at all possible, like give us the whole story bestie.

πŸ› Reporting Bugs

report bugs to the Bioperl bug tracking system so we can keep track of the bugs and their resolution β€” tracking is the whole point, periodt. bug reports can be submitted via the web:

http://redmine.open-bio.org/projects/bioperl/

πŸ‘‘ AUTHOR πŸ‘‘

Martin Senger (martin.senger@gmail.com) β€” we stan ✨


Copyright (c) 2003, Martin Senger and EMBL-EBI. All Rights Reserved.

this module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. so generous, so iconic πŸŽ€


πŸ’€ DISCLAIMER πŸ’€

this software is provided "as is" without warranty of any kind. yeah. that kind of disclaimer. it's giving "we said what we said" πŸ™ˆ


🌈 SEE ALSO 🌈


πŸ”₯ BUGS AND LIMITATIONS πŸ”₯

none known at the time of writing this. a flawless queen, allegedly πŸ‘‘


🧚 APPENDIX 🧚

the main documentation details are in Bio::Factory::AnalysisI.

⭐ _initialize

Usage   : my $factory = Bio::Tools::Run::AnalysisFactory->new(@args);
          (_initialize is internally called from the 'new()' method)
Returns : nothing interesting
Args    : This module recognises and uses following arguments:
            -location
            -httpproxy
            -soap
          Additionally, the main module Bio::Tools::Run::AnalysisFactory
          recognises also:
            -access

okay so what does she actually do? it populates the calling object with the given arguments, and then β€” for some attributes, and only if they are not yet populated β€” it assigns some default values. little fill-in-the-blanks moment, we love her for it πŸ’–

this is an actual new() method (except for the real object creation and its blessing, which is done in the parent class Bio::Root::Root in method _create_object). the blessing happens elsewhere, she just handles the setup ✨

note bestie: this method is called always as an object method (never as a class method) β€” and the object who calls this method may already be partly initiated (from the Bio::Tools::Run::AnalysisFactory::new method). so if you need to do some tricks with the 'class invocation', you need to change the Bio::Tools::Run::AnalysisFactory new method, not this one. important. write that down 🫢

πŸ“ -location

a URL (also called an endpoint) defining where a Web Service functioning for this object is located.

default is http://www.ebi.ac.uk/soaplab/services (a service running at European Bioinformatics Institute on top of most of the EMBOSS analyses, and on top of few others). that default is doing a lot of heavy lifting ngl πŸ’…

for example, if you run your own Web Service using Java(TM) Apache Axis toolkit, the location might be something like http://localhost:8080/axis/services.

🌸 -httpproxy

in addition to the location parameter, you may need to specify also a location/URL of an HTTP proxy server (if your site requires one). the expected format is http://server:port. there is no default value β€” you're on your own for this one, bestie 😭

πŸ¦‹ -soap

defines your own SOAP::Lite object. useful if you need finer-grained access to many features and attributes of the wonderful Paul Kulchenko's module. go off, Paul πŸ‘‘

πŸ’« VERSION and Revision

Usage   : print $Bio::Tools::Run::AnalysisFactory::soap::VERSION;
          print $Bio::Tools::Run::AnalysisFactory::soap::Revision;

and that's the whole page bestie πŸ’– this one shipped as part of perl v5.36.0, dated 2023-01-22 β€” genuinely vintage in internet years, and she still slays. mwah πŸŽ€βœ¨πŸ«Ά

πŸ“¦ where this page comes from