Macro hygiene is the concept of macros that work in all contexts; they don't affect and aren't affected by anything around them. Ideally all macros would be fully hygienic, but there are lots of pitfalls and traps that make it all too easy to accidentally write unhygienic macros. This guide attempts to provide a comprehensive resource for writing the most hygienic macros.
First, a little aside on the details of Rust's module system, and specifically paths; it is
| use secrecy::{ExposeSecret, Secret}; | |
| #[derive(Debug)] | |
| struct EncryptionKey(Secret<[u8; 32]>); | |
| fn get_encryption_key() -> EncryptionKey { | |
| let key = EncryptionKey(Secret::new(*b"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa")); | |
| println!("Pointer at creation: {:p}", key.0.expose_secret().as_ptr()); | |
| key | |
| } |
| #!/usr/bin/env python3 | |
| # -*- coding: utf-8 -*- | |
| """[application description here]""" | |
| # Prevent Python 2.x PyLint from complaining if run on this | |
| from __future__ import (absolute_import, division, print_function, | |
| with_statement, unicode_literals) | |
| __author__ = "Stephan Sokolow (deitarion/SSokolow)" | |
| __appname__ = "[application name here]" |
