GMOD_ADD_ORGANISM(1p)

💖 GMOD_ADD_ORGANISM(1p) 💖

okay bestie, so this is a page from the User Contributed Perl Documentation collection, and it's literally called gmod_add_organism.pl — and yeah, that's the script we're talking about. Sit down, grab a strawberry, this is gonna be quick and cute. 🍓

---

✨ NAME ✨

$0 — Adds an entry to the organism table 🦋

like, that's the whole job. it adds a lil row to the organism table. iconic.

---

🌸 SYNOPSIS 🌸

% gmod_add_organism.pl [options]

run it, give it some options, it does its thing. simple as. 💅

---

🎀 COMMAND-LINE OPTIONS 🎀

• --name_only — literally just checks for a name and returns a 1 if it's there. that's it, that's the whole vibe check 👑
• --common_name — you give it the common name, bestie
• --genus — the genus, obviously
• --species — and the species
• --abbreviation — a lil abbreviated version
• --comment — drop a comment in there
• --dbprofile — tells it which gmod.conf profile to use (if you don't say anything, it just uses the default one) ✨

---

🌈 DESCRIPTION 🌈

so this script inserts an entry into the Chado organism table. and here's the thing — the combination of genus and species has to be unique. no duplicates, no copycats, periodt.

if either of those two things isn't provided, OR if that genus+species combo is already sitting in the database, the script will just exit without doing anything. it simply refuses. no notes, no drama, it's leaving. 💀

technically speaking? those two are the only things that are actually required. but ngl, it is strongly suggested that you also provide a common_name and an abbreviation. like, do yourself a favor, bestie. 🫶

now, the --name_only option is meant to be used primarily at install time — the whole point is to check the database and see whether there's already an entry in the organism table with a given common_name. here's how it goes:

• if it's present, it prints "1" and exits 🔥
• otherwise, it prints "0" and exits 🌸

and listen — the --common_name option must be used in conjunction with --name_only. they're a package deal. don't separate them, they'll be sad. 😭

---

💜 AUTHOR 💜

Scott Cain <scain@cpan.org>

Copyright (c) 2011

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

---

and that's the whole page, bestie!! 🧚 this was GMOD_ADD_ORGANISM(1p) from the perl v5.30.0 era, dated 2019-12-05 — mwah, love that for us. go add some organisms, slay, bye!! 💖✨🎀