format_man.hpp

Go to the documentation of this file.

// -----------------------------------------------------------------------------------------------------
// Copyright (c) 2006-2021, Knut Reinert & Freie Universität Berlin
// Copyright (c) 2016-2021, Knut Reinert & MPI für molekulare Genetik
// This file may be used, modified and/or redistributed under the terms of the 3-clause BSD-License
// shipped with this file and also available at: https://github.com/seqan/seqan3/blob/master/LICENSE.md
// -----------------------------------------------------------------------------------------------------
 
#pragma once
 
#include <iostream>
 
#include <seqan3/argument_parser/detail/format_base.hpp>
#include <seqan3/argument_parser/detail/terminal.hpp>
#include <seqan3/version.hpp>
 
namespace seqan3::detail
{
 
class format_man : public format_help_base<format_man>
{
    using base_type = format_help_base<format_man>;
 
    friend base_type;
 
public:
    format_man() = default;                                  
    format_man(format_man const & pf) = default;             
    format_man & operator=(format_man const & pf) = default; 
    format_man(format_man &&) = default;                     
    format_man & operator=(format_man &&) = default;         
    ~format_man() = default;                                 
 
    format_man(std::vector<std::string> const & names, bool const advanced = false) : base_type{names, advanced}
    {};
 
private:
    void print_header()
    {
        std::ostream_iterator<char> out(std::cout);
 
        // Print .TH line.
        std::cout << ".TH ";
        std::transform(meta.app_name.begin(), meta.app_name.end(), out, [] (unsigned char c) { return std::toupper(c); });
        std::cout << " " << std::to_string(meta.man_page_section) << " \"" << meta.date << "\" \"";
        std::transform(meta.app_name.begin(), meta.app_name.end(), out, [] (unsigned char c) { return std::tolower(c); });
        std::cout << " " << meta.version << "\" \"" << meta.man_page_title << "\"\n";
 
        // Print NAME section.
        std::cout << ".SH NAME\n"
                  << meta.app_name << " \\- " << meta.short_description << std::endl;
    }
 
    void print_section(std::string const & title)
    {
        std::ostream_iterator<char> out(std::cout);
        std::cout << ".SH ";
        std::transform(title.begin(), title.end(), out, [] (unsigned char c) { return std::toupper(c); });
        std::cout << "\n";
        is_first_in_section = true;
    }
 
    void print_subsection(std::string const & title)
    {
            std::cout << ".SS " << title << "\n";
            is_first_in_section = true;
    }
 
    void print_line(std::string const & text, bool const line_is_paragraph)
    {
        if (!is_first_in_section && line_is_paragraph)
            std::cout << ".sp\n";
        else if (!is_first_in_section && !line_is_paragraph)
            std::cout << ".br\n";
 
        std::cout << text << "\n";
        is_first_in_section = false;
    }
 
    void print_list_item(std::string const & term, std::string const & desc)
    {
            std::cout << ".TP\n"
                   << term << "\n"
                   << desc << "\n";
            is_first_in_section = false;
    }
 
    void print_footer()
    {
        // no footer
    }
 
    std::string in_bold(std::string const & str)
    {
        return "\\fB" + str + "\\fR";
    }
 
    bool is_first_in_section{true};
};
 
} // namespace seqan3