Merge PR #165: Make rsass-macros more release-ready.

Adds to #163
- Rename rsass-macro to rsass-macros, as I will add a second macro for including css from scss in a file.
- Add rsass-macros to the workspace.
- Add some documentaion.

Author: kaj

Diff for: CHANGELOG.md

@@ -16,6 +16,9 @@ project adheres to
   - Tests are restructured to fail faster for simple things, while
     macos and windows testing is added to the github action (appveyor
     is removed).
+* Added macros (PR #163, #165).
+  - The workspace now includes a `rsass-macros` crate that can be used to
+    compile sass to css strings at compile time in rust crates.
 * Changed numeric handing (mainly conversions to/from `f64`) to match
   improvements in how dart-sass handles numerics.  This is mainly done by
   removing some special cases as dart-sass and rust now agrees on more of
@@ -48,6 +51,8 @@ project adheres to
 * Updated clap to 4.0 for the command-line interface.
 * Updated sass-spec test suite to 2022-12-20.
 
+Thanks to @Wicpar for the initial macros implementation.
+
 
 ## Release 0.26.0
 

Diff for: Cargo.toml

@@ -3,5 +3,6 @@
 members = [
    "rsass",
    "rsass-cli",
+   "rsass-macros",
    "spectest",
 ]

Diff for: rsass-macro/.gitignore

@@ -0,0 +1,21 @@
+[package]
+name = "rsass-macros"
+version = "0.1.0"
+categories = ["web-programming"]
+keywords = ["scss", "sass", "css", "web", "macro"]
+description = "Sass as a rust function-like macro."
+documentation = "https://docs.rs/rsass-macros"
+repository = "https://github.com/kaj/rsass"
+readme = "README.md"
+license = "MIT OR Apache-2.0"
+edition = "2021"
+rust-version = "1.60.0"
+
+[lib]
+proc-macro = true
+
+[dependencies]
+rsass = { path = "../rsass", version = "0.26.1-PRE" }
+proc-macro2 = "1.0.32"
+quote = "1.0.22"
+syn = "1.0.106"

Diff for: rsass-macro/Cargo.toml

@@ -0,0 +1,29 @@
+# rsass-macros
+
+Sass reimplemented in rust with nom.
+The "r" in the name might stand for the Rust programming language, for
+"re-implemented", or possibly for my name Rasmus.
+
+This is the `rsass-macros` crate, giving rust projects access to
+sass-compiled strings in compile-time.
+To use it, add `rsass-macros` to your dependencies in a rust project.
+
+    cargo add rsass-macros
+
+[![Crate](https://img.shields.io/crates/v/rsass-macros.svg)](https://crates.io/crates/rsass-macros)
+[![docs](https://docs.rs/rsass-macros/badge.svg)](https://docs.rs/rsass-macros)
+[![Github build](https://github.com/kaj/rsass/workflows/CI/badge.svg)](https://github.com/kaj/rsass/actions)
+
+## Sass language and implementation status
+
+The sass language [is defined in its reference
+doc](http://sass-lang.com/documentation/).
+See [the rsass crate](https://docs.rs/rsass) or the the
+[rsass monorepo](https://github.com/kaj/rsass/) for the
+implementation status.
+
+## Contributing
+
+Welcome!
+Please see the [rsass monorepo](https://github.com/kaj/rsass/)
+about contributing.

Diff for: rsass-macros/Cargo.toml

@@ -1,10 +1,20 @@
-extern crate proc_macro;
+//! Convert scss to css at compile-type.
+//! Implemented with [rsass].
 use proc_macro::TokenStream;
 use proc_macro2::Span;
 use quote::ToTokens;
-use syn::{Error, LitStr, parse_macro_input};
 use rsass::output::{Format, Style};
+use syn::{parse_macro_input, Error, LitStr};
 
+/// Convert a scss string to css at compile time.
+///
+/// # Examples
+///
+/// ````
+/// use rsass_macros::scss;
+/// const CSS: &str = scss!("p { em { font-style: italic; } font: serif; }");
+/// assert_eq!(CSS, "p{font:serif}p em{font-style:italic}\n");
+/// ````
 #[proc_macro]
 pub fn scss(tokens: TokenStream) -> TokenStream {
     let input = parse_macro_input!(tokens as LitStr);
@@ -26,4 +36,4 @@ pub fn scss(tokens: TokenStream) -> TokenStream {
                 .into()
         }
     }
-}
+}

Diff for: rsass-macros/README.md

@@ -1,13 +1,14 @@
-
 #[test]
 fn test_macro() {
-    const CSS: &'static str = rsass_macro::scss!(r#"
+    const CSS: &'static str = rsass_macros::scss!(
+        r#"
         .class {
             background: red;
             &:hover {
                 background: blue;
             }
         }
-    "#);
+    "#
+    );
     assert_eq!(".class{background:red}.class:hover{background:blue}\n", CSS)
 }