Index of Rust items

 
Crates
crate sphinx_rustdocgen Library for the sphinx-rustdocgen executable.
 
Enums
enum Directive (in sphinx_rustdocgen::directives) The Sphinx directives that are implemented by the Rust domain.
    Crate
    Enum
    Executable
    Function
    Impl
    Macro
    Module
    Struct
    Trait
    Type
    Use
    Variable
enum DirectiveOption (in sphinx_rustdocgen::directives::directive_options) Enum to represent the various options for the directives.
    Index The ``:index:`` option
    Layout The ``:layout:`` option.
    Toc The ``:toc:`` option.
    Vis The ``:vis:`` option.
enum DirectiveVisibility (in sphinx_rustdocgen::directives::directive_options) Enum for the values of the :rust:struct:`DirectiveOption::Vis` option
    Crate Crate visibility
    Pub Public visibility
    Pvt Private visibility
enum IndexEntryType (in sphinx_rustdocgen::directives::directive_options) The different index entry types.
    None
    Normal
    SubEntry
    WithSubEntries
enum UseDirectiveOption (in sphinx_rustdocgen::directives::use_directive) Options for the use directive.
    Reexport
    UsedName
enum Format (in sphinx_rustdocgen::formats) Supported formats for the docstrings
    Md Markdown format
    Rst reStructuredText format
enum Node (in sphinx_rustdocgen::nodes) Enum representing various docutils nodes for item signatures
    Indent A node for adding an indentation before the line.
    Keyword A node for a keyword in the signature.
    Lifetime A node for a lifetime name. This is not a docutils node, but kept
    Link A node for link to another item in the signature.
    Literal A literal string to include in the signature.
    Name The node for a name in the signature.
    Newline A node for a newline in the signature.
    Operator A node for an operator in the signature.
    Punctuation A node for a punctuation in the signature.
    Returns A node for the returns symbol.
    Space A node for a single space in the signature.
 
Executables
sphinx-rustdocgen sphinx-rustdocgen is an executable to extract doc comments from Rust
 
Functions
fn main (in sphinx-rustdocgen)
fn extract_doc_from_attrs (in sphinx_rustdocgen::directives) Extract the docstring from the attrs of an item.
fn nodes_for_fn_signature (in sphinx_rustdocgen::directives::function_directive) Generate docutils node layout for the function from its signature
fn nodes_for_impl (in sphinx_rustdocgen::directives::impl_directive) Generate docutils nodes for the impl block's signature.
fn find_file_under_dir (in sphinx_rustdocgen::directives::module_directive) Find the file for the module under the provided directory.
fn has_test_token (in sphinx_rustdocgen::directives::module_directive) Check if the module is a test module or not.
fn order_items (in sphinx_rustdocgen::directives) Order the items for documentation
fn generate_decoration (in sphinx_rustdocgen::formats) Generate title decoration string for RST or fence for MD.
fn nodes_for_abi_opt (in sphinx_rustdocgen::nodes) Create nodes for an optional ABI specification.
fn nodes_for_angle_bracket_generic_args (in sphinx_rustdocgen::nodes) Create nodes for angle bracket generic arguments in paths.
fn nodes_for_bare_fn (in sphinx_rustdocgen::nodes) Create nodes for a bare fn type.
fn nodes_for_bound_lifetimes (in sphinx_rustdocgen::nodes) Create nodes for bound lifetimes.
fn nodes_for_expr_lit (in sphinx_rustdocgen::nodes) Create nodes for a literal expression.
fn nodes_for_generic_argument (in sphinx_rustdocgen::nodes) Create nodes for a generic argument.
fn nodes_for_generic_param (in sphinx_rustdocgen::nodes) Create nodes for a generic parameter, along with its bounds.
fn nodes_for_generics (in sphinx_rustdocgen::nodes) Create nodes for generics declared for an item.
fn nodes_for_lifetime_param (in sphinx_rustdocgen::nodes) Create nodes for a lifetime parameter.
fn nodes_for_parenthesized_generic_args (in sphinx_rustdocgen::nodes) Create nodes for parenthesized generic arguments in paths.
fn nodes_for_pat (in sphinx_rustdocgen::nodes) Create nodes for a pattern binding.
fn nodes_for_pat_type (in sphinx_rustdocgen::nodes) Create nodes for a type pattern binding.
fn nodes_for_path (in sphinx_rustdocgen::nodes) Create nodes for a path.
fn nodes_for_path_segment (in sphinx_rustdocgen::nodes) Create nodes for a path segment.
fn nodes_for_return_type (in sphinx_rustdocgen::nodes) Create nodes for the return type of function.
fn nodes_for_type (in sphinx_rustdocgen::nodes) Create nodes for a type specification.
fn nodes_for_type_param (in sphinx_rustdocgen::nodes) Create nodes for a type parameter, along with its bounds.
fn nodes_for_type_param_bound (in sphinx_rustdocgen::nodes) Create nodes for a type parameter binding.
fn nodes_for_type_param_bounds (in sphinx_rustdocgen::nodes) Create nodes for all type parameters in a binding.
fn nodes_for_where_clause (in sphinx_rustdocgen::nodes) Create nodes for the where clause of generics for an item.
fn type_name (in sphinx_rustdocgen::nodes) Get simple name for a type.
fn type_param_bound_name (in sphinx_rustdocgen::nodes) Get simple name for a type parameter bound.
fn type_path_name (in sphinx_rustdocgen::nodes) Get simple name for a type path.
fn traverse_crate (in sphinx_rustdocgen) Traverse the crate and extract the docstrings for the items.
fn check_for_manifest (in sphinx_rustdocgen::utils) Check the provided paths for the Cargo.toml file.
 
Macros
macro func_from_item (in sphinx_rustdocgen::directives::function_directive) DRY macro to parse the different item types.
macro push_sorted (in sphinx_rustdocgen::directives) Macro to sort and push items within a vec.
macro make_nodes (in sphinx_rustdocgen::directives::struct_directive) DRY macro to create the nodes for the directive's layout.
macro type_from_item (in sphinx_rustdocgen::directives::type_directive) DRY macro to create :rust:struct:`TypeDirective` from various syn structs.
macro var_from_item (in sphinx_rustdocgen::directives::variable_directive) DRY macro to create :rust:struct:`VariableDirective` from various ``syn``
 
Modules
module directives (in sphinx_rustdocgen) Module for the various Sphinx directives for the Rust domain.
module crate_directive (in sphinx_rustdocgen::directives) Implementation of the ``rust:crate`` directive.
module directive_options (in sphinx_rustdocgen::directives)
module enum_directive (in sphinx_rustdocgen::directives) Implementation of the ``rust:enum`` directive
module executable_directive (in sphinx_rustdocgen::directives) Implementation of the ``rust:executable`` directive.
module function_directive (in sphinx_rustdocgen::directives) Implementation of the ``rust:function`` directive
module impl_directive (in sphinx_rustdocgen::directives) Implementation of the ``rust:impl`` directive
module macro_directive (in sphinx_rustdocgen::directives) Implementation of the ``rust:macro`` directive
module module_directive (in sphinx_rustdocgen::directives) Implementation of the ``rust:module`` directive
module struct_directive (in sphinx_rustdocgen::directives) Implementation of the ``rust:struct`` directive
module trait_directive (in sphinx_rustdocgen::directives) Implementation of the ``rust:trait`` directive
module type_directive (in sphinx_rustdocgen::directives) Implementation of the ``rust:type`` directive
module use_directive (in sphinx_rustdocgen::directives)
module variable_directive (in sphinx_rustdocgen::directives) Implementation of the ``rust:variable`` directive
module formats (in sphinx_rustdocgen) Module for handling the output formats supported.
module nodes (in sphinx_rustdocgen) Module for generating a semi-structured representation of Rust signatures.
module utils (in sphinx_rustdocgen) Module for various utility classes and structs.
 
Structs
struct Configuration (in sphinx_rustdocgen) Struct to hold the deserialized configuration passed from Python.
    crate_dir The directory containing the Cargo.toml file for the crate.
    crate_name The name of the crate.
    doc_dir The directory under which to create the crate's documentation.
    force Rebuild document for all files, even if it has not changed.
    format The format to use for the output.
    strip_src Whether to remove the src/ directory when generating the docs or not.
    visibility The required visibility of the items to include.
struct RuntimeConfiguration (in sphinx_rustdocgen) Runtime version of the configuration after validation and normalizing.
    crate_dir The crate's root directory, the one which contains ``Cargo.toml``.
    crate_name The name of the crate in the configuration.
    doc_dir The directory under which to write the documents.
    executables The executables within the crate that will be documented.
    force Whether to rewrite all the documents, even the ones that are unchanged.
    format The format of the docstrings.
    lib The crate's library to document, if any.
    max_visibility Only document items with visibility less than this.
    src_dir The crate's src/ directory, if one is found and ``strip_src`` is true.
struct FileDirectives (in sphinx_rustdocgen::directives)
    impls The directives for the impls defined in the file.
    items The directives for all other items in the file.
    modules The directives for the modules defined in the file.
    uses The directives for the use statements in the file.
struct CrateDirective (in sphinx_rustdocgen::directives::crate_directive) Struct to hold data required for documenting a crate.
    content The docstring for the crate's lib.rs file.
    doc_file The path to directive's documentation file
    file_directives The directives within the crate's document file.
    name The name of the crate.
    options The options for the crate directive.
struct EnumDirective (in sphinx_rustdocgen::directives::enum_directive) Struct to hold data for documenting an enum
    content The docstring for the enum.
    ident The identifier for the enum.
    name The full Rust path of the enum, used as the name of the directive.
    options The directive options to use.
    self_impls Items within impl blocks for the enum.
    trait_impls Trait impls for the enum.
    variants The variants within the enum.
struct ExecutableDirective (in sphinx_rustdocgen::directives::executable_directive) Struct to hold data required for documenting an executable.
struct FunctionDirective (in sphinx_rustdocgen::directives::function_directive) Struct to hold data for documenting a function.
    content The docstring for the function.
    ident The identifier of the function.
    name The full Rust path of the function.
    options The directive options to use.
struct ImplDirective (in sphinx_rustdocgen::directives::impl_directive) Struct to hold details for documenting an impl block.
    content The content for the directive.
    items The directives nested under this directive.
    name The full Rust path to the impl block, used as the directive's name.
    options The options for the directive.
    resolved_self_ty The full path of the self type of the impl block.
    resolved_trait The full path of the trait implemented, if any.
    self_ty The declared self type of the impl block.
    trait_ The trait implemented in the impl block, if any.
struct MacroDirective (in sphinx_rustdocgen::directives::macro_directive)
    content
    ident
    name
    options
struct ModuleAttrs (in sphinx_rustdocgen::directives::module_directive) Module attributes
    is_test Whether the module is a test module or not
    path Path to the module
struct ModuleDirective (in sphinx_rustdocgen::directives::module_directive) Struct to hold data for a module's documentation.
    content The docstring for the module.
    doc_file The path to directive's documentation file
    file_directives The directives within the crate's document file.
    ident The identifier of the module (i.e. the final portion of name).
    name The full path to the module.
    options The options for the module directive.
    source_code_file The source code file for the module.
struct StructDirective (in sphinx_rustdocgen::directives::struct_directive) Struct to hold details for documenting a struct or a union.
    content The docstring for the struct.
    fields The fields of the struct, named or unnamed.
    ident The identifier for the struct.
    name The full Rust path of the struct, used as the name of the directive.
    options The directive options to use.
    self_impls Items within impl blocks for the struct/union.
    trait_impls Trait impls for the struct/union.
struct TraitDirective (in sphinx_rustdocgen::directives::trait_directive) Struct to hold details for documenting a trait.
    content The docstring for the trait.
    ident The identifier for the trait.
    impls Generic impls of the trait.
    items Items within the trait.
    name The full Rust path of the trait, used as the name of the directive.
    options The directive options to use.
struct TypeDirective (in sphinx_rustdocgen::directives::type_directive) Struct to hold the data for documenting type definitions.
    content The content of the directive.
    ident The identifier of the type.
    name The Rust path of the type.
    options The options of the directive.
struct UseDirective (in sphinx_rustdocgen::directives::use_directive)
    content
    directive_visibility
    paths
    reexport
struct UsePathBuilder (in sphinx_rustdocgen::directives::use_directive)
    path
    used_name
struct VariableDirective (in sphinx_rustdocgen::directives::variable_directive) Struct to hold the data for documenting variables and struct fields.
    content The content of the directive.
    ident The identifier of the variable or field.
    name The Rust path of the variable or field.
    options The options for the directive.
struct CargoManifest (in sphinx_rustdocgen::utils) Newtype struct for the Cargo manifest from cargo_toml.
struct SourceCodeFile (in sphinx_rustdocgen::utils) Struct for the source code files encountered when scanning the crate.
    item The name of the item in the file.
    path The path to the file.
 
Traits
trait MdContent (in sphinx_rustdocgen::formats) Trait for anything that can be converted to MD directive content.
    fn get_md_text
trait MdDirective (in sphinx_rustdocgen::formats) Trait for directives that can be written as MD content
    fn calc_fence_size Calculate the fence size required for the item.
    fn fence_size Return the fence size required for documenting the item.
    fn get_md_text Generate MD text with the given fence size.
    fn make_fence Make a string for the fences for the directive.
    fn make_md_header Make the MD directive header from the directive, name and options.
    fn make_md_list Make an MD list of items.
    fn make_md_section Make section in an MD document with the given title and items.
    fn make_md_toctree Make a ``toctree`` directive for MD documents.
trait MdOption (in sphinx_rustdocgen::formats) Trait for MD directive options
    fn get_md_text Return the MD text for the option.
trait RstContent (in sphinx_rustdocgen::formats) Trait for anything that can be converted to RST directive content.
    fn get_rst_text
trait RstDirective (in sphinx_rustdocgen::formats) Trait for directives that can be written as RST content
    fn get_rst_text Generate RST text with the given level of indentation.
    fn make_content_indent Make a string for indenting the directive's content and options
    fn make_indent Make a string for indenting the directive.
    fn make_rst_header Make the RST directive header from the directive, name and options.
    fn make_rst_list Make an RST list of items.
    fn make_rst_section Make section in an RST document with the given title and items.
    fn make_rst_toctree Make a ``toctree`` directive for RST documents.
trait RstOption (in sphinx_rustdocgen::formats) Trait for RST directive options.
    fn get_rst_text Return the RST text for the option.
trait FileTopLevelDirective (in sphinx_rustdocgen::utils)
    fn get_doc_file
    fn get_text
 
Types
type ItemSections (in sphinx_rustdocgen::directives) Named type for the output of :rust:fn:`order_items`.
 
Variables
const USAGE (in sphinx-rustdocgen)