# ==============================================================================
# https://doc.rust-lang.org/cargo/reference/manifest.html
#
## TOC
#
# * [package]
# * [lib]
#
# * [features]
#   - miscellaneous
#   - environment          (std,alloc,no_std)
#   - safety               (safe,unsafe,safest)
#   - nightly
#   - capability
#   - dependencies
#
# * [dependencies]
#
# - [package.metadata.*]
# - [badges]
#
# - lints
#   - [lints.rust]
#   - [lints.rustdoc]
#   - [lints.clippy]
#   - [lints.rust.unexpected_cfgs]
#
# - [[example]]

[package]
name = "devela_macros"
description = "procedural macros for devela"
version = "0.12.0"
edition = "2021"
rust-version = "1.72.1" # sync with README.md, check.sh & .github/workflows/check.yml
authors = ["José Luis Cruz <joseluis@andamira.net>"]
repository = "https://github.com/andamira/devela_macros"
documentation = "https://docs.rs/devela_macros"
license = "MIT OR Apache-2.0"
include = [
	"/Cargo.toml",
	"/DOCS/*", "/LICENSE*",
	"/src/**/*.rs", "/src/**/*.md",

	# examples used in docs:
	"/examples/*.rs",
]
categories = ["rust-patterns", "development-tools::procedural-macro-helpers"]
keywords = ["dev", "helper", "helpers", "extension", "code-generation"]
publish = true

[lib]
proc-macro = true


[features] # # 9/300 (291 remaining), 8 visible, 1 hidden
# ==============================================================================

#* Miscellaneous features *#
# ------------------------------------------------------------------------------

default = ["safe", "dep_hashbrown"]


#* Environment features *#
# ------------------------------------------------------------------------------

std = ["alloc"]
alloc = []


#* Safety features *#
# ------------------------------------------------------------------------------

unsafe = [] # enables unsafe features in this crate (unused)
safe = [] # forbids `unsafe` in this crate


#* Nightly features tree *#
# ------------------------------------------------------------------------------

nightly = ["nightly_doc"]
	nightly_doc = [] # doc_cfg


#* Capability features *#
# ------------------------------------------------------------------------------

# The most complete version of the documentation:
_docsrs = ["nightly", "std", "unsafe", "dep_hashbrown"]

# dependencies
dep_hashbrown = ["dep:hashbrown", "alloc"]


[dependencies] # 3 (2 required, 1 optional)
# ==============================================================================
# WAIT: [proc_macro_quote](https://github.com/rust-lang/rust/issues/54722)
proc-macro2 = "1.0.88"
quote = "1.0.37"

[dependencies.hashbrown]
version = "0.15.1"
optional = true
default-features = false
features = ["default-hasher", "inline-more"]


[package.metadata.docs.rs]
# ==============================================================================
no-default-features = true
features = ["_docsrs"]


[badges]
# ==============================================================================
maintenance = { status = "experimental" }

# examples
# ==============================================================================

[[example]]
name = "cif"
required-features = ["alloc"]
[[example]]
name = "coalesce"
required-features = ["alloc"]
[[example]]
name = "compile_attr"
required-features = ["alloc"]
[[example]]
name = "compile_doc"
required-features = ["alloc"]
[[example]]
name = "compile"
required-features = ["alloc"]
[[example]]
name = "enumint"
required-features = ["alloc"]