// -*- mode:rust; coding:utf-8-unix; -*-

//! lib.rs

//  Copyright 2016 hanepjiv
//  @author hanepjiv <hanepjiv@gmail.com>
//  @copyright The MIT License (MIT) / Apache License Version 2.0
//  @since 2016/03/08
//  @date 2024/04/27

//!
//! # Examples
//!
//! ## Elicit
//!
//! ```
//! pub(crate) mod mine {
//!     use elicit::{elicit_define, Elicit};
//!
//!     #[elicit_define(mine_elicit)]
//!     pub(crate) trait Mine {
//!         fn action(&self) -> i32;
//!         fn action_mut(&mut self) -> i32;
//!     }
//!
//!     // pub(crate) mine_elicit::author as elicit_author;
//!     pub(crate) use mine_elicit::user as elicit_user;
//!
//!     #[derive(Debug, Default, Clone, Elicit)]
//!     #[elicit_mod_author(mine_elicit::author)]
//!     pub(crate) struct MineX {}
//!
//!     impl Mine for MineX {
//!         fn action(&self) -> i32 {
//!             0i32
//!         }
//!         fn action_mut(&mut self) -> i32 {
//!             0i32
//!         }
//!     }
//!
//!     #[derive(Debug, Clone, Elicit)]
//!     #[elicit_mod_author(mine_elicit::author)]
//!     // #[elicit_from_self_field(_fsf)] // here
//!     pub(crate) struct MineY {
//!         #[elicit_from_self_field] // or here
//!         _fsf: mine_elicit::author::ElicitFromSelfField,
//!         i: i32,
//!     }
//!
//!     impl MineY {
//!         pub(crate) fn new(a: i32) -> Self {
//!             MineY {
//!                 _fsf: Default::default(),
//!                 i: a,
//!             }
//!         }
//!         ///
//!         ///
//!         /// fn evil
//!         ///
//!         /// It is not possible to suppress calls to _weak_assign within
//!         /// the same module.
//!         ///
//!         #[allow(box_pointers, dead_code)]
//!         pub(crate) fn evil(&mut self) -> elicit::Result<()> {
//!             use mine_elicit::author::*;
//!             use std::{cell::RefCell, rc::Rc};
//!             self._weak_assign(Rc::<RefCell<Box<dyn ElicitBase>>>::downgrade(
//!                 &Rc::new(RefCell::new(Box::<MineX>::default())),
//!             ))
//!         }
//!     }
//!
//!     impl Mine for MineY {
//!         fn action(&self) -> i32 {
//!             self.i
//!         }
//!         fn action_mut(&mut self) -> i32 {
//!             self.i += 1;
//!             self.i
//!         }
//!     }
//! }
//!
//! pub(crate) fn fire() -> elicit::Result<()> {
//!     use mine::elicit_user::Elicit as MineElicit;
//!     use mine::{MineX, MineY};
//!
//!     let mut e: MineElicit;
//!
//!     e = MineElicit::new(MineX::default())?;
//!
//!     e.try_with(|m| -> elicit::Result<()> {
//!         println!("{:?}", m);
//!         assert!(m.action() == 0);
//!         Ok(())
//!     })?;
//!
//!     let y = MineY::new(1);
//!
//!     // eprintln!("{:?}", y.evil());
//!
//!     e = MineElicit::new(y)?;
//!
//!     e.try_with_mut(|m| -> elicit::Result<()> {
//!         println!("{:?}", m);
//!         assert!(m.action_mut() == 2);
//!         Ok(())
//!     })?;
//!
//!     Ok(())
//! }
//!
//! fire().expect("Doc-tests");
//! ```
//!

// ////////////////////////////////////////////////////////////////////////////
// attribute  =================================================================
/*
// rustc 1.77.2 (25ef9e3d8 2024-04-09)
#![forbid(
    absolute_paths_not_starting_with_crate,
    deprecated_in_future,
    elided_lifetimes_in_paths,
    explicit_outlives_requirements,
    ffi_unwind_calls,
    keyword_idents,
    let_underscore_drop,
    macro_use_extern_crate,
    meta_variable_misuse,
    missing_abi,
    missing_copy_implementations,
    missing_debug_implementations,
    missing_docs,
    non_ascii_idents,
    rust_2021_incompatible_closure_captures,
    rust_2021_incompatible_or_patterns,
    rust_2021_prefixes_incompatible_syntax,
    rust_2021_prelude_collisions,
    single_use_lifetimes,
    trivial_numeric_casts,
    unit_bindings,
    unsafe_code,
    unsafe_op_in_unsafe_fn,
    unstable_features,
    unused_crate_dependencies,
    unused_extern_crates,
    unused_import_braces,
    unused_lifetimes,
    unused_macro_rules,
    unused_qualifications,
    unused_results,
    variant_size_differences,
    ambiguous_glob_imports,
    ambiguous_glob_reexports,
    ambiguous_wide_pointer_comparisons,
    anonymous_parameters,
    array_into_iter,
    asm_sub_register,
    async_fn_in_trait,
    bad_asm_style,
    bare_trait_objects,
    break_with_label_and_loop,
    byte_slice_in_packed_struct_with_derive,
    clashing_extern_declarations,
    coherence_leak_check,
    confusable_idents,
    const_evaluatable_unchecked,
    const_eval_mutable_ptr_in_final_value,
    const_item_mutation,
    deprecated,
    deprecated_where_clause_location,
    deref_into_dyn_supertrait,
    deref_nullptr,
    dropping_copy_types,
    dropping_references,
    drop_bounds,
    duplicate_macro_attributes,
    dyn_drop,
    elided_lifetimes_in_associated_constant,
    ellipsis_inclusive_range_patterns,
    exported_private_dependencies,
    forbidden_lint_groups,
    forgetting_copy_types,
    forgetting_references,
    for_loops_over_fallibles,
    function_item_references,
    hidden_glob_reexports,
    improper_ctypes,
    improper_ctypes_definitions,
    incomplete_features,
    indirect_structural_match,
    inline_no_sanitize,
    internal_features,
    invalid_doc_attributes,
    invalid_from_utf8,
    invalid_macro_export_arguments,
    invalid_nan_comparisons,
    invalid_value,
    irrefutable_let_patterns,
    large_assignments,
    late_bound_lifetime_arguments,
    legacy_derive_helpers,
    map_unit_fn,
    mixed_script_confusables,
    named_arguments_used_positionally,
    non_camel_case_types,
    non_fmt_panics,
    non_shorthand_field_patterns,
    non_snake_case,
    non_upper_case_globals,
    noop_method_call,
    no_mangle_generic_items,
    opaque_hidden_inferred_bound,
    overlapping_range_endpoints,
    path_statements,
    pointer_structural_match,
    private_bounds,
    private_interfaces,
    redundant_semicolons,
    refining_impl_trait,
    renamed_and_removed_lints,
    repr_transparent_external_private_fields,
    semicolon_in_expressions_from_macros,
    special_module_name,
    stable_features,
    static_mut_refs,
    suspicious_double_ref_op,
    temporary_cstring_as_ptr,
    trivial_bounds,
    type_alias_bounds,
    tyvar_behind_raw_pointer,
    uncommon_codepoints,
    unconditional_recursion,
    undefined_naked_function_abi,
    unexpected_cfgs,
    ungated_async_fn_track_caller,
    uninhabited_static,
    unknown_lints,
    unnameable_test_items,
    unreachable_code,
    unreachable_patterns,
    unstable_name_collisions,
    unstable_syntax_pre_expansion,
    unsupported_calling_conventions,
    unused_allocation,
    unused_assignments,
    unused_associated_type_bounds,
    unused_attributes,
    unused_braces,
    unused_comparisons,
    unused_doc_comments,
    unused_features,
    unused_imports,
    unused_labels,
    unused_macros,
    unused_must_use,
    unused_mut,
    unused_parens,
    unused_unsafe,
    unused_variables,
    useless_ptr_null_checks,
    where_clauses_object_safety,
    while_true,
    writes_through_immutable_pointer,
    ambiguous_associated_items,
    arithmetic_overflow,
    bindings_with_variant_name,
    cenum_impl_drop_cast,
    conflicting_repr_hints,
    deprecated_cfg_attr_crate_type_name,
    enum_intrinsics_non_enums,
    ill_formed_attribute_input,
    incomplete_include,
    ineffective_unstable_trait_impl,
    invalid_atomic_ordering,
    invalid_from_utf8_unchecked,
    invalid_reference_casting,
    invalid_type_param_default,
    let_underscore_lock,
    long_running_const_eval,
    macro_expanded_macro_exports_accessed_by_absolute_paths,
    missing_fragment_specifier,
    mutable_transmutes,
    named_asm_labels,
    no_mangle_const_items,
    order_dependent_trait_objects,
    overflowing_literals,
    patterns_in_fns_without_body,
    proc_macro_back_compat,
    proc_macro_derive_resolution_fallback,
    pub_use_of_private_extern_crate,
    soft_unstable,
    text_direction_codepoint_in_comment,
    text_direction_codepoint_in_literal,
    unconditional_panic,
    undropped_manually_drops,
    unknown_crate_types,
    useless_deprecated,
    clippy::all,
    box_pointers,
    dead_code,
    trivial_casts,
    unreachable_pub
)]
*/
// ////////////////////////////////////////////////////////////////////////////
// mod  =======================================================================
mod error;
// ////////////////////////////////////////////////////////////////////////////
// use  =======================================================================
#[cfg(feature = "parking_lot")]
pub use parking_lot::{
    Mutex, MutexGuard, RwLock, RwLockReadGuard, RwLockWriteGuard,
};
// ----------------------------------------------------------------------------
#[cfg(not(any(feature = "parking_lot",)))]
pub use std::sync::{
    Mutex, MutexGuard, RwLock, RwLockReadGuard, RwLockWriteGuard,
};
// ============================================================================
pub use self::error::{Error, Result};
pub use elicit_macro::{
    aelicit_define, elicit_define, melicit_define, Aelicit, Elicit, Melicit,
};