Implement Events Handling (#1)

.editorconfig

@@ -20,3 +20,4 @@ indent_size = 4
 [*.toml]
 indent_style = space
 indent_size = 4
+max_line_length = off

.github/workflows/ci.yml

@@ -0,0 +1,128 @@
+name: CI
+
+on: [push, pull_request]
+
+env:
+  RUST_BACKTRACE: 1
+
+jobs:
+
+  ##########################
+  # Linting and formatting #
+  ##########################
+
+  clippy:
+    if: ${{ github.ref == 'refs/heads/master'
+      || startsWith(github.ref, 'refs/tags/v')
+      || !contains(github.event.head_commit.message, '[skip ci]') }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions-rs/toolchain@v1
+        with:
+          profile: minimal
+          toolchain: nightly
+          components: clippy
+
+      - run: make cargo.lint
+
+  rustfmt:
+    if: ${{ github.ref == 'refs/heads/master'
+      || startsWith(github.ref, 'refs/tags/v')
+      || !contains(github.event.head_commit.message, '[skip ci]') }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions-rs/toolchain@v1
+        with:
+          profile: minimal
+          toolchain: nightly
+          components: rustfmt
+
+      - run: make cargo.fmt check=yes
+
+
+
+
+  ###########
+  # Testing #
+  ###########
+
+  test:
+    if: ${{ github.ref == 'refs/heads/master'
+      || startsWith(github.ref, 'refs/tags/v')
+      || !contains(github.event.head_commit.message, '[skip ci]') }}
+    strategy:
+      fail-fast: false
+      matrix:
+        crate:
+          - arcana
+          - arcana-core
+          - arcana-codegen
+          - arcana-codegen-shim
+          - arcana-codegen-core
+        os:
+          - ubuntu
+          - macOS
+          - windows
+        toolchain:
+          - nightly
+    runs-on: ${{ matrix.os }}-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions-rs/toolchain@v1
+        with:
+          profile: minimal
+          toolchain: ${{ matrix.toolchain }}
+          override: true
+
+      - run: make test crate=${{ matrix.crate }}
+
+  msrv:
+    name: MSRV
+    if: ${{ github.ref == 'refs/heads/master'
+      || startsWith(github.ref, 'refs/tags/v')
+      || !contains(github.event.head_commit.message, '[skip ci]') }}
+    strategy:
+      fail-fast: false
+      matrix:
+        msrv: [ '1.54.0' ]
+        os:
+          - ubuntu
+          - macOS
+          - windows
+    runs-on: ${{ matrix.os }}-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions-rs/toolchain@v1
+        with:
+          profile: minimal
+          toolchain: nightly
+      - uses: actions-rs/toolchain@v1
+        with:
+          profile: minimal
+          toolchain: ${{ matrix.msrv }}
+          override: true
+
+      - run: cargo +nightly update -Z minimal-versions
+
+      - run: make test
+
+
+
+
+  #################
+  # Documentation #
+  #################
+
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions-rs/toolchain@v1
+        with:
+          profile: minimal
+          toolchain: nightly
+          override: true
+
+      - run: make cargo.doc open=no

.rustfmt.toml

@@ -0,0 +1,16 @@
+# Project configuration for rustfmt Rust code formatter.
+# See full list of configurations at:
+# https://github.com/rust-lang-nursery/rustfmt/blob/master/Configurations.md
+
+max_width = 80
+format_strings = false
+imports_granularity = "Crate"
+
+format_code_in_doc_comments = true
+format_macro_matchers = true
+use_try_shorthand = true
+
+error_on_line_overflow = true
+error_on_unformatted = true
+
+unstable_features = true

CHANGELOG.md

@@ -0,0 +1,30 @@
+`arcana` changelog
+===================
+
+All user visible changes to this project will be documented in this file. This project uses [Semantic Versioning 2.0.0].
+
+
+
+
+## [0.1.0] · 2021-06-25
+[0.1.0]: /../../tree/v0.1.0
+
+### Initially implemented
+
+- Events
+  - Traits
+    - `Event`
+    - `VersionedEvent`
+    - `EventSourced`
+    - `EventInitialised`
+  - Structs
+    - `InitialEvent` wrapper
+    - `EventVersion`
+  - Proc macros
+    - `Event` derive
+    - `VersionedEvent` derive
+
+
+
+
+[Semantic Versioning 2.0.0]: https://semver.org

Cargo.toml

@@ -0,0 +1,29 @@
+[package]
+name = "arcana"
+version = "0.1.0-dev"
+edition = "2018"
+resolver = "2"
+description = "Opionated CQRS/ES framework with type magic."
+authors = [
+    "Ilya Solovyiov <[email protected]>",
+    "Kai Ren <[email protected]>"
+]
+documentation = "https://docs.rs/arcana-core"
+homepage = "https://github.com/arcana-rs/arcana"
+repository = "https://github.com/arcana-rs/arcana"
+readme = "README.md"
+
+[features]
+derive = ["arcana-codegen"]
+es = ["arcana-core/es"]
+
+[dependencies]
+arcana-core = { version = "0.1.0-dev", path = "./core" }
+arcana-codegen = { version = "0.1.0-dev", path = "./codegen", optional = true }
+
+[workspace]
+members = ["codegen", "codegen/core", "codegen/shim", "core"]
+
+[[example]]
+name = "event"
+required-features = ["derive", "es"]

Makefile

@@ -0,0 +1,88 @@
+###############################
+# Common defaults/definitions #
+###############################
+
+comma := ,
+
+# Checks two given strings for equality.
+eq = $(if $(or $(1),$(2)),$(and $(findstring $(1),$(2)),\
+                                $(findstring $(2),$(1))),1)
+
+
+
+
+###########
+# Aliases #
+###########
+
+docs: cargo.doc
+
+
+fmt: cargo.fmt
+
+
+lint: cargo.lint
+
+
+
+
+##################
+# Cargo commands #
+##################
+
+# Generate crates documentation from Rust sources.
+#
+# Usage:
+#	make cargo.doc [crate=<crate-name>] [open=(yes|no)] [clean=(no|yes)]
+
+cargo.doc:
+ifeq ($(clean),yes)
+	@rm -rf target/doc/
+endif
+	cargo doc $(if $(call eq,$(crate),),--workspace,-p $(crate)) \
+		--all-features \
+		$(if $(call eq,$(open),no),,--open)
+
+
+# Format Rust sources with rustfmt.
+#
+# Usage:
+#	make cargo.fmt [check=(no|yes)]
+
+cargo.fmt:
+	cargo fmt --all $(if $(call eq,$(check),yes),-- --check,)
+
+
+# Lint Rust sources with Clippy.
+#
+# Usage:
+#	make cargo.lint
+
+cargo.lint:
+	cargo clippy --workspace -- -D clippy::pedantic -D warnings
+
+
+
+
+####################
+# Testing commands #
+####################
+
+# Run Rust tests of project.
+#
+# Usage:
+#	make test [crate=<crate-name>]
+
+test:
+	cargo test $(if $(call eq,$(crate),),--workspace,-p $(crate)) \
+		--all-features
+
+
+
+
+##################
+# .PHONY section #
+##################
+
+.PHONY: docs fmt lint test \
+        cargo.doc cargo.fmt cargo.lint

codegen/Cargo.toml

@@ -0,0 +1,19 @@
+[package]
+name = "arcana-codegen"
+version = "0.1.0-dev"
+edition = "2018"
+resolver = "2"
+description = "Code generation of `arcana` crate."
+authors = [
+    "Ilya Solovyiov <[email protected]>",
+    "Kai Ren <[email protected]>"
+]
+documentation = "https://docs.rs/arcana-codegen"
+homepage = "https://github.com/arcana-rs/arcana/tree/master/codegen"
+repository = "https://github.com/arcana-rs/arcana"
+readme = "README.md"
+
+[dependencies]
+arcana-codegen-shim = { version = "0.1.0-dev", path = "./shim"}
+arcana-core = { version = "0.1.0-dev", path = "../core", features = ["es"] }
+static_assertions = { version = "1.1", default-features = false }

codegen/README.md

@@ -0,0 +1,12 @@
+arcana-codegen
+==============
+
+Code generation for [`arcana`] crate.
+
+DO NOT use it directly, use [`arcana`] crate instead. 
+
+
+
+
+
+[`arcana`]: https://docs.rs/arcana

codegen/core/Cargo.toml

@@ -0,0 +1,21 @@
+[package]
+name = "arcana-codegen-core"
+version = "0.1.0-dev"
+edition = "2018"
+resolver = "2"
+description = "Core implementations of `arcana-codegen` crate."
+authors = [
+    "Ilya Solovyiov <[email protected]>",
+    "Kai Ren <[email protected]>"
+]
+documentation = "https://docs.rs/arcana-codegen-core"
+homepage = "https://github.com/arcana-rs/arcana/tree/master/codegen/core"
+repository = "https://github.com/arcana-rs/arcana"
+readme = "README.md"
+
+[dependencies]
+arcana-core = { version = "0.1.0-dev", path = "../../core", features = ["es"] }
+proc-macro2 = { version = "1.0", default-features = false }
+quote = { version = "1.0", default-features = false }
+syn = { version = "1.0", features = ["derive", "extra-traits", "parsing", "printing"], default-features = false }
+synthez = { version = "0.1", default-features = false }

codegen/core/README.md

@@ -0,0 +1,15 @@
+arcana-codegen-core
+===================
+
+Core implementations of [`arcana-codegen`] crate.
+
+DO NOT use it directly, use [`arcana`] crate instead. Unless you need to reuse [`arcana-codegen`] inner machinery in your own [proc macro][1] crate.
+
+
+
+
+
+[`arcana`]: https://docs.rs/arcana
+[`arcana-codegen`]: https://docs.rs/arcana-codegen
+
+[1]: https://doc.rust-lang.org/reference/procedural-macros.html