resolc crate (#328)

- Factor the YUL crate out of `revive-solidity`.
- `revive-solidity` is in reality not a Solidity implementation but the
revive solidity compiler driver (`resolc`). By renaming we not only get
this straight but also a binary with the same name as the crate which
should be less confusing.

---------

Signed-off-by: Cyrill Leutwiler <bigcyrill@hotmail.com>

crates/yul/src/parser/error.rs

@@ -0,0 +1,63 @@
+//! The Yul IR parser error.
+
+use std::collections::BTreeSet;
+
+use crate::lexer::token::location::Location;
+
+/// The Yul IR parser error.
+#[derive(Debug, thiserror::Error, PartialEq, Eq)]
+pub enum Error {
+    /// An invalid token received from the lexer.
+    #[error("{location} Expected one of {expected:?}, found `{found}`")]
+    InvalidToken {
+        /// The invalid token location.
+        location: Location,
+        /// The list of expected tokens.
+        expected: Vec<&'static str>,
+        /// The invalid token.
+        found: String,
+    },
+    /// A reserved keyword cannot be used as an identifier.
+    #[error("{location} The identifier `{identifier}` is reserved")]
+    ReservedIdentifier {
+        /// The invalid token location.
+        location: Location,
+        /// The invalid identifier.
+        identifier: String,
+    },
+    /// Invalid number of function arguments.
+    #[error("{location} Function `{identifier}` must have {expected} arguments, found {found}")]
+    InvalidNumberOfArguments {
+        /// The invalid function location.
+        location: Location,
+        /// The invalid function name.
+        identifier: String,
+        /// The expected number of arguments.
+        expected: usize,
+        /// The actual number of arguments.
+        found: usize,
+    },
+    /// Invalid object name.
+    #[error(
+        "{location} Objects must be named as '<name>' (deploy) and '<name>_deployed' (runtime)"
+    )]
+    InvalidObjectName {
+        /// The invalid token location.
+        location: Location,
+        /// The expected identifier.
+        expected: String,
+        /// The invalid identifier.
+        found: String,
+    },
+    /// Invalid attributes.
+    #[error("{location} Found invalid LLVM attributes: {values:?}")]
+    InvalidAttributes {
+        /// The invalid token location.
+        location: Location,
+        /// The list of invalid attributes.
+        values: BTreeSet<String>,
+    },
+    /// Invalid code length.
+    #[error("The line or column length exceed the maximum of u32::MAX")]
+    InvalidLength,
+}