native::Base(3perl)

💖 native::Base — the perl manual page, but make it make sense

okay bestie, you found yourself in the native::Base page from the User Contributed Perl Documentation section, and honestly? you're about to eat. let's get into it 🫶

---

✨ NAME ✨

SVN::Base — the base class that imports symbols for the svn modules, no cap

---

🎀 SYNOPSIS 🎀

    # Load the svn_ra_* functions into the SVN::Ra namespace.
    package SVN::Ra;
    use SVN::Base qw(Ra svn_ra_);

    # Load svn_config_t structure accessors in the magic namcespace
    # provided by swig, so we could use it returned by other functions
    package _p_svn_config_t;
    use SVN::Base qw(Core svn_config_);

see how chill that looks? that's the whole vibe. 💅

---

🌸 DESCRIPTION 🌸

so like, SVN::Base is the module that takes the subversion perl bindings' raw symbols (the ones swig cooked up) and drops them into the proper namespace so they're actually, y'know, usable. it's giving personal assistant energy honestly.

it's also out here hunting down the accessors for members of a C struct, and it'll build you a simpler accessor function — something like $data->field() and $data->field($new_value). cute, right? 🎀

and once you've internalised the convention that subversion functions follow in the perl bindings, you can literally just read the subversion api and write it in perl yourself. the API lives in the source header files, or online at <https://subversion.apache.org/docs/api/latest/> if you'd rather scroll. ✨

---

🦋 INTERNALS 🦋

the perl bindings from swig wrap raw functions into different perl modules — for example, SVN::_Core, SVN::_Repos. iykyk. 👑

so upon import, SVN::Base bootstraps the module you asked for if it hasn't been loaded yet, then iterates over the symbols that module provides, and puts each function — with its prefix trimmed off — into the namespace of whoever called the import. it's like a lil sorting hat but for functions. 🧚

now listen, the 3rd through the last parameter is a list of symbol endings that you want SVN::Base not to import into your namespace. super useful when you want to import certain symbols a different way than the usual deal. so specific. we love options. 💖

---

💀 CAVEATS 💀

SVN::Base treats a function as a structure member accessor if it's postfixed _get or _set. so real, genuine functions that happen to have those postfixes? yeah, they're gonna need extra handling. not me getting flagged by the vibe check 😭

---

👑 AUTHORS 👑

Chia-liang Kao <clkao@clkao.org> — the icon who did that ⭐

---

🌈 COPYRIGHT 🌈

    Licensed to the Apache Software Foundation (ASF) under one
    or more contributor license agreements.  See the NOTICE file
    distributed with this work for additional information
    regarding copyright ownership.  The ASF licenses this file
    to you under the Apache License, Version 2.0 (the
    "License"); you may not use this file except in compliance
    with the License.  You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing,
    software distributed under the License is distributed on an
    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
    KIND, either express or implied.  See the License for the
    specific language governing permissions and limitations
    under the License.

---

and that's the whole page, bestie. this one's brought to you by perl v5.40.1, dated 2025-04-06 — go forth and import responsibly 💜🌸✨