//------------------------------------------------------------------------------
//! @file ario.hpp
//! @brief ARIO - Simple ar(1) archive reader/writer interface
//!
//! This file provides the ARIO namespace and the ario class for reading and manipulating UNIX ar archives.
//!
//! Copyright (C) 2025-present by Serge Lamikhov-Center
//!
//! Permission is hereby granted, free of charge, to any person obtaining a copy
//! of this software and associated documentation files (the "Software"), to deal
//! in the Software without restriction, including without limitation the rights
//! to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
//! copies of the Software, and to permit persons to whom the Software is
//! furnished to do so, subject to the following conditions:
//!
//! The above copyright notice and this permission notice shall be included in
//! all copies or substantial portions of the Software.
//!
//! THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
//! IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
//! FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
//! AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
//! LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
//! OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
//! THE SOFTWARE.

#ifndef ARIO_HPP
#define ARIO_HPP

#include <iostream>
#include <fstream>
#include <iomanip>
#include <string>
#include <string_view>
#include <sstream>
#include <vector>
#include <optional>
#include <unordered_map>
#include <algorithm>
#include <memory>
#include <cstdint>

//------------------------------------------------------------------------------
namespace ARIO {

//------------------------------------------------------------------------------
//! @class ario
//! @brief Class for reading and manipulating ar(1) archives
class ario
{
  public:
    //------------------------------------------------------------------------------
    //! @brief Error structure for ARIO operations
    class Result
    {
      public:
        Result() = default;
        Result( const std::string& msg ) : message( msg ) {}
        Result( std::string&& msg ) : message( std::move( msg ) ) {}

        bool        ok() const { return !message.has_value(); }
        std::string what() const { return message.value_or( "No errors" ); }

      private:
        std::optional<std::string> message; ///< Error message, if any
    };

    //------------------------------------------------------------------------------
    //! @struct Member
    //! @brief Represents a single member (file) in the archive
    class Member
    {
      public:
        std::string name = {}; ///< Name of the member
        int         date = {}; ///< Date of the member
        int         uid  = {}; ///< User ID of the member
        int         gid  = {}; ///< Group ID of the member
        int         mode = {}; ///< Mode of the member
        size_t      size = {}; ///< Size of the member in the archive

        //------------------------------------------------------------------------------
        //! @brief Get the data of the member as a string
        //! @return The data of the member
        std::string data() const
        {
            if ( new_data.has_value() ) {
                return new_data.value();
            }

            if ( !pstream ) {
                return { "No input stream available for member data" };
            }

            std::string    data( size, '\0' );
            std::streamoff current_pos = pstream->tellg();
            pstream->seekg( filepos + HEADER_SIZE, std::ios::beg );
            if ( pstream->fail() ) {
                return { "Failed to seek to member data position" };
            }
            pstream->read( &data[0], size );
            if ( pstream->fail() || (size_t)pstream->gcount() < size ) {
                return { "Failed to read member data" };
            }

            // Reset the stream position
            pstream->clear();
            pstream->seekg( current_pos, std::ios::beg );

            return data;
        }

        operator std::string() const { return name; }
        operator std::string_view() const { return name; }
        operator const char*() const { return name.c_str(); }
        bool operator==( std::string_view name ) const
        {
            return this->name == name;
        }

      protected:
        void set_input_stream( std::shared_ptr<std::istream>& pstream )
        {
            this->pstream = pstream;
        }

        void set_new_data( std::string_view data ) { this->new_data = data; }

      protected:
        std::string short_name = {}; ///< Short name of the member
        std::shared_ptr<std::istream> pstream =
            nullptr;                 ///< Pointer to the input stream
        std::streamoff filepos = {}; ///< File position in the archive
        std::optional<std::string> new_data = {};

        friend class ario;
    };

    //------------------------------------------------------------------------------
    //! @class Members
    //! @brief Provides access to the members of the archive
    class Members
    {
      public:
        //------------------------------------------------------------------------------
        //! @brief Constructor
        //! @param parent Pointer to the parent ario object
        explicit Members( ario* parent ) : parent( parent ) {}

        //------------------------------------------------------------------------------
        //! @brief Get the number of members
        //! @return The number of members
        size_t size() const { return parent->members_.size(); }

        //------------------------------------------------------------------------------
        //! @brief Get a member by index
        //! @param index The index of the member
        //! @return Reference to the member
        const Member& operator[]( size_t index ) const
        {
            if ( index >= parent->members_.size() ) {
                throw std::out_of_range( "Member index out of range" );
            }
            return parent->members_[index];
        }

        //------------------------------------------------------------------------------
        //! @brief Get a member by name
        //! @param name The name of the member
        //! @return Reference to the member, throws if not found
        const Member& operator[]( std::string_view name ) const
        {
            for ( const auto& m : parent->members_ ) {
                if ( m == name ) {
                    return m;
                }
            }
            throw std::out_of_range( std::string( "Member not found: " ) +
                                     std::string( name ) );
        }

        //------------------------------------------------------------------------------
        //! @brief Get an iterator to the beginning of the members
        //! @return Iterator to the beginning of the members
        std::vector<Member>::iterator begin()
        {
            return parent->members_.begin();
        }

        //------------------------------------------------------------------------------
        //! @brief Get an iterator to the end of the members
        //! @return Iterator to the end of the members
        std::vector<Member>::iterator end() { return parent->members_.end(); }

        //------------------------------------------------------------------------------
        //! @brief Get a const iterator to the beginning of the members
        //! @return Const iterator to the beginning of the members
        std::vector<Member>::const_iterator begin() const
        {
            return parent->members_.cbegin();
        }

        //------------------------------------------------------------------------------
        //! @brief Get a const iterator to the end of the members
        //! @return Const iterator to the end of the members
        std::vector<Member>::const_iterator end() const
        {
            return parent->members_.cend();
        }

        //------------------------------------------------------------------------------
        //! @brief Get a const reference to the first member
        //! @return Const reference to the first member
        const Member& front() const
        {
            if ( parent->members_.empty() ) {
                throw std::out_of_range( "No members in archive" );
            }
            return parent->members_.front();
        }

        //------------------------------------------------------------------------------
        //! @brief Get a const reference to the last member
        //! @return Const reference to the last member
        const Member& back() const
        {
            if ( parent->members_.empty() ) {
                throw std::out_of_range( "No members in archive" );
            }
            return parent->members_.back();
        }

      private:
        ario* parent; //!< Pointer to the parent ario object
    };

    //------------------------------------------------------------------------------
    //! @brief Constructor
    explicit ario() : members( this ) {};
    ario( const ario& )            = delete;
    ario& operator=( const ario& ) = delete;
    ario( ario&& )                 = delete;
    ario& operator=( ario&& )      = delete;
    ~ario()                        = default;

    //------------------------------------------------------------------------------
    //! @brief Load an archive from a file
    //! @param file_name The name of the archive file
    //! @return Error object indicating success or failure
    Result load( const std::string& file_name )
    {
        auto ifs = std::make_unique<std::ifstream>();
        if ( !ifs ) {
            return { "Failed to create input stream" };
        }

        ifs->open( file_name.c_str(), std::ios::in | std::ios::binary );
        if ( !*ifs ) {
            return { "Failed to open file: " + file_name };
        }

        auto result = load( std::move( ifs ) );

        return result;
    }

    //------------------------------------------------------------------------------
    //! @brief Load an archive from a stream
    //! @param stream The input stream to load from
    //! @return Error object indicating success or failure
    Result load( std::unique_ptr<std::istream> is )
    {
        if ( !is ) {
            return { "Input stream is null" };
        }

        pstream = std::move( is );
        if ( !*pstream ) {
            return { "Failed to set input stream" };
        }

        members_.clear();

        auto result = load_header();
        if ( !result.ok() ) {
            return result;
        }

        result = load_members();
        if ( !result.ok() ) {
            return result;
        }

        return {};
    }

    //------------------------------------------------------------------------------
    //! @brief Save an archive to a file
    //! @param file_name The name of the archive file
    //! @return Error object indicating success or failure
    Result save( const std::string& file_name )
    {
        std::ofstream ofs;

        ofs.open( file_name.c_str(), std::ios::out | std::ios::binary );
        if ( !ofs ) {
            return { "Failed to open file: " + file_name };
        }

        auto result = save( ofs );

        ofs.close();

        return result;
    }

    //------------------------------------------------------------------------------
    //! @brief Save an archive to a stream
    //! @param stream The output stream to save to
    //! @return Error object indicating success or failure
    Result save( std::ostream& os )
    {
        if ( !os ) {
            return { "Output stream is null" };
        }

        os.clear();
        os.seekp( 0, std::ios::beg );
        auto result = save_header( os );
        if ( !result.ok() ) {
            return result;
        }

        // Save symbol table if it exists
        if ( !symbol_table.empty() ) {
            result = save_symbol_table( os );
            if ( !result.ok() ) {
                return result;
            }
        }

        // Save long name directory if it exists
        if ( !string_table.empty() ) {
            result = save_long_name_directory( os );
            if ( !result.ok() ) {
                return result;
            }
        }

        result = save_members( os );
        if ( !result.ok() ) {
            return result;
        }

        return {};
    }

    //! @brief Find a symbol in the archive
    //! @param name The name of the symbol to find
    //! @param out_member Pointer to store the found member
    //! @param member Reference to store the found member
    //! @return Error object indicating success or failure
    //! If the symbol is found, out_member will point to the corresponding member
    //! If the symbol is not found, out_member will stay unchanged
    Result
    find_symbol( std::string_view name,
                 std::optional<std::reference_wrapper<const ario::Member>>&
                     member ) const
    {
        const auto it = symbol_table.find( std::string( name ) );
        if ( it != symbol_table.end() ) {
            member = members_[it->second];
            return {};
        }
        member = std::nullopt;
        return { std::string( "Symbol not found: " ) + std::string( name ) };
    }

    //------------------------------------------------------------------------------
    //! @brief Get symbols for a specific member
    //! @param m Pointer to the member
    //! @param symbols Vector to store the found symbols
    //! @return Error object indicating success or failure
    //! If the member is found, symbols will contain the associated symbols
    //! If the member is not found, symbols will be empty
    Result get_symbols_for_member( const ario::Member&       member,
                                   std::vector<std::string>& symbols ) const
    {
        std::string_view member_name = member.name;
        size_t           index       = std::distance(
            members.begin(),
            std::find_if(
                members.begin(), members.end(), [&]( const auto& mem ) {
                    return std::string_view( mem.name ) == member_name;
                } ) );
        if ( index >= members.size() ) {
            return { "Member not found in archive" };
        }

        symbols.clear();
        for ( const auto& symbol : symbol_table ) {
            if ( symbol.second == index ) {
                symbols.emplace_back( symbol.first );
            }
        }

        return {};
    }

    //------------------------------------------------------------------------------
    //! @brief Add a member to the archive
    //! @param member The member to add
    //! @param data The data associated with the member
    //! @return Error object indicating success or failure
    Result add_member( const Member& member, std::string_view data )
    {
        // Don't allow empty member names
        if ( member.name.empty() ) {
            return { "Member name cannot be empty" };
        }

        // Check if the member with such name already exists
        for ( const auto& mem : members_ ) {
            if ( mem.name == member.name ) {
                return { "Member '" + member.name + "' already exists" };
            }
        }

        auto& new_member   = members_.emplace_back( member );
        new_member.size    = data.size();
        new_member.pstream = nullptr;
        new_member.set_new_data( data );

        if ( member.name.size() < FIELD_NAME_SIZE ) {
            new_member.short_name = member.name + "/";
        }
        else {
            auto location = string_table.size();
            string_table += member.name + "/\x0A";
            new_member.short_name = "/" + std::to_string( location );
        }

        return {};
    }

    //------------------------------------------------------------------------------
    //! @brief Add symbols for a member
    //! @param member The member to add symbols for
    //! @param symbols The symbols to add
    //! @return Error object indicating success or failure
    Result add_symbols_for_member( const ario::Member&             member,
                                   const std::vector<std::string>& symbols )
    {
        std::string_view member_name = member.name;
        size_t           index       = std::distance(
            members.begin(),
            std::find_if(
                members.begin(), members.end(), [&]( const auto& mem ) {
                    return std::string_view( mem.name ) == member_name;
                } ) );
        if ( index >= members.size() ) {
            return { "Member not found in archive" };
        }

        for ( const auto& symbol : symbols ) {
            symbol_table[symbol] = index;
        }

        return {};
    }

  protected:
    //------------------------------------------------------------------------------
    //! @brief Load the archive header
    //! @param in Input file stream
    //! @return Error object indicating success or failure
    Result load_header()
    {
        auto        arch_magic      = std::string( ARCH_MAGIC );
        auto        arch_magic_size = arch_magic.size();
        std::string magic( arch_magic_size, ' ' );
        pstream->read( &magic[0], arch_magic_size );
        if ( magic != arch_magic ) {
            return { std::string( "Invalid archive format. Expected magic: " ) +
                     arch_magic + ", but got " + magic };
        }

        return {};
    }

    //------------------------------------------------------------------------------
    //! @brief Load all members from the archive
    //! @param in Input file stream
    //! @return Error object indicating success or failure
    Result load_members()
    {
        while ( true ) {
            Member m;
            m.set_input_stream( pstream );

            char header[HEADER_SIZE];
            auto filepos = pstream->tellg();

            pstream->read( header, HEADER_SIZE );
            if ( pstream->gcount() < HEADER_SIZE ) {
                if ( pstream->gcount() > 0 ) {
                    return { "Corrupted archive" }; // End of file or error
                }
                break; // End of file reached
            }
            std::streamoff current_pos = pstream->tellg();
            m.short_name               = std::string( header, FIELD_NAME_SIZE );
            m.name                     = m.short_name;
            m.filepos                  = filepos;

            std::string date_str( header + FIELD_NAME_SIZE, FIELD_DATE_SIZE );
            std::string uid_str( header + FIELD_NAME_SIZE + FIELD_DATE_SIZE,
                                 FIELD_UID_SIZE );
            std::string gid_str( header + +FIELD_NAME_SIZE + FIELD_DATE_SIZE +
                                     FIELD_UID_SIZE,
                                 FIELD_GID_SIZE );
            std::string mode_str( header + FIELD_NAME_SIZE + FIELD_DATE_SIZE +
                                      FIELD_UID_SIZE + FIELD_GID_SIZE,
                                  FIELD_MODE_SIZE );
            std::string size_str( header + FIELD_NAME_SIZE + FIELD_DATE_SIZE +
                                      FIELD_UID_SIZE + FIELD_GID_SIZE +
                                      FIELD_MODE_SIZE,
                                  FIELD_SIZE_SIZE );

            try {
                // Get m.size from the header. Do it earlier due to the potential use of m.data()
                // It is the only valid field in special members like symbol table and long name directory
                m.size = std::stoi( size_str );
            }
            catch ( const std::exception& ) {
                return { "Invalid member size" };
            }

            if ( m.short_name ==
                 "/               " ) { // Special case for the symbol table
                m.name      = "/";
                auto result = load_symbol_table();
                if ( !result.ok() ) {
                    return result;
                }
            }
            else if (
                m.short_name ==
                "//              " ) { // Special case for the long name directory
                m.name       = "//";
                string_table = m.data(); // Read the long name directory data
            }
            else {
                try {
                    m.date = std::stoi( date_str );
                    m.uid  = std::stoi( uid_str );
                    m.gid  = std::stoi( gid_str );
                    m.mode = std::stoi( mode_str, nullptr, FIELD_MODE_SIZE );
                }
                catch ( const std::exception& ) {
                    return { "Invalid member header's field: " + m.short_name +
                             ", " + date_str + ", " + uid_str + ", " + gid_str +
                             ", " + mode_str };
                }

                if ( m.short_name[0] == '/' ) {
                    auto name_result = convert_name( m.short_name );
                    if ( !name_result.has_value() ) {
                        return { "Failed to convert long name for member " +
                                 m.short_name };
                    }
                    m.name = *name_result;
                }
                else {
                    m.name = m.short_name.substr( 0, m.short_name.find( '/' ) );
                }

                // Add only the regular member to the list
                members_.emplace_back( m );
            }

            // Skip the content of the member
            pstream->clear();
            pstream->seekg( current_pos + m.size + m.size % 2, std::ios::beg );
        }

        pstream->clear();

        // Substitute symbol locations with member indexes
        for ( auto& symbol : symbol_table ) {
            auto       index = 0;
            const auto it    = std::find_if(
                members_.begin(), members_.end(),
                [&]( const Member& m ) { return m.filepos == symbol.second; } );
            if ( it != members_.end() ) {
                index = (std::uint32_t)std::distance( members_.begin(), it );
            }
            symbol.second = index;
        }

        return {};
    }

    //------------------------------------------------------------------------------
    //! @brief Save the archive header
    //! @param os Output stream to save the header
    //! @return Error object indicating success or failure
    Result save_header( std::ostream& os )
    {
        if ( !os ) {
            return { "Output stream is null" };
        }

        // Write the archive magic string
        os << ARCH_MAGIC;

        return {};
    }

    //------------------------------------------------------------------------------
    //! @brief Calculate the size of the symbol table
    //! @return The size of the symbol table in bytes
    //! The size includes the header, number of symbols, symbol locations, and names
    //! It also includes padding if the size is odd
    //! @note The symbol table is saved after the archive header and before the long name directory
    std::streamoff calculate_symbol_table_size() const
    {
        auto num_of_symbols = static_cast<std::uint32_t>( symbol_table.size() );

        // Calculate the symbol table size
        auto symbol_table_size =
            HEADER_SIZE +
            sizeof( num_of_symbols ) + // Size of the number of symbols
            num_of_symbols *
                ( sizeof( std::uint32_t ) ); // Size of each symbol location
        for ( const auto& symbol : symbol_table ) {
            // Size of each symbol name + null terminator
            symbol_table_size += symbol.first.size() + 1;
        }

        // Add padding byte if the size is odd
        symbol_table_size += symbol_table_size % 2;

        return symbol_table_size;
    }

    //------------------------------------------------------------------------------
    //! @brief Calculate the relative offsets of members in the archive
    //! @return A vector of relative offsets for each member
    //! The offsets are calculated from the start of the archive
    std::vector<std::uint32_t> calculate_member_relative_offsets()
    {
        std::vector<std::uint32_t> member_relative_offset;
        size_t                     position = 0;

        member_relative_offset.reserve( members_.size() );
        for ( const auto& member : members_ ) {
            // Store the relative offset of the member in the archive
            member_relative_offset.push_back(
                static_cast<std::uint32_t>( position ) );
            position += HEADER_SIZE + member.size +
                        member.size % 2; // Add padding if needed
        }
        return member_relative_offset;
    }

    //------------------------------------------------------------------------------
    //! @brief Calculate the size of the long names directory
    //! @return The size of the long names directory in bytes
    //! The size includes the header and the string table
    //! It also includes padding if the size is odd
    //! @note The long names directory is saved after the symbol table and before the members
    std::streamoff calculate_long_names_dir_size()
    {
        return HEADER_SIZE + string_table.size() + string_table.size() % 2;
    }

    //------------------------------------------------------------------------------
    //! @brief Save the symbol table to the archive
    //! @param os Output stream to save the symbol table
    //! @return Error object indicating success or failure
    Result save_symbol_table( std::ostream& os )
    {
        if ( !os ) {
            return { "Output stream is null" };
        }

        auto num_of_symbols = static_cast<std::uint32_t>( symbol_table.size() );
        if ( num_of_symbols == 0 ) {
            return {};
        }

        auto symbol_table_size      = calculate_symbol_table_size();
        auto long_names_dir_size    = calculate_long_names_dir_size();
        auto member_relative_offset = calculate_member_relative_offsets();

        // Write the symbol table header
        os << "/               0           0     0     0       "
           << std::setw( FIELD_SIZE_SIZE ) << std::left << std::dec
           << symbol_table_size - HEADER_SIZE << HEADER_END_MAGIC;

        // Write the number of symbols
        char buf[4];
        buf[0] = static_cast<char>( ( num_of_symbols >> 24 ) & 0xFF );
        buf[1] = static_cast<char>( ( num_of_symbols >> 16 ) & 0xFF );
        buf[2] = static_cast<char>( ( num_of_symbols >> 8 ) & 0xFF );
        buf[3] = static_cast<char>( ( num_of_symbols >> 0 ) & 0xFF );
        // Write the number of symbols as a 4-byte big-endian integer
        os.write( buf, sizeof( buf ) );

        // Write symbol locations (location of the member in the archive)
        auto members_start_from =
            std::string( ARCH_MAGIC ).size() +
            static_cast<std::uint32_t>( symbol_table_size ) +
            static_cast<std::uint32_t>( long_names_dir_size );
        for ( const auto& symbol : symbol_table ) {
            auto index    = static_cast<std::uint32_t>( symbol.second );
            auto location = members_start_from + member_relative_offset[index];
            buf[0]        = static_cast<char>( ( location >> 24 ) & 0xFF );
            buf[1]        = static_cast<char>( ( location >> 16 ) & 0xFF );
            buf[2]        = static_cast<char>( ( location >> 8 ) & 0xFF );
            buf[3]        = static_cast<char>( ( location >> 0 ) & 0xFF );
            os.write( buf, sizeof( buf ) );
        }
        if ( os.fail() ) {
            return { "Failed to write symbol table" };
        }

        // Write symbol names
        for ( const auto& symbol : symbol_table ) {
            os << symbol.first << '\0'; // Null-terminated string
        }
        if ( os.tellp() % 2 != 0 ) {
            os << '\x0A';
        }

        if ( os.fail() ) {
            return { "Failed to write symbol table" };
        }

        return {};
    }

    //------------------------------------------------------------------------------
    //! @brief Save the long name directory to the archive
    //! @param os Output stream to save the long name directory
    //! @return Error object indicating success or failure
    Result save_long_name_directory( std::ostream& os )
    {
        if ( !os ) {
            return { "Output stream is null" };
        }

        // clang-format off
        // Write the long name directory
        os << "//                                              "
           << std::setw( FIELD_SIZE_SIZE ) << std::left << std::dec << string_table.size()
           << HEADER_END_MAGIC
           << string_table;
        // clang-format on

        if ( string_table.size() % 2 != 0 ) {
            // Write a padding byte if the size is odd
            os.put( '\x0A' );
        }

        if ( os.fail() ) {
            return { "Failed to write member data" };
        }

        return {};
    }

    //------------------------------------------------------------------------------
    //! @brief Save the member information to the archive
    //! @param os Output stream to save the member information
    //! @return Error object indicating success or failure
    Result save_members( std::ostream& os )
    {
        if ( !os ) {
            return { "Output stream is null" };
        }

        for ( const auto& member : members_ ) {
            // clang-format off
            // Write the member header
            os << std::setw( FIELD_NAME_SIZE )  << std::left << member.short_name
                << std::setw( FIELD_DATE_SIZE ) << std::left << member.date
                << std::setw( FIELD_UID_SIZE )  << std::left << member.uid
                << std::setw( FIELD_GID_SIZE )  << std::left << member.gid
                << std::setw( FIELD_MODE_SIZE ) << std::left << std::oct << member.mode
                << std::setw( FIELD_SIZE_SIZE ) << std::left << std::dec << member.size
                << HEADER_END_MAGIC;
            // clang-format on

            // Write the content of the member
            os.write( member.data().data(), member.size );
            if ( os.fail() ) {
                return { "Failed to write member data" };
            }
            if ( member.size % 2 != 0 ) {
                // Write a padding byte if the size is odd
                os.put( '\x0A' );
                if ( os.fail() ) {
                    return { "Failed to write padding byte" };
                }
            }
        }

        return {};
    }

    //------------------------------------------------------------------------------
    //! @brief Read the symbol table from the archive symbol table member
    //! @return Error object indicating success or failure
    Result load_symbol_table()
    {
        char buf[4];
        pstream->read( buf, sizeof( buf ) );
        if ( pstream->gcount() < sizeof( buf ) ) {
            return { "Failed to read symbol table" };
        }

        std::uint32_t num_of_symbols =
            ( static_cast<std::uint8_t>( buf[0] ) << 24 ) |
            ( static_cast<std::uint8_t>( buf[1] ) << 16 ) |
            ( static_cast<std::uint8_t>( buf[2] ) << 8 ) |
            ( static_cast<std::uint8_t>( buf[3] ) << 0 );

        std::vector<std::pair<std::uint32_t, std::string>> v( num_of_symbols );

        // Read symbol locations
        for ( std::uint32_t i = 0; i < num_of_symbols; ++i ) {
            pstream->read( buf, sizeof( buf ) );
            if ( pstream->gcount() < sizeof( buf ) ) {
                return { "Failed to read symbol table" };
            }
            std::uint32_t member_location =
                ( static_cast<std::uint8_t>( buf[0] ) << 24 ) |
                ( static_cast<std::uint8_t>( buf[1] ) << 16 ) |
                ( static_cast<std::uint8_t>( buf[2] ) << 8 ) |
                ( static_cast<std::uint8_t>( buf[3] ) << 0 );
            v[i].first = member_location;
        }

        // Read symbol names
        for ( std::uint32_t i = 0; i < num_of_symbols; ++i ) {
            std::string sym_name;
            std::getline( *pstream, sym_name, '\0' );
            v[i].second = sym_name;
        }

        // Copy to symbol_table map
        for ( const auto& pair : v ) {
            symbol_table[pair.second] = pair.first;
        }

        return {};
    }

    //------------------------------------------------------------------------------
    //! @brief Convert a short name to a long name using the long name directory
    //! @param short_name The short name to convert
    //! @return The long name
    std::optional<std::string> convert_name( std::string_view short_name )
    {
        auto pos = short_name.find( '/' );
        if ( pos == 0 ) {
            if ( short_name.size() < 3 ) {
                return std::nullopt;
            }
            size_t offset_in_dir = 0;
            try {
                offset_in_dir = std::stoul( std::string(
                    short_name.substr( 1, short_name.size() - 2 ) ) );
            }
            catch ( const std::exception& ) {
                return std::nullopt;
            }
            if ( offset_in_dir >= string_table.size() ) {
                return std::nullopt;
            }
            auto end = string_table.find( '/', offset_in_dir );
            if ( end == std::string::npos || end <= offset_in_dir ) {
                return std::nullopt;
            }
            std::string long_name =
                string_table.substr( offset_in_dir, end - offset_in_dir );
            return long_name;
        }
        else if ( pos != std::string::npos && pos != 0 &&
                  pos < short_name.size() ) {
            return std::string( short_name.substr( 0, pos ) );
        }

        return std::string( short_name );
    }

  public:
    Members members; //!< Members object

  protected:
    static constexpr const char* ARCH_MAGIC =
        "!<arch>\x0A"; ///< Archive magic string
    static constexpr const char* HEADER_END_MAGIC =
        "\x60\x0A"; ///< End of header magic
    static constexpr std::streamsize HEADER_SIZE =
        60; ///< Size of archive header
    static constexpr unsigned int FIELD_NAME_SIZE = 16;
    static constexpr unsigned int FIELD_DATE_SIZE = 12;
    static constexpr unsigned int FIELD_UID_SIZE  = 6;
    static constexpr unsigned int FIELD_GID_SIZE  = 6;
    static constexpr unsigned int FIELD_MODE_SIZE = 8;
    static constexpr unsigned int FIELD_SIZE_SIZE = 10;

    //!< Pointer to the input stream
    //! It is used to read the archive members
    //! data even after the archive is loaded
    std::shared_ptr<std::istream> pstream = nullptr;
    std::vector<Member>           members_; //!< Vector of archive members
    //!< Symbol table
    //!< This is a map from symbol names to member indexes
    //!< The member index is the index in the members_ vector
    //!< This allows for quick lookup of symbols by name
    std::unordered_map<std::string, size_t> symbol_table;
    std::string string_table; //!< Long names for members
};

} // namespace ARIO

#endif // ARIO_HPP