Table des matières

novatorem : Des données musicales à un widget SVG

Ce fork novatorem produit des widgets musicaux depuis des services externes. Un orchestrateur Flask gère le rendu; Spotify et Last.fm ont des modules distincts. La pochette fournit une image et des couleurs au SVG.

Application et services Fork

Mis à jour 2026-10-23
1
Python · 81.61%
Unlicense

Node.js Python Crédit amont

Code source README Markdown

Langages: 5Répartition du code
Composants documentés: 2Explorer les modules
Documents source: 1Lire les instructions

Langages du dépôtPython 81.61%5

Parts calculées à partir des octets GitHub Linguist.

Python81.61%

81.61%86 529 octets

Jinja16.06%

16.06%17 032 octets

HTML1.64%

1.64%1 741 octets

Dockerfile0.64%

0.64%677 octets

Langage	%	Octets
Python	81.61%	86 529
Jinja	16.06%	17 032
HTML	1.64%	1 741
Dockerfile	0.64%	677
Procfile	0.04%	47

GitHub README Statistiques de langages

1. Aperçu

1.1. Pourquoi il existe

Générateur dynamique mettant à jour le profil GitHub avec l'écoute Spotify en temps réel.

1.2. Cas d’usage

Personnalisation dynamique de profil GitHub via webhooks.

2. Cas d’utilisation

Service Flask qui génère une carte SVG « en écoute » depuis Spotify ou Last.fm pour un README de profil GitHub.

Acteurs à gauche (personnes) et à droite (systèmes externes) ; chaque ovale est un cas d’utilisation appuyé par les fichiers cités ci-dessous.

Afficher le titre en écoute: Propriétaire du profilAPI Web Spotify
La route générique de api/orchestrator.py lit le morceau en cours, tire les couleurs de la pochette et renvoie une carte image/svg+xml ; vercel.json y associe /api/spotify.
Personnaliser les couleurs: Propriétaire du profil
Les paramètres background_color, border_color, background_type, show_status et compact sont validés dans api/config.py avant le rendu du gabarit Jinja2 choisi dans api/templates.json.
Utiliser Last.fm comme source: Propriétaire du profilAPI Last.fm
Si seuls LAST_FM_API_KEY et LAST_FM_USERNAME sont définis, ou si l’authentification Spotify échoue, get_now_playing passe à api/lastfm.py, qui peut chercher la pochette sur Deezer.
Ouvrir le morceau en cours: Propriétaire du profilAPI Web Spotify
GET /redirect envoie le visiteur vers l’URL du morceau, ou vers le dépôt d’origine si rien ne joue.
Renouveler le jeton Spotify: Propriétaire du profilAPI Web Spotify
scripts/spotify_local_auth.py capte le code OAuth sur http://127.0.0.1:8000/callback et écrit un nouveau jeton, avec option --update-vercel pour le pousser vers Vercel.
Prévisualiser en local: Propriétaire du profil
python start.py crée .venv, installe les dépendances, lance Flask sur le port 5000 et ouvre /preview ; docker-compose.yml exécute la même application avec une vérification /health.

2.1. Scénario : Ajouter une carte Spotify à un profil GitHub

Créer une application Spotify avec l’URI de redirection http://127.0.0.1:8000/callback.
Copier .env.example vers .env et remplir SPOTIFY_CLIENT_ID et SPOTIFY_SECRET_ID.
Lancer python scripts/spotify_local_auth.py pour obtenir SPOTIFY_REFRESH_TOKEN.
Lancer python start.py et vérifier la carte sur http://127.0.0.1:5000/preview.
Déployer sur Vercel et intégrer <déploiement>/api/spotify comme image liée à /redirect dans le README du profil.

Fichiers consultésREADME.mdSetUp.md.env.exampleapi/orchestrator.pyapi/spotify.pyapi/lastfm.pyapi/config.pyapi/templates.jsonvercel.jsonstart.pydocker-compose.ymlscripts/spotify_local_auth.pyscripts/renew_spotify_token.py

3. Essayer

Adresse publiée dans le README du dépôt. La page s’ouvre dans un cadre isolé, seulement quand vous le demandez.

Ouvrir dans un nouvel onglet https://novatorem.vercel.app

4. Démarrage

Ces commandes viennent de la documentation du dépôt. Elles n’ont pas été exécutées pendant cette revue.

Commandes déclarées dans les manifestes

5. Références du dépôt

Le dépôt ne fournit pas de guide détaillé pour ces étapes. Commencez par le README et les fichiers commentés ci-dessus.

Documentation source

README.md

1 documents lus parmi 1 candidats.

6. Fonctions et composants 2

Fournisseur et présentation: api/orchestrator.py contient Flask et les fonctions de rendu. Les modules des fournisseurs sont à côté. La configuration pilote modèles et palettes, séparant l’accès propre au service de l’apparence du SVG.
Traitement de la pochette: ImageData récupère la pochette une fois par objet et réutilise les octets pour le base64 et les palettes ColorThief. load_image_with_fallback essaie l’image, un remplacement, puis des couleurs par défaut en cas d’échec.

7. Architecture

Ouvrez un composant pour suivre ses connexions, ou explorez le diagramme complet.

Composants du système Contexte

Spotify ou Last.fm
- Vers Données du fournisseur
Données du fournisseur
- Depuis Spotify ou Last.fm
- Vers Orchestrateur Flask
Orchestrateur Flask
- Depuis Données du fournisseur
- Vers Pochette et palette de repli
Pochette et palette de repli
- Depuis Orchestrateur Flask
- Vers Réponse SVG
Réponse SVG
- Depuis Pochette et palette de repli

Mermaid Diagramme interactif

Vue générale des composants et des échanges vérifiés dans le dépôt.

Vue statique de l’architecture de novatorem — Aperçu statique. Le diagramme interactif le remplace après le chargement de Mermaid.

flowchart LR
  n0["Spotify ou Last.fm"]
  n1["Données du fournisseur"]
  n2["Orchestrateur Flask"]
  n3["Pochette et palette de repli"]
  n4["Réponse SVG"]
  n0 --> n1
  n1 --> n2
  n2 --> n3
  n3 --> n4

Version texte du diagramme

Spotify ou Last.fm → Données du fournisseur
Données du fournisseur → Orchestrateur Flask
Orchestrateur Flask → Pochette et palette de repli
Pochette et palette de repli → Réponse SVG

Suivre un parcours dans le code

Suivez ImageData._fetch vers get_base64 et get_palette. Réutiliser les octets évite des téléchargements répétés dans cet objet, sans constituer un cache persistant entre requêtes.

8. Dossier technique

Établi à partir du code au commit 5496fe0 (16 fichiers). Chaque élément vient d’une correspondance de motif dans le code: ouvrez le fichier lié avant de vous y fier.

8.1. Couches et modules

Les dossiers sont classés par couche selon leur nom, de l’interface utilisateur jusqu’à l’accès aux données. Comme le classement repose sur les noms seulement, le diagramme ne dit rien des appels entre couches.

Mermaid Vue en couches

flowchart TB
  subgraph L_presentation["Présentation"]
    direction TB
    presentation_0["(root)<br/>1 fichier"]
  end
  subgraph L_interface["Points d’entrée et API"]
    direction TB
    interface_0["api<br/>6 fichiers"]
  end
  subgraph L_application["Services applicatifs"]
    direction TB
    application_0["scripts<br/>3 fichiers"]
  end
  subgraph L_core["Source principale"]
    direction TB
    core_0["(root)<br/>1 fichier"]
  end
  subgraph L_hosting["Build, CI et hébergement"]
    direction TB
    hosting_0["(root)<br/>5 fichiers"]
  end
  L_presentation ~~~ L_interface
  L_interface ~~~ L_application
  L_application ~~~ L_core
  L_core ~~~ L_hosting

Modules et couche principale
Module	Couche	Fichiers	Types	Extensions
`api`	Points d’entrée et API	6	18	.py
`scripts`	Services applicatifs	3	1	.py
`(root)`	Présentation	2	0	.html .py

8.2. Modèle C4

Du contexte du système aux déclarations du code. Chaque niveau conserve les limites des sources disponibles.

UML 1 · Contexte du système

La vue C4 la plus large : qui utilise le projet et sur quels systèmes et stockages externes il s’appuie. Rendu avec uml-mcp.

Source PlantUML

@startuml
!include <C4/C4_Context>
LAYOUT_LEFT_RIGHT()
Person(P_http, "Client HTTP")
Person(P_cli, "Utilisateur CLI")
System(SYS, "novatorem", "Ce fork novatorem produit des widgets musicaux depuis des services ex…")
System_Ext(E0, "Spotify Web API")
Rel(P_http, SYS, "Utilise")
Rel(P_cli, SYS, "Utilise")
Rel(SYS, E0, "Appelle")
@enduml

UML 2 · Conteneurs

Un niveau plus près : les parties qui s’exécutent séparément dans le projet, leur langage principal et le chemin des appels entre elles. Rendu avec uml-mcp.

Source PlantUML

@startuml
!include <C4/C4_Container>
LAYOUT_LEFT_RIGHT()
Person(P_http, "Client HTTP")
Person(P_cli, "Utilisateur CLI")
System_Boundary(SYS, "novatorem") {
  Container(C0, "now-playing", "Docker")
}
System_Ext(E0, "Spotify Web API")
Rel(P_http, C0, "Utilise")
Rel(P_cli, C0, "Utilise")
Rel(C0, E0, "Appelle")
@enduml

UML 3 · Composants et couches

Modules regroupés par couche du code. Les limites indiquent l’organisation, sans affirmer une isolation à l’exécution ni des appels. Rendu avec uml-mcp.

Source PlantUML

@startuml
!include <C4/C4_Component>
LAYOUT_TOP_DOWN()
System_Boundary(SYS, "novatorem") {
Boundary(L0, "Présentation", "layer") {
Component(M0_0, "(root)", "HTML", "1 fichiers")
}
Boundary(L1, "Points d’entrée et API", "layer") {
Component(M1_0, "api", "Python", "6 fichiers")
}
Boundary(L2, "Services applicatifs", "layer") {
Component(M2_0, "scripts", "Python", "3 fichiers")
}
Boundary(L3, "Source principale", "layer") {
Component(M3_0, "(root)", "Python", "1 fichiers")
}
Boundary(L4, "Build, CI et hébergement", "layer") {
Component(M4_0, "(root)", ".json, Dockerfile, Procfile", "5 fichiers")
}
}
@enduml

UML 4 · Code

Déclarations, champs et méthodes sélectionnés, regroupés par fichier source. Aucun héritage ni appel n’est déduit. Rendu avec uml-mcp.

Source PlantUML

@startuml
skinparam backgroundColor transparent
skinparam shadowing false
skinparam roundCorner 10
skinparam defaultFontName Arial
skinparam defaultFontSize 13
skinparam ArrowColor #4e6070
skinparam ArrowFontColor #3d4f5f
skinparam titleFontSize 14
skinparam actorBorderColor #006a62
skinparam actorBackgroundColor #e9f3f4
skinparam usecaseBorderColor #006a62
skinparam usecaseBackgroundColor #e9f3f4
skinparam componentBorderColor #006a62
skinparam componentBackgroundColor #e9f3f4
skinparam interfaceBorderColor #006a62
skinparam interfaceBackgroundColor #ffffff
skinparam nodeBorderColor #4e6070
skinparam nodeBackgroundColor #f4f8fb
skinparam databaseBorderColor #006a62
skinparam databaseBackgroundColor #ffffff
skinparam cloudBorderColor #4e6070
skinparam cloudBackgroundColor #f0f5fa
skinparam artifactBorderColor #006a62
skinparam artifactBackgroundColor #ffffff
skinparam rectangleBorderColor #b0c2d3
skinparam activityBorderColor #006a62
skinparam activityBackgroundColor #e9f3f4
skinparam partitionBorderColor #b0c2d3
skinparam stereotypeCBackgroundColor #ffffff
top to bottom direction
hide empty members
package "novatorem" {
package "api/orchestrator.py" as F0 {
class "ImageData" as T0_0 {
  _fetch()
  get_base64()
  get_palette()
  bar_palette()
  song_palette()
}
}
package "api/config.py" as F1 {
class "CompactSVGConfig" as T1_0 {
  width
  height
  album_art_size
  border_radius
  widget_padding_top
  widget_padding_right
  widget_padding_bottom
  widget_padding_left
}
class "SVGConfig" as T1_1 {
  width
  height
  album_art_size
  border_radius
  widget_padding_top
  widget_padding_right
  widget_padding_bottom
  widget_padding_left
}
class "SpotifyConfig" as T1_2 {
  client_id
  client_secret
  refresh_token
  token_url
  now_playing_url
  recently_played_url
}
class "LastFmConfig" as T1_3 {
  api_key
  username
  api_url
  deezer_search_url
  placeholder_hash
}
class "TemplateConfig" as T1_4 {
  config_path
  fallback_theme
  default_theme
}
}
package "api/spotify.py" as F2 {
class "TrackInfo" as T2_0 {
  is_playing
  track_name
  artist_name
  album_name
  album_art_url
  track_url
  artist_url
  track_id
}
class "AudioFeatures" as T2_1 {
  tempo
  energy
  danceability
  valence
  loudness
}
}
package "api/lastfm.py" as F3 {
class "TrackInfo" as T3_0 {
  is_playing
  track_name
  artist_name
  album_name
  album_art_url
  track_url
  artist_url
}
}
}
@enduml

8.3. Interface publique

Du code extérieur peut utiliser tout ce qui est listé ici. Le projet déclare aussi 19 types publics.

UML Cas d’utilisation

Chaque acteur est un type d’appelant, relié à ce qu’il peut demander au projet. Rendu avec uml-mcp.

Source PlantUML

@startuml
skinparam backgroundColor transparent
skinparam shadowing false
skinparam roundCorner 10
skinparam defaultFontName Arial
skinparam defaultFontSize 13
skinparam ArrowColor #4e6070
skinparam ArrowFontColor #3d4f5f
skinparam titleFontSize 14
skinparam actorBorderColor #006a62
skinparam actorBackgroundColor #e9f3f4
skinparam usecaseBorderColor #006a62
skinparam usecaseBackgroundColor #e9f3f4
skinparam componentBorderColor #006a62
skinparam componentBackgroundColor #e9f3f4
skinparam interfaceBorderColor #006a62
skinparam interfaceBackgroundColor #ffffff
skinparam nodeBorderColor #4e6070
skinparam nodeBackgroundColor #f4f8fb
skinparam databaseBorderColor #006a62
skinparam databaseBackgroundColor #ffffff
skinparam cloudBorderColor #4e6070
skinparam cloudBackgroundColor #f0f5fa
skinparam artifactBorderColor #006a62
skinparam artifactBackgroundColor #ffffff
skinparam rectangleBorderColor #b0c2d3
skinparam activityBorderColor #006a62
skinparam activityBackgroundColor #e9f3f4
skinparam partitionBorderColor #b0c2d3
skinparam stereotypeCBackgroundColor #ffffff
left to right direction
actor "Client HTTP" as A_http
actor "Utilisateur CLI" as A_cli
rectangle "novatorem" {
  usecase "ANY /" as U0
  usecase "ANY /'path:path'" as U1
  usecase "ANY /with_parameters" as U2
  usecase "ANY /preview" as U3
  usecase "ANY /redirect" as U4
  usecase "ANY /health" as U5
  usecase "Lancer l'outil (12 options)" as U6
}
A_http --> U0
A_http --> U1
A_http --> U2
A_http --> U3
A_http --> U4
A_http --> U5
A_cli --> U6
@enduml

Routes HTTP 6

Mermaid Carte des routes par préfixe

flowchart LR
  api(["HTTP API"])
  g0["/"]
  api --> g0
  g0r0["ANY /"]
  g0 --> g0r0
  g1["/'path:path'"]
  api --> g1
  g1r0["ANY /'path:path'"]
  g1 --> g1r0
  g2["/health"]
  api --> g2
  g2r0["ANY /health"]
  g2 --> g2r0
  g3["/preview"]
  api --> g3
  g3r0["ANY /preview"]
  g3 --> g3r0
  g4["/redirect"]
  api --> g4
  g4r0["ANY /redirect"]
  g4 --> g4r0
  g5["/with_parameters"]
  api --> g5
  g5r0["ANY /with_parameters"]
  g5 --> g5r0

Méthode	Chemin	Source
ANY	`/`	`api/orchestrator.py:660`
ANY	`/<path:path>`	`api/orchestrator.py:661`
ANY	`/with_parameters`	`api/orchestrator.py:662`
ANY	`/preview`	`api/orchestrator.py:693`
ANY	`/redirect`	`api/orchestrator.py:710`
ANY	`/health` exploitation	`api/orchestrator.py:729`

Les routes marquées exploitation exposent la santé, l’état ou l’administration; restreignez-les en production.

Ligne de commande 12

8.4. Interface privée

Ces noms sont internes selon les conventions du langage: tiret bas initial, private, static ou pub(crate).

Assistant préfixé _: 15

_get_spotify_data api/lastfm.py:43
_fetch_album_art_from_deezer api/lastfm.py:112
_api_get api/lastfm.py:170

8.5. Services

Service 1

SpotifyTokenManager_get_auth_header, _refresh_token, get_token et 1 autres

Gestionnaire 1

Handlerdo_GET, log_message

8.6. Entités et modèle de données 8

Mermaid Diagramme de classes des entités

classDiagram
  direction LR
  class E0["CompactSVGConfig"] {
    +int width
    +int height
    +int album_art_size
    +int border_radius
    +int widget_padding_top
    +int widget_padding_right
  }
  class E1["SVGConfig"] {
    +int width
    +int height
    +int album_art_size
    +int border_radius
    +int widget_padding_top
    +int widget_padding_right
  }
  class E2["TrackInfo"] {
    +bool is_playing
    +str track_name
    +str artist_name
    +str album_name
    +str album_art_url
    +str track_url
  }
  class E3["SpotifyConfig"] {
    +str client_id
    +str client_secret
    +str refresh_token
    +str token_url
    +str now_playing_url
    +str recently_played_url
  }
  class E4["AudioFeatures"] {
    +float tempo
    +float energy
    +float danceability
    +float valence
    +float loudness
  }
  class E5["LastFmConfig"] {
    +str api_key
    +str username
    +str api_url
    +str deezer_search_url
    +str placeholder_hash
  }
  class E6["TemplateConfig"] {
    +str config_path
    +str fallback_theme
    +str default_theme
  }

Une flèche relie un champ à l’entité que son type nomme.

Entité	Nature	Premiers champs
`CompactSVGConfig`	Dataclass	`width, height, album_art_size, border_radius, widget_padding_top, widget_padding_right, widget_padding_bottom, widget_padding_left`
`SVGConfig`	Dataclass	`width, height, album_art_size, border_radius, widget_padding_top, widget_padding_right, widget_padding_bottom, widget_padding_left`
`TrackInfo`	Dataclass	`is_playing, track_name, artist_name, album_name, album_art_url, track_url, artist_url, track_id`
`TrackInfo`	Dataclass	`is_playing, track_name, artist_name, album_name, album_art_url, track_url, artist_url`
`SpotifyConfig`	Dataclass	`client_id, client_secret, refresh_token, token_url, now_playing_url, recently_played_url`
`AudioFeatures`	Dataclass	`tempo, energy, danceability, valence, loudness`
`LastFmConfig`	Dataclass	`api_key, username, api_url, deezer_search_url, placeholder_hash`
`TemplateConfig`	Dataclass	`config_path, fallback_theme, default_theme`

8.7. Logique métier

Une fois écartés le code d’interface et les services et entités ci-dessus, ces classes ont le plus de méthodes.

ImageData Points d’entrée et API, 5 méthodes: _fetch, get_base64, get_palette, bar_palette, song_palette

8.8. Intégrations externes

Spotify Web API données

Clients HTTP

requests urllib

Hôtes nommés dans le code

accounts.spotify.com 3 fichiers api/config.py:34
api.spotify.com 3 fichiers api/config.py:35
api.deezer.com 1 fichiers api/config.py:52
open.spotify.com 1 fichiers api/lastfm.py:66
picsum.photos 1 fichiers api/config.py:235
ws.audioscrobbler.com 1 fichiers api/config.py:51
www.last.fm 1 fichiers api/lastfm.py:313

8.9. Stack et dépendances

Node.js package.json

node 24.x

Ouvrir le manifeste

Python requirements.txt 13 à l’exécution

Ouvrir le manifeste

Dépendances externes

13 paquets déclarés (13 à l’exécution, 0 pour le développement) dans package.json, requirements.txt.

Tableau des paquets 13

Dépendances externes
Paquet	Version	Usage	Rôle	Registre
`Flask`	`>=3.0.0,<4.0.0`	exécution	Cadriciel web	pypi.org
`Werkzeug`	`>=3.0.0,<4.0.0`	exécution	The comprehensive WSGI web application library.	pypi.org
`Jinja2`	`>=3.1.0,<4.0.0`	exécution	Gabarits	pypi.org
`gunicorn`	`>=21.0.0,<23.0.0`	exécution	Serveur d’application	pypi.org
`requests`	`>=2.31.0,<3.0.0`	exécution	Client HTTP	pypi.org
`urllib3`	`>=2.0.0,<3.0.0`	exécution	Client HTTP	pypi.org
`certifi`	`>=2023.0.0`	exécution	Python package for providing Mozilla's CA Bundle.	pypi.org
`python-dotenv`	`>=1.0.0,<2.0.0`	exécution	Configuration	pypi.org
`colorthief`	`>=0.2.1,<1.0.0`	exécution	A module for grabbing the color palette from an image.	pypi.org
`Pillow`	`>=10.0.0,<11.0.0`	exécution	Graphisme, image et 3D	pypi.org
`click`	`>=8.1.0,<9.0.0`	exécution	Ligne de commande	pypi.org
`itsdangerous`	`>=2.1.0,<3.0.0`	exécution	Safely pass data to untrusted environments and back.	pypi.org
`MarkupSafe`	`>=2.1.0,<3.0.0`	exécution	Safely add untrusted strings to HTML/XML markup.	pypi.org

8.10. Pipeline CI/CD

Aucun pipeline CI/CD dans le dépôt. Le code se construit et se lance à la main, comme décrit plus haut.

8.11. Déploiement

Mermaid Schéma de déploiement

flowchart LR
  repo[("Dépôt GitHub")]
  image["Image Docker<br/>FROM python:3.12-slim"]
  host_Vercel("Vercel<br/>vercel.json")
  subgraph compose["Docker Compose"]
    svc_now_playing["now-playing"]
  end
  repo -->|"docker build"| image
  repo -.->|"configuré"| host_Vercel
  image -->|"docker compose up"| compose

UML Déploiement

Le nœud extérieur est l’endroit où le code s’exécute. Chaque image de base pointe vers ce qu’elle construit, les flèches pleines mènent aux bases de données et les pointillées aux services externes. Rendu avec uml-mcp.

Source PlantUML

@startuml
skinparam backgroundColor transparent
skinparam shadowing false
skinparam roundCorner 10
skinparam defaultFontName Arial
skinparam defaultFontSize 13
skinparam ArrowColor #4e6070
skinparam ArrowFontColor #3d4f5f
skinparam titleFontSize 14
skinparam actorBorderColor #006a62
skinparam actorBackgroundColor #e9f3f4
skinparam usecaseBorderColor #006a62
skinparam usecaseBackgroundColor #e9f3f4
skinparam componentBorderColor #006a62
skinparam componentBackgroundColor #e9f3f4
skinparam interfaceBorderColor #006a62
skinparam interfaceBackgroundColor #ffffff
skinparam nodeBorderColor #4e6070
skinparam nodeBackgroundColor #f4f8fb
skinparam databaseBorderColor #006a62
skinparam databaseBackgroundColor #ffffff
skinparam cloudBorderColor #4e6070
skinparam cloudBackgroundColor #f0f5fa
skinparam artifactBorderColor #006a62
skinparam artifactBackgroundColor #ffffff
skinparam rectangleBorderColor #b0c2d3
skinparam activityBorderColor #006a62
skinparam activityBackgroundColor #e9f3f4
skinparam partitionBorderColor #b0c2d3
skinparam stereotypeCBackgroundColor #ffffff
node "Docker Compose" as H {
  node "now-playing" as N0 <<container>>
}
artifact "FROM python:3.12-slim" as IMG0
IMG0 ..> N0 : construit
cloud "Vercel" as X0
X0 ..> N0
cloud "Spotify Web API" as E0
N0 ..> E0
@enduml

Où il s’exécute

Services Compose

now-playing

Images Docker de base

python:3.12-slim

8.12. Supervision

Ce que le code consigne, mesure et expose pour savoir s’il fonctionne.

Routes de santé et de métriques

ANY /health

Vérifications de santé des conteneurs

8.13. Sécurité

Contrôles

Authentification Bearer

Chaîne d’approvisionnement

Exemple de fichier d’environnement (sans valeurs)

Variables d’environnement 7

La page reprend les noms sans leurs valeurs et souligne ceux qui ressemblent à des secrets.

SPOTIFY_SECRET_ID LAST_FM_API_KEY SPOTIFY_REFRESH_TOKEN PORT SPOTIFY_CLIENT_ID LAST_FM_USERNAME SPOTIFY_REDIRECT_URI

Rien trouvé pour: Base de données, Tests automatisés.

9. Types et structure des fichiers

19 types déclarés, dont 12 dans l’aperçu des relations de base.

Diagramme des types

classDiagram
direction TB
class t7697cb5ba057["TrackInfo"] {
}
class tce9a5c3a3832["ImageData"] {
  __init__()
  _fetch()
  get_base64()
  get_palette()
}
class t576319e97c4e["TrackInfo"] {
}
class tc5e631da8d1c["AudioFeatures"] {
  beat_duration_ms()
  to_dict()
}
class t4be5079b8ec0["SpotifyTokenManager"] {
  __init__()
  _get_auth_header()
  _refresh_token()
  get_token()
}
class t58ad657833a8["SpotifyConfig"] {
  is_configured()
}
class tcb0edfe91d38["LastFmConfig"] {
  is_configured()
}
class t3c92c85d61ad["SVGConfig"] {
}
class te1c73c384f8d["CompactSVGConfig"] {
}
class t9f095ad5e068["TemplateConfig"] {
}
class t97dfb1fa9ef2["MusicWidgetError"] {
  __init__()
}
class t7be6e7ad4bde["ConfigurationError"] {
  __init__()
}
class b8564c6f24b53["Exception"] {
  <<unresolved_base>>
}
b8564c6f24b53 <|-- t97dfb1fa9ef2
t97dfb1fa9ef2 <|-- t7be6e7ad4bde

Les bases non résolues restent identifiées; les signatures complètes ne sont pas reconstruites.

10. Référence

14 / 14 fichiers admissibles lus (29 dans l’arbre); 0 trop volumineux, 0 échec de lecture et 0 diagnostic de syntaxe.

Ce que couvre l’analyse

Les dossiers connus de dépendances et de compilation, les fichiers d’identifiants et les binaires sont exclus. La collecte couvre les README, les manifestes reconnus et les fichiers source pris en charge.

Les statistiques Linguist couvrent l’ensemble du dépôt et peuvent inclure d’autres langages.

12. Fichiers à lire 3

13. Glossaire

Dépôt

Les fichiers source, la configuration et l’historique versionné d’un projet.

README

Le document d’entrée du dépôt, qui présente généralement son rôle et son installation.

Dépendance

Une bibliothèque, un outil ou un service nécessaire à la compilation ou à l’exécution d’un composant.

API

Une interface par laquelle des composants logiciels échangent des requêtes et des résultats. Une API n’utilise pas nécessairement HTTP.

Conteneur

Un environnement de processus isolé créé à partir d’une image. Les données persistantes nécessitent un stockage hors de son système de fichiers temporaire.

Volume et montage de dossier

Un volume est un stockage géré par la plateforme de conteneurs ; un montage de dossier expose un chemin de l’hôte dans un conteneur.

Port publié

Un port de l’hôte associé au port d’un service dans un conteneur. Sa publication peut rendre le service accessible hors du réseau des conteneurs.

Compilation

Les étapes qui transforment les sources et dépendances en programme exécutable ou en livrable distribuable.

GPU

Un processeur conçu pour les calculs parallèles, dont le rendu graphique et de nombreuses opérations numériques.

Fork

Un dépôt distinct dérivé d’un autre projet. Une modification du fork ne devient pas automatiquement une modification du projet amont.

14. Références

antoinebou12. (2026, 5 novembre). novatorem. [Software repository] github.com.
antoinebou12. (2026, 5 novembre). novatorem: README. [Repository documentation] github.com.
antoinebou12. (2026, 5 novembre). api/orchestrator.py. [Source file] github.com.
antoinebou12. (2026, 5 novembre). api/spotify.py. [Source file] github.com.
antoinebou12. (2026, 5 novembre). api/lastfm.py. [Source file] github.com.
Boucher, A. (2026, 23 octobre). novatorem : Des données musicales à un widget SVG. [Project article] antoineboucher.info.

Les sources sans date de publication indiquent la date de leur dernière vérification, le 5 novembre 2026. Les liens des fichiers conservent la révision inspectée lorsqu’elle est disponible.