SeqAn3  3.0.3
The Modern C++ library for sequence analysis.
seqan3::output_directory_validator Class Reference

A validator that checks if a given path is a valid output directory. More...

#include <seqan3/argument_parser/validators.hpp>

+ Inheritance diagram for seqan3::output_directory_validator:

Public Types

using option_value_type = std::string
 Type of values that are tested by validator.
- Public Types inherited from seqan3::file_validator_base
using option_value_type = std::string
 Type of values that are tested by validator.

Public Member Functions

std::string get_help_page_message () const
 Returns a message that can be appended to the (positional) options help page info.
virtual void operator() (std::filesystem::path const &dir) const override
 Tests whether path is writable. More...
Constructors, destructor and assignment
 output_directory_validator ()=default
 output_directory_validator (output_directory_validator const &)=default
 output_directory_validator (output_directory_validator &&)=default
output_directory_validatoroperator= (output_directory_validator const &)=default
output_directory_validatoroperator= (output_directory_validator &&)=default
virtual ~output_directory_validator ()=default
 Virtual Destructor.
 file_validator_base ()=default
 file_validator_base (file_validator_base const &)=default
 file_validator_base (file_validator_base &&)=default
- Public Member Functions inherited from seqan3::file_validator_base
template<std::ranges::forward_range range_type>
void operator() (range_type const &v) const
 Tests whether every path in list v passes validation. See operator()(option_value_type const & value) for further information. More...
 file_validator_base ()=default
 file_validator_base (file_validator_base const &)=default
 file_validator_base (file_validator_base &&)=default
file_validator_baseoperator= (file_validator_base const &)=default
file_validator_baseoperator= (file_validator_base &&)=default
virtual ~file_validator_base ()=default

Additional Inherited Members

- Protected Member Functions inherited from seqan3::file_validator_base
bool case_insensitive_string_ends_with (std::string_view str, std::string_view suffix) const
 Helper function that checks if a string is a suffix of another string. Case insensitive. More...
std::string valid_extensions_help_page_message () const
 Returns the information of valid file extensions.
void validate_filename (std::filesystem::path const &path) const
 Validates the given filename path based on the specified extensions. More...
void validate_readability (std::filesystem::path const &path) const
 Checks if the given path is readable. More...
void validate_writeability (std::filesystem::path const &path) const
 Checks if the given path is writable. More...
- Protected Attributes inherited from seqan3::file_validator_base
std::vector< std::stringextensions {}
 Stores the extensions.

Detailed Description

A validator that checks if a given path is a valid output directory.

The class acts as a functor that throws a seqan3::validation_error exception whenever a given path (std::filesystem::path) is not writable. This can happen if either the parent path does not exists, or the path doesn't have the proper write permissions.

int main(int argc, const char ** argv)
seqan3::argument_parser myparser{"Test", argc, argv}; // initialize
myparser.add_option(mydir, 'd', "dir", "The output directory for storing the files.",
// an exception will be thrown if the user specifies a directory that cannot be created by the filesystem either
// because the parent path does not exists or the path has insufficient write permissions.
catch (seqan3::argument_parser_error const & ext) // the user did something wrong
std::cerr << "[PARSER ERROR] " << ext.what() << "\n"; // customize your error message
return -1;
seqan3::debug_stream << "directory given by user passed validation: " << mydir << "\n";
return 0;
Meta-Header for the argument parser module.
Argument parser exception that is thrown whenever there is an error while parsing the command line ar...
Definition: exceptions.hpp:49
The SeqAn command line parser.
Definition: argument_parser.hpp:154
A validator that checks if a given path is a valid output directory.
Definition: validators.hpp:827
Provides seqan3::debug_stream and related types.
This header includes C++17 filesystem support and imports it into namespace std::filesystem (independ...
@ standard
The default were no checking or special displaying is happening.
Definition: auxiliary.hpp:239
debug_stream_type debug_stream
A global instance of seqan3::debug_stream_type.
Definition: debug_stream.hpp:42
T what(T... args)
The validator works on every type that can be implicitly converted to std::filesystem::path.

Member Function Documentation

◆ operator()()

virtual void seqan3::output_directory_validator::operator() ( std::filesystem::path const &  dir) const

Tests whether path is writable.

dirThe input value to check.
seqan3::validation_errorif the validation process failed. Might be nested with std::filesystem::filesystem_error on unhandled OS API errors.

Implements seqan3::file_validator_base.

The documentation for this class was generated from the following file: