FreshRSS est un agrégateur de flux RSS. Il permet de regrouper au même endroit les articles proposés en scannant périodiquement les données mises à disposition par les sites. C'est très pratique car cela évite de devoir faire cela manuellement. Mais lors du développement de la solution ou lors de tests, cette fonctionnalité devient génante car les données changent. C'est pourquoi simuler les flux RSS dans ces conditions devient nécessaire.

Pour cela, nous allons utiliser un serveur de « mocks » qui nous servira des contenus prédéfinis. Ici, nous allons utiliser WireMock mais il existe d'autres solutions disponibles.

Dans le répertoire de travail de WireMock, il faut créer les répertoires __files et mappings avec la commande suivante :

mkdir __files mappings

Le répertoire __files contiendra les fichiers de données des flux RSS tandis que le répertoire mappings contiendra les fichiers de correspondance entre les requêtes reçues et les réponses retournées.

Il existe plusieurs méthodes pour récupérer les données d'un flux RSS. Ici, nous allons utiliser wget avec la commande suivante :

# Version courte
wget https://reddit.com/r/breadit/new/.rss -O breadit.rss
 
# Version longue
wget https://reddit.com/r/breadit/new/.rss --output-document breadit.rss

• -O ou --output-document permet de nommer le fichier téléchargé.

Maintenant que nous avons nos données, il faut dire à WireMock comment les restituer. Pour cela, nous allons créer un fichier de configuration dans le répertoire mappings. Son nom n'a pas d'importance mais il doit posséder l'extension json et contenir du JSON valide. Nous allons créer le fichier breadit.json avec le contenu suivant :

{
	"request": {
		"method": "GET",
		"url": "/breadit.rss"
	},
	"response": {
		"status": 200,
		"bodyFileName": "breadit.rss",
		"headers": {
			"Content-Type": "application/rss+xml"
		}
	}
}

Ce fichier indique à WireMock de retourner le contenu du fichier précédemment téléchargé lors d'un appel GET sur l'URL définie.

Pour traiter de nombreux messages, il vaut mieux opter pour une configuration dynamique. Nous allons donc créer le fichier feed.json dans le répertoire mapping avec le contenu suivant :

{
	"request": {
		"method": "GET",
		"urlPathPattern": "/.*"
	},
	"response": {
		"status": 200,
		"bodyFileName": "{{request.pathSegments.[0]}}",
		"transformers": ["response-template"],
		"headers": {
			"Content-Type": "application/rss+xml"
		}
	}
}

Voici ce qui change par rapport à la précédente configuration :

• WireMock ne surveille pas une URL en particulier mais toutes les URLs qui ont le même format que celui décrit ¹⁾.
• Le nom du fichier à retourner est directement extrait de la requête. Il est ajouté dans le modèle de réponse.
• L'utilisation d'un système de modèle de réponse ²⁾.

# Version courte pour configuration statique
docker run -it --rm -p 9090:8080 --name wiremock --network freshrss-network -v $PWD:/home/wiremock wiremock/wiremock:latest-alpine
 
# Version longue pour configuration statique
docker run --interactive --tty --rm --publish 9090:8080 --name wiremock --network freshrss-network --volume $PWD:/home/wiremock wiremock/wiremock:latest-alpine
 
# Version courte pour configuration dynamique
docker run -it --rm -p 9090:8080 --name wiremock --network freshrss-network -v $PWD:/home/wiremock wiremock/wiremock:latest-alpine --local-response-templating
 
# Version longue pour configuration dynamique
docker run --interactive --tty --rm --publish 9090:8080 --name wiremock --network freshrss-network --volume $PWD:/home/wiremock wiremock/wiremock:latest-alpine --local-response-templating

• -i ou --interactive permet de garder l'entrée standard ouverte.
• -t ou --tty permet l'allocation d'un pseudo-TTY.
• --rm supprime automatiquement le conteneur lors de sa fermeture.
• -p ou --publish permet de lier les ports du conteneur avec ceux de l'hôte.
• --name nomme le conteneur.
• --network permet de lier le conteneur à un réseau existant.
• -v ou --volume permet de monter un répertoire local dans le conteneur.
• --local-response-templating permet d'utiliser localement l'extension ResponseTemplateTransformer qui met en forme la réponse envoyée grace à un système de modèles. ^{3) 4)}

Maintenant que notre conteneur est lancé, il est possible d'accéder aux données :

• soit depuis un autre conteneur connecté au même réseau avec l'URL http://wiremock:8080/breadit.rss ⁵⁾,
• soit depuis l'hôte avec l'URL http://localhost:9090/breadit.rss ⁶⁾.

Pour mettre à jour les configurations, il faut :

• soit redémarrer le conteneur,
• soit envoyer une requête POST à l'URL __admin/mappings/reset.

• Configuring and running WireMock in Docker | WireMock
• Docker Container with Wiremock does not refresh changes from volume - Stack Overflow
• Extending WireMock via custom code | WireMock
• Response Templating | WireMock
• Returning stubbed HTTP responses to specific requests | WireMock
• Wiremock - Mock a response body depending on a request body - R{}zky Notes
• wiremock/wiremock - Docker Image | Docker Hub