Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
21 changes: 21 additions & 0 deletions jdk_21_maven/cs/rest-gui/microcks/.editorconfig
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
# EditorConfig helps developers define and maintain consistent
# coding styles between different editors and IDEs
# editorconfig.org

root = true


[*]

# Change these settings to your own preference
indent_style = space
indent_size = 2

# We recommend you to keep these unchanged
end_of_line = lf
charset = utf-8
trim_trailing_whitespace = true
insert_final_newline = true

[*.md]
trim_trailing_whitespace = false
23 changes: 23 additions & 0 deletions jdk_21_maven/cs/rest-gui/microcks/.jshintrc
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
{
"node": true,
"browser": true,
"esnext": true,
"bitwise": true,
"camelcase": true,
"curly": true,
"eqeqeq": true,
"immed": true,
"indent": 2,
"latedef": true,
"newcap": true,
"noarg": true,
"quotmark": "single",
"undef": true,
"unused": true,
"strict": true,
"trailing": true,
"smarttabs": true,
"globals": {
"angular": false
}
}
47 changes: 47 additions & 0 deletions jdk_21_maven/cs/rest-gui/microcks/ADOPTERS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
> [!IMPORTANT]
> This file is automatically synchronized across Microcks organization repositories. To make edits, please submit a PR to the source repository: https://github.com/microcks/.github/edit/main/ADOPTERS.md

# Adopters

**📢 _If you're using Microcks in your organization, please add your company name to this list. 🙏 It really helps the project to gain momentum and credibility. It's a small contribution back to the project with a significant impact._**

Respect is a core principle in our open source community; see our [Code of Conduct](https://github.com/microcks/.github/blob/main/CODE_OF_CONDUCT.md). We value your contributions and rely on your input, and we believe we can achieve more together.

If you need to know why and how to add yourself to the list, please read the blog post "[Join the Microcks Adopters list](https://microcks.io/blog/join-adopters-list/) and Empower the vibrant open source Community 🙌"

This document also lists the organizations using Microcks based on public information in blog posts, events, and videos. If any organization would like to get added or removed, please edit this file (make a pull request) after following our [contribution guide](https://github.com/microcks/.github/blob/master/CONTRIBUTING.md) and by following these specifics guidelines:
- Kindly include a reference (such as a link to a public blog post, video, slides, etc.) that mentions using Microcks.
- You consent to have your company’s name and logo featured on the [Microcks.io website](https://microcks.io/), included in our adopters' section, and potentially displayed in our rotating logo carousel.
- Adopter type follows the [CNCF definitions outlined](https://github.com/cncf/toc/blob/main/FAQ.md#what-is-the-definition-of-an-adopter): CNCF `End-User` member, `Another project`, `end user`, `Service Provider` or `Consultancy`.

> You can contact the project [maintainers](https://github.com/microcks/.github/blob/main/MAINTAINERS.md) if you have any questions or need further information.


| Organization | Contact | Adopter type | Description of Use / Reference |
|---------------------|---------------------|---------------------|-----------------------------------------------------------------------------------|
| [Lombard Odier Group](https://www.lombardodier.com/) | [Ludovic Pourrat](https://github.com/ludovic-pourrat) | `end user` | Multi-protocol API Mocking and Sandbox as a service #APIOps. APIdays Paris 2022 - Adding a mock as a service capability to your API strategy portfolio 👉 [slide deck](https://speakerdeck.com/apidays/apidays-paris-2022-adding-a-mock-as-a-service-capability-to-your-api-strategy-portfolio-ludovic-pourrat-lombard-odier) ⭐️ |
| [La Poste Groupe](https://www.lapostegroupe.com/) | [Nicolas Matelot](https://www.linkedin.com/in/nicolas-matelot/) [Romain Gil](https://www.linkedin.com/in/romain-gil-8444898a) | `end user` | Cloud-native application development, API Mocking and Sandbox. |
| [J.B. Hunt](https://www.jbhunt.com/) | [Carol Gschwend](https://github.com/carolgschwend) | `end user` | Accelerating cloud-native application development "The developers of the project mentioned above saved at least 7 months using Microcks. They were not only able to work concurrently but also captured the exact business requirements specified by the product owner in the form of example request/response pairs. These persistent mocks can now be utilized in sandbox environments if needed." See J.B. Hunt ⭐️ [blog post](https://microcks.io/blog/jb-hunt-mock-it-till-you-make-it/) ⭐️ |
| [Société Générale](https://www.societegenerale.com/en) | [Patrice Lachance](https://github.com/patlachance) | `end user` | Multi-protocol API Mocking, Testing and Sandbox for cloud-native APIs / applications. Cloud Innovation Platform presentation and Microcks demo 👉 [Red Hat Summit 2019](https://www.redhat.com/files/summit/session-assets/2019/T8B6B4.pdf) ⭐️|
| [Deloitte](https://www.deloitte.com/global/en.html) | [Madiha Rehman](https://www.linkedin.com/in/madihar/) | `End-User` `Consultancy` | Utilised Microcks to create backend mocks for 170+ APIs including REST and SOAP services.|
| [sesam-vitale](https://www.sesam-vitale.fr/) | [Vincent Fasciaux](mailto:vincent.fasciaux@sesam-vitale.fr) | `end user` | We use Microcks to replace the SUT's dependencies with test doubles in order to accelerate our API deliveries.|
| [BNP PARIBAS](https://group.bnpparibas/en/) | [Nadji BERRAF](https://www.linkedin.com/in/nadji-berraf-26707148/) | `end user` | We use Microcks since 2022 to mock our legacy core banking systems and mainframe APIs in order to increase agility, accelerate development, and reduce costs. Microcks is also integrated into our API-first strategy for building and delivering new cloud-native services.|
| [Akwatype](https://akwatype.io) | [Pierre-Michel Bret](https://www.linkedin.com/in/pierre-michel-bret/) | `Service Provider` | Use of Microcks to mock the APIs corresponding to the OpenAPI contracts generated by Akwatype, integration through Git.|
| [codecentric AG](https://www.codecentric.de) | [Daniel Kocot](https://www.linkedin.com/in/danielkocot/) | `Consultancy` | API Operations pipeline with an integration of Microcks and consulting services around API Mocking and Testing.|
| [CNAM](https://www.ameli.fr) | [Sébastien Fraigneau](https://www.linkedin.com/in/s%C3%A9bastien-fraigneau-82826a2) | `end user` | Using Microcks to mock SOAP services for the French healthcare system. REST is coming.|
| [CloudAPPi](https://cloudappi.net) | [Marco Antonio Sanz Molina Prados](https://www.linkedin.com/in/marco-antonio-sanz-molina-prados-09733518/)| `Service Provider` | We manage over 40 APIs strategies in medium and big companies and install Microcks as a mock server. |
| [Sypid](https://www.sypid.com/) | [Zubair Aslam](https://www.linkedin.com/in/zubes1/)| `Consultancy` | Sypid consultants are highly experienced in the Spec-first approach to API and integration design. We use Microcks to implement this approach effectively. We found the docker extension is specifically useful to get started quickly.|
| [Inetum Software](https://www.inetum.com/) | [Jérôme Palon](https://www.linkedin.com/in/jpalon/)| `end user` `Consultancy` | We use Microcks as an API centralisation and mock server for the social and civil security division, paving the path for migration to microservices and event-driven cloud architecture.|
| [Fluent CI](https://fluentci.io/) | [Tsiry Sandratraina](https://github.com/tsirysndr)| `Another project` | We use Microcks to mock and test our REST and GraphQL APIs. We also provide an open source [Microcks module](https://github.com/fluent-ci-templates/microcks-pipeline) for [Dagger](https://dagger.io) and [Fluent CI](https://fluentci.io).|
| [Nordic Semiconductor](https://nordicsemi.com) | [Patrick Barnes](https://www.linkedin.com/in/patrick-barnes-pdx/) | `end user` | We use Microcks mainly via testcontainers to test the REST APIs (and probably soon, our async, event-based APIs) for the microservices that comprise our IoT platform, [nRFCloud.com](https://nrfcloud.com/). Microcks has been invaluable, and the Microcks team a real pleasure to work with!|
| [Office national de l'emploi (ONEm)](https://www.onem.be/) | [Samuel Antoine](https://www.linkedin.com/in/samuel-antoine-07347b171/) [Christophe Lopez](https://www.linkedin.com/in/aeoncl/) | `end user` | We use Microcks as both OpenAPI contract testing tool and mock provider.|
| [Bitso](https://bitso.com/) | [Caio Amaral](https://www.linkedin.com/in/camaral) | `end user` | Microcks supports Bitso's integration and capacity testing infrastructure, allowing us to isolate the applications through well defined gRPC contracts.|
| [Catena Clearing](https://catenaclearing.io/) | [Andre Sionek](https://www.linkedin.com/in/andresionek) | `end user` | We use Microcks to mock 3rd party APIs so we can develop against them without hitting the real endpoints, Microcks is also used to run integration tests.|
| [Traefik](https://traefik.io/) | [Emile Vauge](https://github.com/emilevauge) | `Another project` `Service Provider` | We use Microcks in [Traefik’s API sandbox solution](https://traefik.io/solutions/api-mocking/) to enable developers create, publish, and consume mock APIs with production-like UX and SLAs.|
| [APIQuality](https://apiquality.io/) | [Marco Antonio Sanz](https://www.linkedin.com/in/marco-antonio-sanz-molina-prados-09733518/) [Omar del Valle](https://www.linkedin.com/in/omardelvalle/) | `Service Provider` | Your low code tool to integrate APIOps. Develops secure and quality APIs implementing API First methodology. We use Microcks as our default tool for mocking. Create secure and functional APIs from a single tool!|
| [Banco PAN](https://www.bancopan.com.br/) | [Renan Elias Saraiva](https://www.linkedin.com/in/renan-elias-28781894/) | `end user` | We leverage Microcks to create a virtual environment, simulating API and AsyncAPI services while seamlessly connecting with our external Kafka cluster for testing purposes. |
|[ Office des Postes et Télécommunications de Nouvelle-Calédonie](https://www.opt.nc/) | [Adrien SALES](https://www.linkedin.com/in/adrien-sales/) [Vinh Faucher](https://www.linkedin.com/in/vinh-faucher/) [Michèle BARRE](https://www.linkedin.com/in/michelebarre/)| `end user` | API & Kafka Mocking (end users & Github.com CI), see [Microcks for dummies](https://dev.to/optnc/microcks-for-dummies-1imn) on [dev.to/optnc](https://dev.to/optnc) for more information.|
|[ Bump.sh](https://bump.sh/) | [Christophe Dujarric](https://www.linkedin.com/in/christophedujarric/) [Sebastien Charrier](https://www.linkedin.com/in/sebastiencharrier/)| `Service Provider` | Using Bump.sh and Microcks together allows you to create a clear feedback cycle of [API documentation](https://bump.sh/), testing, simulation, trial implementation, and iteration. [Read more about this](https://bump.sh/blog/microcks-bump-sh-testing-mocking-docs).|
|[Michelin](https://www.michelin.fr/) | [Alex Picarle](https://github.com/AlexP63) | `End-User` | We use Microcks to elaborate our PoCs, to offer api sandbox or discovery trials and overall promote #DesignFirst approach.|
|[Amway](https://www.amway.com/) | [Brian Hibma](https://www.linkedin.com/in/brianhibma/) [Sai Bommakanti](https://www.linkedin.com/in/saiabhinay-bommakanti-31014943/) | `end user` | We use Microcks primarily as a platform for API and Event mocking and discovery, integrating it into our DevOps and CI/CD practices, and unblocking parallel, contract-based development from teams. |
|[BITMARCK](https://www.bitmarck.de) | [Michael Goll](https://github.com/goll-michael) | `end user` | We use Microcks to mock the APIs that correspond to the generated or manually created OpenAPI contracts.|
46 changes: 46 additions & 0 deletions jdk_21_maven/cs/rest-gui/microcks/BACKERS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
# Sponsors & Backers

[Microcks](https://microcks.io/) is a [Cloud Native Computing Foundation Sandbox](https://landscape.cncf.io/?selected=microcks) project 🚀 with its ongoing development made possible entirely by the support of the awesome sponsors and backers listed in this file. If you'd like to join them, please consider [sponsoring](https://opencollective.com/microcks) Microcks's development.

**BTW 📢 _If you're using Microcks in your organization, please add your company name to the adopters list. 🙏 It really helps the project to gain momentum and credibility. It's a small contribution back to the project with a big impact._**
https://github.com/microcks/.github/blob/main/ADOPTERS.md

> Platinum💎, gold🥇 and silver🥈 **sponsors**, [join us](https://opencollective.com/microcks) 🙌<br>
> **Invest** in **your supply chain!**

If you run a business and is using Microcks in a revenue-generating product/service, it would make business sense to sponsor Microcks development: it ensures the project that you rely on a healthy, strong and engaged community. It can also help your exposure in the open source community and makes it easier to attract new talents.

If you'd like to help and support Microcks to [level up](https://www.cncf.io/project-metrics/) within the [CNCF](https://www.cncf.io) and keep growing the open source way, please consider:

- [Become a backer or sponsor on OpenCollective](https://opencollective.com/microcks).

## Special Sponsors
[image width="350"]: #
<p align="center">
<a href="https://postman.com/"><img src="https://voyager.postman.com/logo/postman-logo-orange.svg" alt="Postman logo" width="350"></a>
</p>

## Platinum Sponsors
[image width="300"]: #
[Become the first platinum sponsor](https://opencollective.com/microcks/contribute/platinum-sponsors-61341/checkout?interval=month&amount=2000&name=&legalName=&email=)

## Gold Sponsors
[image width="250"]: #
[Become the first gold sponsor](hhttps://opencollective.com/microcks/contribute/gold-sponsors-61340/checkout?interval=month&amount=1000&name=&legalName=&email=)

## Silver Sponsors
[image width="200"]: #
[Become the first silver sponsor](https://opencollective.com/microcks/contribute/silver-sponsors-61339/checkout?interval=month&amount=500&name=&legalName=&email=)

## Bronze Sponsors
[image width="150"]: #
<p align="center">
<a href="https://bitso.com/"><img src="https://logowik.com/content/uploads/images/bitso5417.jpg" alt="Bitso logo" width="120"></a>
<a href="https://www.devmark.ai/fern/?utm_source=microcks&utm_loc=readme&utm_type=logo"><img src="https://uploads-ssl.webflow.com/64f77a831b9d50c279dc926c/6568d0303c2a1435c108e114_fern.svg" alt="Fern logo" width="150"></a>
</p>

[Become a bronze sponsor](https://opencollective.com/microcks/contribute/bronze-sponsors-61338/checkout?interval=month&amount=100&name=&legalName=&email=)

## OpenCollective Generous Backers

<a href="https://opencollective.com/microcks#section-contributors" target="_blank"><img src="https://opencollective.com/microcks/backers.svg?width=800"></a>
75 changes: 75 additions & 0 deletions jdk_21_maven/cs/rest-gui/microcks/BUILDING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,75 @@
# Building guide

**Want to contribute and build stuff? Great!** ✨ We try to make it easy, and all contributions, even the smaller ones, are more than welcome. This includes bug reports, fixes, documentation, examples...

First, you may need to read our [global contribution guide](https://github.com/microcks/.github/blob/master/CONTRIBUTING.md) and then to read this page.

## Reporting an issue

This project uses GitHub issues to manage the issues. Open an issue directly in GitHub.

If you believe you found a bug, and it's likely possible, please indicate a way to reproduce it, what you are seeing and what you would expect to see.
Don't forget to indicate your Java, Maven and/or Docker version.

## Setup

## Build

### Build the whole project

You need to have [Apache Maven](https://maven.apache.org) (version >= 3.5) up and running as well as a valid Java Development Kit (version >= 21) install to build the project.

```
$ git clone https://github.com/microcks/microcks.git
[...]
$ cd microcks
$ mvn clean install
[...]
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary for Microcks 1.12.0-SNAPSHOT:
[INFO]
[INFO] Microcks ........................................... SUCCESS [ 0.408 s]
[INFO] Microcks Model ..................................... SUCCESS [ 1.771 s]
[INFO] Microcks Util ...................................... SUCCESS [ 4.590 s]
[INFO] Microcks EL ........................................ SUCCESS [ 1.018 s]
[INFO] Microcks App ....................................... SUCCESS [ 40.540 s]
[INFO] Microcks Async Minion .............................. SUCCESS [ 8.425 s]
[INFO] Microcks Distros ................................... SUCCESS [ 0.034 s]
[INFO] Microcks Uber App .................................. SUCCESS [ 0.850 s]
[INFO] Microcks Uber Async Minion ......................... SUCCESS [ 3.818 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 01:01 min
[INFO] Finished at: 2025-04-07T18:07:39+02:00
[INFO] ------------------------------------------------------------------------
```

### Build and run webapp jar

For now, there's still a problem with Frontend integration tests configuration so you should disable them using the following flag:

```
$ cd webapp
$ mvn -Pprod package
[...]
$ java -jar target/microcks-x.y.z-SNAPSHOT.jar
```

### Build and run webapp Docker image

```
$ cd webapp
$ mvn -Pprod clean package && docker build -f src/main/docker/Dockerfile -t microcks/microcks-uber:nightly .
[...]
$ cd ../install/docker-compose
$ docker-compose -f docker-compose.yml up -d
```
After spinning up the containers, you will now have access to Keycloak for account management, and microcks webapp to setup mocking, etc.

You can login to keycloak on `http://localhost:18080/` with username and password `admin`.
You can login to microcks webapp with the username `admin` and password `microcks123`.

## Before you contribute

To contribute, use GitHub Pull Requests, from your **own** fork.
17 changes: 17 additions & 0 deletions jdk_21_maven/cs/rest-gui/microcks/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
# CHANGELOG

## Introduction

This file provides a high-level summary of the changes and updates made to the Microcks project.

## Releases

For a comprehensive list of changes, please visit the [official release page](https://github.com/microcks/microcks/releases)

## For More Information

For more detailed release notes, please refer to the [Microcks blog page](https://microcks.io/blog/).

## For specific changes on this repo

Refer to the [activity view](https://docs.github.com/en/repositories/viewing-activity-and-data-for-your-repository/using-the-activity-view-to-see-changes-to-a-repository) of the current repository for detailed information on all recent changes.
9 changes: 9 additions & 0 deletions jdk_21_maven/cs/rest-gui/microcks/CODEOWNERS
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# This file provides an overview of code owners in this repository.

# Each line is a file pattern followed by one or more owners.
# The last matching pattern has the most precedence.
# For more details, read the following article on GitHub: https://help.github.com/articles/about-codeowners/.

# The default owners are automatically added as reviewers when you open a pull request unless different owners are specified in the file.

* @lbroudoux @yada
Loading
Loading