Skip to content

Latest commit

 

History

241 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SoftwareEngineeringDoneRight-Library

Repository with useful and usable software components used in the Software Engineering Done Right book.

Repository layout

This repository is not a single Gradle multi-module build. Each project below is a standalone Gradle build with its own wrapper, its own version, and — for the two published projects — its own GitHub Actions build/release/security-scan workflows. Run ./gradlew from within a project’s directory, not from the repository root.

Project path Purpose

sedr-library/

Published shared Java annotations and utilities for SEDR projects.

hexagonal-spring-rules/

Published Spring-focused external architecture rule pack for the Architecture Validator plugin.

geo-tracker-lens-pack/

Published geography-inspired external lens pack for the Tracker Lens plugin.

api-detector-core/

Published shared domain model and scanning logic for the SEDR API detector Gradle plugins (Shadow, Mirage, Doppelganger API Detector).

api-only-transcriberj-restdocs/

Published Spring REST Docs emitter for the API-Only TranscriberJ Gradle plugin: REST Docs companions for the classes it generates from an API contract.

api-only-transcriberj-microcks/

Published Microcks emitter for the API-Only TranscriberJ Gradle plugin: a JUnit 5 conformance test per send operation of an API contract’s AsyncAPI document, checking what an application publishes against a Microcks-imported copy of the contract.

api-only-transcriberj-wiremock/

Published WireMock emitter for the API-Only TranscriberJ Gradle plugin: WireMock stubs for every contract case the TranscriberJ derives from an API contract, with fallbacks for every other request, packaged for the API’s consumers and serving as the reference double for contract tests in any language.

nvd-cache-primer/

Internal utility project that primes and validates the shared OWASP Dependency-Check NVD cache used by this repository’s security-scan workflows. Not published.

examples/architecture-validator/single-module-spring/

Runnable example that demonstrates a Spring Hexagonal rule-pack violation and a failing architecture validation build.

examples/sedr-library/jacoco-marker/

Runnable example that demonstrates compliant and non-compliant usage of @ExcludeFromJacocoGeneratedCodeCoverage.

examples/api-only-transcriberj/description-bundles/

Runnable example of the API-Only TranscriberJ’s descriptions from a ResourceBundle the project owns, in more than one language.

examples/api-only-transcriberj/hand-written-contract-tests/

Runnable example of contract tests written by hand on the classes the API-Only TranscriberJ generates, where the generator cannot write a request body.

examples/transcriberj/generated-contract-tests/, in the API repository

Runnable example of everything the API-Only TranscriberJ and its REST Docs and WireMock emitters generate: contract tests run against the real service and against a WireMock double, their fixtures, the stubs as an archive and a Docker image, and published documentation from a documentation test suite.

hexagonal-spring-rules

geo-tracker-lens-pack

api-detector-core

api-only-transcriberj-restdocs

api-only-transcriberj-microcks

api-only-transcriberj-wiremock

nvd-cache-primer

examples/architecture-validator/single-module-spring

examples/sedr-library/jacoco-marker

License

This repository is licensed under the terms in LICENSE. Published sub-projects (sedr-library/, hexagonal-spring-rules/, api-detector-core/) are part of the same repository and license.

About

Repository with useful and usable software components used in the Software Engineering Done Right book

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages