{"id":14541,"date":"2024-05-06T11:07:39","date_gmt":"2024-05-06T09:07:39","guid":{"rendered":"https:\/\/blog.ouidou.fr\/?p=14541"},"modified":"2024-09-20T10:08:00","modified_gmt":"2024-09-20T08:08:00","slug":"bolinette-le-framework-python-multifonction","status":"publish","type":"post","link":"https:\/\/ouidou.fr\/blog\/articles-techniques\/bolinette-le-framework-python-multifonction","title":{"rendered":"Bolinette, le framework Python multifonction"},"content":{"rendered":"\n<p class=\"has-text-color has-link-color wp-elements-1 wp-block-paragraph\" style=\"color:#0000008c\"><em>\u00c9crit par Pierre Chat <\/em><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Depuis quelques ann\u00e9es, je poursuis un projet personnel, d\u00e9velopper un framework en Python. Un framework de quoi ? Bonne question !<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><a href=\"#le-c%C5%93ur-de-bolinette\"><\/a>Le c\u0153ur de Bolinette<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Le package principal du framework, sobrement baptis\u00e9&nbsp;<code>core<\/code>&nbsp;contient plusieurs \u00e9l\u00e9ments:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Un syst\u00e8me d&rsquo;injection de d\u00e9pendances<\/li>\n\n\n\n<li>Un mapper d&rsquo;objet pour cloner et transformer des instances de classes ou convertir en types Python primitifs<\/li>\n\n\n\n<li>Une gestion des fichiers d&rsquo;environnement \u00e9crits en YAML<\/li>\n\n\n\n<li>Un CLI facile \u00e0 utiliser<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\"><a href=\"#base-de-donn%C3%A9es-et-orm\"><\/a>Base de donn\u00e9es et ORM<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Le second package de Bolinette <strong>s&rsquo;appelle\u00a0<code>data<\/code><\/strong>. Il s&rsquo;agit d&rsquo;un wrapper de SQLAlchemy avec quelques ajouts qui int\u00e8grent l&rsquo;ORM en respectant la syntaxe du package\u00a0<code>core<\/code>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><a href=\"#endpoints-web-et-sockets\"><\/a>Endpoints web et sockets<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Le troisi\u00e8me package est\u00a0<code>web<\/code>. Il <strong>permet de cr\u00e9er des API <\/strong>web en mappant les endpoints \u00e0 des fonctions. En s&rsquo;appuyant sur <strong>le mapper du package\u00a0<code>core<\/code><\/strong>, il permet de recevoir directement en entr\u00e9e du contr\u00f4leur des instance de classes, plut\u00f4t que des types JSON primitifs (<code>list<\/code>,\u00a0<code>dict<\/code>,\u00a0<code>int<\/code>, etc.)<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><a href=\"#open-source-software\"><\/a>Open Source Software<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Bolinette est publi\u00e9 sous licence MIT. Pour l&rsquo;instant, les contributions ne sont pas accept\u00e9es, j&rsquo;estime que le projet n&rsquo;est pas pr\u00eat. Mais il est disponible \u00e0 l&rsquo;utilisation sur\u00a0<a href=\"https:\/\/github.com\/bolinette\/bolinette\" target=\"_blank\" rel=\"noreferrer noopener\">GitHub<\/a>\u00a0et le d\u00e9p\u00f4t\u00a0<a href=\"https:\/\/pypi.org\/project\/bolinette\/\" target=\"_blank\" rel=\"noreferrer noopener\">PyPI<\/a>\u00a0d\u00e8s maintenant !<\/p>\n\n\n\n<h1 class=\"wp-block-heading\"><a href=\"#bolinettecore\"><\/a><code>bolinette.core<\/code><\/h1>\n\n\n\n<h2 class=\"wp-block-heading\"><a href=\"#injection-de-d%C3%A9pendances\"><\/a>Injection de d\u00e9pendances<\/h2>\n\n\n\n<pre id=\"code-50\" class=\"wp-block-code\"><code>from bolinette.core.injection import Injection\n\nclass Service:\n  def hello() -&gt; str:\n    return \"hello\"\n\ninject = Injection()\ninject.add(Service, \"singleton\")\n\nservice = inject.require(Service)\nassert service.hello() == \"hello\"<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Voici l&rsquo;example le plus simple. On cr\u00e9e un service, on l&rsquo;ajoute au registre de l&rsquo;injection et, plus tard, on demande une instance. Il faut aussi pr\u00e9ciser la strat\u00e9gie d&rsquo;injection:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>singleton<\/code>: une seule instance est maintenue et donn\u00e9e \u00e0 chaque&nbsp;<code>require<\/code>.<\/li>\n\n\n\n<li><code>transcient<\/code>: une nouvelle instance est cr\u00e9\u00e9e \u00e0 chaque&nbsp;<code>require<\/code>.<\/li>\n\n\n\n<li><code>scoped<\/code>: cette strat\u00e9gie n&rsquo;est disponible qu&rsquo;en mode&nbsp;<code>Scoped<\/code>, voir plus tard.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Le <strong>syst\u00e8me d&rsquo;injection de Bolinette s&rsquo;appuie sur le typage optionnel de Python<\/strong>, que le framework rend obligatoire. Les d\u00e9pendances de la m\u00e9thode\u00a0<code>__init__<\/code>\u00a0d&rsquo;un service sont r\u00e9solues avec les services renseign\u00e9s dans le contexte d&rsquo;injection.<\/p>\n\n\n\n<pre id=\"code-51\" class=\"wp-block-code\"><code>from bolinette.core.injection import Injection\n\nclass Service:\n  def hello() -&gt; str:\n    return \"hello\"\n\nclass Controller:\n  def __init__(self, service: Service) -&gt; None:\n    self._service = service\n\n  def get_hello(self) -&gt; str:\n    return self._service.hello()\n\ndef say_hello(ctrl: Controller) -&gt; str:\n  return ctrl.get_hello()\n\ninject = Injection()\ninject.add(Service, \"singleton\")\ninject.add(Controller, \"singleton\")\n\nctrl = inject.require(Controller)\nassert ctrl.get_hello() == \"hello\"\nassert inject.call(say_hello) == \"hello\"<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Dans ces exemples, le service <strong>d&rsquo;injection est cr\u00e9\u00e9 manuellement<\/strong>, mais dans un contexte r\u00e9el d&rsquo;utilisation du framework (commandes CLI, endpoint API, etc.) tout est transparent. Les services injectables sont d\u00e9clar\u00e9s \u00e0 l&rsquo;aide de d\u00e9corateurs.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">L&rsquo;instantiation des d\u00e9pendances ne se fait que lors du premier acc\u00e8s. En attendant, l&rsquo;attribut qui contient le service <strong>est un proxy qui attend d&rsquo;\u00eatre instanci\u00e9<\/strong>. Dans l&rsquo;example, tant que\u00a0<code>self._service.hello()<\/code>\u00a0n&rsquo;est pas appel\u00e9,\u00a0<code>self._service<\/code>\u00a0n&rsquo;est pas instanci\u00e9.<\/p>\n\n\n\n<pre id=\"code-52\" class=\"wp-block-code\"><code>from bolinette.core.injection import injectable\n\n@injectable(\"singleton\")\nclass Service:\n  def hello() -&gt; str:\n    return \"hello\"\n\n# Nous verrons plus tard comment utiliser les commandes.\ndef cmd(service: Service) -&gt; None:\n  assert service.hello() == \"hello\"<\/code><\/pre>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\">\u26a0\ufe0f Les services inject\u00e9s dans la m\u00e9thode\u00a0<code>__init__<\/code>\u00a0ne peuvent pas \u00eatre utilis\u00e9s <strong>dans cette m\u00eame m\u00e9thode,<\/strong> une erreur d&rsquo;acc\u00e8s sera lev\u00e9e. Cela permet de pouvoir injecter des services en d\u00e9pendance circulaire. Utilisez les m\u00e9thodes d&rsquo;initialisation pour faire des traitements \u00e0 l&rsquo;instanciation.<\/p>\n<\/blockquote>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"#m%C3%A9thodes-dinitialisation\"><\/a>M\u00e9thodes d&rsquo;initialisation<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Ces m\u00e9thodes sont appel\u00e9es d\u00e8s la sortie de la m\u00e9thode&nbsp;<code>__init__<\/code>&nbsp;lors de l&rsquo;instanciation d&rsquo;un service. Elles sont appel\u00e9es dans l&rsquo;ordre de d\u00e9claration, en comman\u00e7ant par les classes parentes, elles-m\u00eames dans l&rsquo;ordre.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Le d\u00e9corateur&nbsp;<code>@init_method<\/code>&nbsp;permet de d\u00e9clarer une m\u00e9thode en tant que m\u00e9thode d&rsquo;initialisation.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Une m\u00e9thode d&rsquo;initialisation peut demander des services dans sa signature. Cela permet de demander un service seulement utile pour cette m\u00e9thode et ne pas le stocker en variable d&rsquo;instance dans l&rsquo;<code>__init__<\/code>.<\/p>\n\n\n\n<pre id=\"code-53\" class=\"wp-block-code\"><code>from bolinette.core.injection import injectable, init_method\n\nfrom my_app.services import AuthService, CredentialsService\n\n@injectable(\"scoped\")\nclass BusinessService():\n  def __init__(self, auth: AuthService) -&gt; None:\n    self.auth_service = auth\n\n  @init_method\n  def _init_service(self, creds: CredentialsService) -&gt; None:\n    self.auth_service.set_credentials(creds.get_credentials())\n\n  async def process(self) -&gt; None:\n    await self.auth_service.login()\n    do_stuff()\n    await self.auth_service.logout()<\/code><\/pre>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\">\u26a0\ufe0f Les d\u00e9pendances circulaires ne sont pas autoris\u00e9es dans les m\u00e9thodes d&rsquo;initialisation. Si un cycle d&rsquo;appel est d\u00e9tect\u00e9, une erreur sera lev\u00e9e.<\/p>\n<\/blockquote>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\">\u26a0\ufe0f Le syst\u00e8me d&rsquo;injection ne supporte pas les m\u00e9thodes d&rsquo;initialisation asynchrones. Veuillez utiliser un&nbsp;<em>context manager<\/em>&nbsp;asynchrone en mode scop\u00e9 (cf. plus bas), ou une fonction de d\u00e9marrage (cf. plus bas).<\/p>\n<\/blockquote>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"#injection-en-scope\"><\/a>Injection en scope<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Certains services doivent avoir une dur\u00e9e de vie, comme une transaction de base de donn\u00e9es par exemple. Pour cela, il existe une version d&rsquo;injection \u00e0 dur\u00e9e de vie limit\u00e9e.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Un service peut \u00eatre d\u00e9clar\u00e9 comme&nbsp;<code>scoped<\/code>, un mode qui est r\u00e9serv\u00e9 \u00e0 l&rsquo;injection scop\u00e9e. Si un service&nbsp;<code>singleton<\/code>&nbsp;ou&nbsp;<code>transcient<\/code>&nbsp;requiert un service&nbsp;<code>scoped<\/code>, une erreur est lev\u00e9e. Les instances&nbsp;<code>scoped<\/code>&nbsp;existent seulement le temps de vie de l&rsquo;injection et ne sont pas r\u00e9utilis\u00e9es lors d&rsquo;une prochaine scope.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Dans un contexte de production, en mode commande ou API web, une scope est automatiquement cr\u00e9\u00e9e avant de donner la main au code de l&rsquo;utilisateur.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Il existe deux types d&rsquo;injections scop\u00e9es: synchrone et asynchrone. Les sessions asynchrones permettent d&rsquo;utiliser des&nbsp;<em>context managers<\/em>&nbsp;asynchrones, mais les m\u00e9thodes d&rsquo;initialisation asynchrones ne sont pas permises.<\/p>\n\n\n\n<pre id=\"code-54\" class=\"wp-block-code\"><code>from bolinette.core.injection import injectable, Injection\n\nGLOBAL = {\"count\": 0}\n\n@injectable(\"scoped\")\nclass ScopedService:\n  def __init__(self) -&gt; None:\n    GLOBAL&#91;\"count\"] += 1\n\nasync def cmd(inject: Injection) -&gt; None:\n  with inject.get_scoped_session() as sub_inject:\n    sub_inject.require(ScopedService)\n  async with inject.get_async_scoped_session() as asub_inject:\n    asub_inject.require(ScopedService)\n  assert GLOBAL&#91;\"count\"] == 2  # Le service a \u00e9t\u00e9 instanci\u00e9 deux fois<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"#context-manager\"><\/a><em>Context manager<\/em><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">L&rsquo;injection supporte des instances qui impl\u00e9mentent l&rsquo;API&nbsp;<em>context manager<\/em>&nbsp;de Python, \u00e0 savoir \u00eatre utilis\u00e9es avec la syntaxte&nbsp;<code>with ... as ...:<\/code>. Les deux m\u00e9thodes \u00e0 impl\u00e9menter, pour un contexte synchrone, sont:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>def __enter__(self) -&gt; Self:<\/code><\/li>\n\n\n\n<li><code>def __exit__(self, *args: tuple[type[BaseException], Exception, TracebackType] | tuple[None, None, None]) -&gt; Self:<\/code><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Et pour un contexte asynchrone:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>async def __aenter__(self) -&gt; Self:<\/code><\/li>\n\n\n\n<li><code>async def __aexit__(self, *args: tuple[type[BaseException], Exception, TracebackType] | tuple[None, None, None]) -&gt; Self:<\/code><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Les contextes asynchrones sont seulement disponibles en mode&nbsp;<code>scoped<\/code>, avec une session d&rsquo;injection asynchrone.<\/p>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\">\u26a0\ufe0f WIP: la m\u00e9thode&nbsp;<code>__aenter__<\/code>&nbsp;n&rsquo;est pas encore support\u00e9e.<\/p>\n<\/blockquote>\n\n\n\n<pre id=\"code-55\" class=\"wp-block-code\"><code>from typing import Self\n\nfrom bolinette.core.injection import injectable, Injection\n\n@injectable(\"singleton\")\nclass SyncService:\n  def __enter__(self) -&gt; Self:\n    print(\"enter sync\")\n\n  def __exit__(self, *args: tuple&#91;type&#91;BaseException], Exception, TracebackType] | tuple&#91;None, None, None]) -&gt; Self:\n    print(\"exit sync\")\n\n@injectable(\"scoped\")\nclass AsyncService:\n  async def __aenter__(self) -&gt; Self:\n    print(\"enter async\")\n\n  async def __aexit__(self, *args: tuple&#91;type&#91;BaseException], Exception, TracebackType] | tuple&#91;None, None, None]) -&gt; Self:\n    print(\"exit async\")\n\nasync def cmd() -&gt; None:\n  with Injection() as inject:\n    inject.require(SyncService)\n    async with inject.get_async_scoped_session() as async_scope:\n      async_scope.require(AsyncService)\n# stdout:\n# enter sync\n# exit async\n# exit sync<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\"><a href=\"#environnement\"><\/a>Environnement<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Bolinette permet de charger des fichiers de configuration YAML en fonction de l&rsquo;environnement activ\u00e9. Diff\u00e9rents fichiers sont charg\u00e9s et les cl\u00e9s sont \u00e9cras\u00e9es pour permettre des configurations communes \u00e0 plusieurs environnements. L&rsquo;ordre de chargement est le suivant:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>env.yaml<\/li>\n\n\n\n<li>env.[profil].yaml<\/li>\n\n\n\n<li>env.local.[profil].yaml<\/li>\n\n\n\n<li>les variables d&rsquo;environnement qui commancent par&nbsp;<code>\"BLNT_\"<\/code><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Par d\u00e9faut, ces fichiers se trouvent dans le sous-dossier&nbsp;<code>env<\/code>, relatif au dossier courant d&rsquo;ex\u00e9cution.<\/p>\n\n\n\n<pre id=\"code-56\" class=\"wp-block-code\"><code># env\/env.yaml\napi:\n  name: Test\n  url: test.example\n  params:\n    - 24\n    - 478\nbd:\n  url: bd.example:1234\n  user: test\n  password: test<\/code><\/pre>\n\n\n\n<pre id=\"code-57\" class=\"wp-block-code\"><code># script\nfrom bolinette.core.environment import Environment\n\ndef cmd(env: Environment) -&gt; None:\n  assert env.config&#91;\"api\"]&#91;\"name\"] == \"Test\"\n  assert env.config&#91;\"db\"]&#91;\"user\"] == \"test\"<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Il est \u00e9galement possible de mapper l&rsquo;environnement \u00e0 des instances de classes. Les variables doivent \u00eatre rang\u00e9es en sections qui seront affect\u00e9es \u00e0 une classe diff\u00e9rente.<\/p>\n\n\n\n<pre id=\"code-58\" class=\"wp-block-code\"><code>from bolinette.core.environment import environment\n\n@environment(\"api\")\n@dataclass(init=False)  # Pour faire un taire un pyright r\u00e9gl\u00e9 sur strict\nclass ApiOptions:\n  name: str\n  url: str\n  params: list&#91;str]\n\n@environment(\"db\")\n@dataclass(init=False)\nclass DbOptions:\n  url: str\n  user: str\n  password: str\n\ndef cmd(api_opt: ApiOptions, db_opt: DbOptions) -&gt; None:\n  assert api_opt.name == \"Test\"\n  assert db_opt.user == \"test\"<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\"><a href=\"#mapper\"><\/a>Mapper<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Le mapper permet de transformer des donn\u00e9es d&rsquo;une instance \u00e0 une autre, de la m\u00eame classe ou de classes diff\u00e9rentes. Par d\u00e9faut, le mapper fonctionne automatiquement, se basant sur les noms des attributs d&rsquo;une instance. Il n&rsquo;est obligatoire de d\u00e9clarer qu&rsquo;un mapping, mais le mapper requiert que la classe d&rsquo;arriv\u00e9e soit int\u00e9gralement annot\u00e9e pour cr\u00e9er des nouvelles instances.<\/p>\n\n\n\n<pre id=\"code-59\" class=\"wp-block-code\"><code>from bolinette.core.mapping import Mapper\n\nclass Source:\n  def __init__(self, value: int) -&gt; None:\n    self.value = value\n\nclass Destination:\n  value: int\n\nclass DestWithInit:\n  def __init__(self, value: int) -&gt; None:\n    self.value = value\n\ndef cmd(mapper: Mapper) -&gt; None:\n  src = Source(42)\n  dst1 = mapper.map(Source, Destination, src)\n  # Destination n'a pas d'init, le mapper peut l'instancier.\n  assert dst1.value == 42\n\n  dst2 = DestWithInit(68)\n  assert dst2.value == 68\n  dst2 = mapper.map(Source, DestWithInit, src, dst2)\n  # DestWithInit demande des param\u00e8tres d'init, une instance doit \u00eatre donn\u00e9e au mapper.\n  assert dst2.value == 42<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\"><a href=\"#profils-de-mapping\"><\/a>Profils de mapping<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Quand le mapping n&rsquo;est pas trivial, il est possible de surcharger le comportement par d\u00e9faut du mapper. Cela se fait en d\u00e9clarant un profil qui va d\u00e9crire comment proc\u00e9der pour chaque transformation.<\/p>\n\n\n\n<pre id=\"code-60\" class=\"wp-block-code\"><code>from bolinette.core.mapping import Mapper, Profile, profile, mapping\n\nclass Source:\n  def __init__(self, value: int) -&gt; None:\n    self.value = value\n\nclass Destination:\n  id: int\n  name: str | None\n\n@mapping()\nclass TestProfile(Profile):\n  def __init__(self) -&gt; None:\n    super().__init__()\n    self.register(Source, Destination).for_attr(\n      lambda dest: dest.content, lambda opt: opt.map_from(lambda src: src.value)\n    ).for_attr(\n      lambda dest: dest.name, lambda opt: opt.ignore()\n    ) # Seulement possible car name est optionel\n\ndef cmd(mapper: Mapper) -&gt; None:\n  src = Source(42)\n  dst = mapper.map(Source, Destination, src)\n  assert dst.id == 42\n  asser dst.name is None<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\"><a href=\"#commandes\"><\/a>Commandes<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Le point d&rsquo;entr\u00e9e principal du package&nbsp;<code>core<\/code>&nbsp;de Bolinette sont les commandes CLI. Ce sont des fonctions, possiblement asynchrones, qui sont appel\u00e9es lorsque la commande mapp\u00e9e est demand\u00e9e par le terminal.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Les commandes sont ex\u00e9cut\u00e9es dans une scope, il est donc possible de demander des services&nbsp;<code>singleton<\/code>,&nbsp;<code>transcient<\/code>&nbsp;et&nbsp;<code>scoped<\/code>. Les arguments sont \u00e9galement d\u00e9crits dans la signature avec des types annot\u00e9s, avec leur nom, leur positionnement et une \u00e9ventuelle valeur par d\u00e9faut.<\/p>\n\n\n\n<pre id=\"code-61\" class=\"wp-block-code\"><code>from typing import Literal, Annotated\n\nfrom bolinette.core.command import command, Argument\nfrom bolinette.core.injection import injectable\n\n@injectable(\"scoped\")\nclass Service:\n  async def create_user(self, name: str, age: int, admin: bool) -&gt; User:\n    ...\n\n  async def add_to_group(self, user: User, group: str) -&gt; User:\n    ...\n\n  async def commit(self) -&gt; bool:\n    ...\n\n@command(\"create user\", \"Cette commande permet de cr\u00e9er un utilisateur\")\nasync def my_command(\n  service: Service,\n  name: Annotated&#91;str, Argument()],\n  age: Annotated&#91;int, Argument()],\n  group: Annotated&#91;str | None, Argument(\"option\", \"g\")],  # \"g\" d\u00e9clare un raccourci \u00e0 une lettre\n  admin: Annotated&#91;bool, Argument(\"switch\")] = False,\n  commit: Annotated&#91;bool, Argument(\"switch\", \"c\")] = False,\n) -&gt; None:\n  assert isinstance(service, Service)\n  user = await service.create_user(name, age, admin)\n  if group is not None:\n    await service.add_to_group(user, group)\n  if commit:\n    await service.commit()<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Dans l&rsquo;example,&nbsp;<code>name<\/code>&nbsp;et&nbsp;<code>age<\/code>&nbsp;sont des arguments positionnels. Ils n&rsquo;ont pas de valeur par d\u00e9faut, ils sont obligatoires.<code>group<\/code>&nbsp;est un argument nomm\u00e9, soit via&nbsp;<code>--group<\/code>&nbsp;ou&nbsp;<code>-g<\/code>, nullable donc non requis.&nbsp;<code>admin<\/code>&nbsp;et&nbsp;<code>commit<\/code>&nbsp;sont des bascules bool\u00e9ennes. Si les arguments,&nbsp;<code>--admin<\/code>&nbsp;et&nbsp;<code>--commit<\/code>, ou le raccourci&nbsp;<code>-c<\/code>, sont pr\u00e9sents, une valeur&nbsp;<code>True<\/code>&nbsp;sera affect\u00e9e. La valeur par d\u00e9faut&nbsp;<code>False<\/code>&nbsp;permet de rendre ces bascules non requises.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Voici un exemple d&rsquo;utilisation de cette commande. Voir plus bas comment initialiser Bolinette et lancer le script.<\/p>\n\n\n\n<pre id=\"code-62\" class=\"wp-block-code\"><code>python -m my_app create user Bob 42 -g boys --admin -c<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\"><a href=\"#fonctions-de-d%C3%A9marrage\"><\/a>Fonctions de d\u00e9marrage<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Ces fonctions sont ex\u00e9cut\u00e9es au d\u00e9marrage de Bolinette. Elles peuvent \u00eatre asynchrones et demander n&rsquo;importe quel service dans leur signature. Elles sont ex\u00e9cut\u00e9es dans une session d&rsquo;injection asynchrone et peuvent d\u00e9pendre de services&nbsp;<code>scoped<\/code>.<\/p>\n\n\n\n<pre id=\"code-63\" class=\"wp-block-code\"><code>from bolinette.core import startup\n\n@startup()\nasync def run_at_launch(service: MyService) -&gt; None:\n  await service.do_stuff()<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Voir plus bas comment d\u00e9clencher le d\u00e9marrage de Bolinette.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><a href=\"#utiliser-bolinette-dans-mon-projet\"><\/a>Utiliser Bolinette dans mon projet<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Tout le chapitre pr\u00e9c\u00e9dent d\u00e9crit les \u00e9l\u00e9ment ind\u00e9pendants du package&nbsp;<code>core<\/code>. Mais ils forment un tout qui fonctionne en symbiose. Le point d&rsquo;entr\u00e9e standard de Bolinette sont les commandes CLI. Le package&nbsp;<code>web<\/code>, voir plus bas, ajoute la possibilit\u00e9 de cr\u00e9er une API web.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Il est d&rsquo;abord n\u00e9cessaire de cr\u00e9er l&rsquo;application Bolinette et charger les diff\u00e9rentes extensions.<\/p>\n\n\n\n<pre id=\"code-64\" class=\"wp-block-code\"><code># module my_app.app\nfrom bolinette import data, web\nfrom bolinette.core import Bolinette\n\ndef make_bolinette():\n  blnt = Bolinette()\n  blnt.use_extension(data)\n  blnt.use_extension(web).use_websockets()\n  return blnt<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Chaque extension expose ses propres m\u00e9thodes de param\u00e9trage afin d&rsquo;activer des options et personnaliser les fonctionnalit\u00e9s.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ensuite, il faut cr\u00e9er le point d&rsquo;entr\u00e9e de l&rsquo;application, en cr\u00e9ant un fichier&nbsp;<code>__main__.py<\/code>&nbsp;dans votre module racine, ou en \u00e9crivant le script de d\u00e9marrage dans un bloc&nbsp;<code>if __name__ == \"__main__\":<\/code><\/p>\n\n\n\n<pre id=\"code-65\" class=\"wp-block-code\"><code># module my_app.__main__\nimport asyncio\nimport sys\n\nfrom my_app.app import make_bolinette\n\nblnt = make_bolinette()\nasyncio.run(blnt.exec_args(sys.argv&#91;1:]))<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Ce code&nbsp;<em>boilerplate<\/em>&nbsp;permet de lancer le CLI \u00e0 partir des arguments fournis \u00e0 Python.&nbsp;<code>exec_args(...)<\/code>&nbsp;va s&rsquo;occuper du m\u00e9canisme de d\u00e9marrage et lancer la commande pass\u00e9e en param\u00e8tre, avec ses arguments.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><code>Bolinette.startup(self)<\/code>&nbsp;peut \u00eatre appel\u00e9e directement, pour utiliser Bolinette sans le CLI. L&rsquo;injection est disponible sous&nbsp;<code>Bolinette.injection<\/code>. Vous pouvez ensuite ouvrir une session scop\u00e9e et cr\u00e9er votre propre flow de code en profitant de tous les services de Bolinette.<\/p>\n\n\n\n<pre id=\"code-66\" class=\"wp-block-code\"><code># module my_app.__main__\nimport asyncio\nimport sys\n\nfrom bolinette.core import Bolinette\n\nfrom my_app.app import make_bolinette, do_wacky_stuff\n\nasync def run_my_app(blnt: Bolinette) -&gt; None:\n  await blnt.startup()\n  async with blnt.injection.get_async_scoped_session() as session:\n    await session.call(do_wacky_stuff)\n\nblnt = make_bolinette()\nasyncio.run(run_my_app(blnt))<\/code><\/pre>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\">\u26a0\ufe0f Bolinette fonctionne principalement avec des d\u00e9corateurs. Veillez \u00e0 bien importer tous vos fichiers afin qu&rsquo;il soient lus par l&rsquo;interpr\u00e9teur. Si vous obtenez des erreurs d&rsquo;injections sur un service inconnu, c&rsquo;est peut-\u00eatre que vous avez oubli\u00e9 de charger le fichier qui contient votre classe.<\/p>\n<\/blockquote>\n\n\n\n<h1 class=\"wp-block-heading\"><a href=\"#bolinettedata\"><\/a><code>bolinette.data<\/code><\/h1>\n\n\n\n<h2 class=\"wp-block-heading\"><a href=\"#mod%C3%A8les\"><\/a>Mod\u00e8les<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">La base du package&nbsp;<code>data<\/code>&nbsp;sont les mod\u00e8les, qui servent \u00e0 d\u00e9crire les donn\u00e9es. Bolinette utilise l&rsquo;ORM SQLAlchemy, version 2, sans le masquer, afin d&rsquo;offrir toutes les fonctionnalit\u00e9s complexes que propose la biblioth\u00e8que.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Il est possible de g\u00e9rer des mod\u00e8les provenant de plusieurs sources de donn\u00e9es, mais les requ\u00eates entre ces mod\u00e8les sont impossibles.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Voici comment d\u00e9clarer un mod\u00e8le de donn\u00e9es:<\/p>\n\n\n\n<pre id=\"code-67\" class=\"wp-block-code\"><code>from bolinette.data.relational import entity, get_base\nfrom sqlalchemy.orm import Mapped, mapped_column\n\n@entity()\nclass User(get_base(\"default\")):\n    __tablename__ = \"users\"\n\n    id: Mapped&#91;int] = mapped_column(primary_key=True)\n    username: Mapped&#91;str] = mapped_column(unique=True)<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\"><a href=\"#manipulation-des-donn%C3%A9es\"><\/a>Manipulation des donn\u00e9es<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">La classe&nbsp;<code>Repository<\/code>&nbsp;permet de manipuler les mod\u00e8les. Toutes ses m\u00e9thodes sont asynchrones afin d&rsquo;\u00eatre utilis\u00e9es avec la biblioth\u00e8que&nbsp;<code>asyncio<\/code>&nbsp;de Python. SQLAlchemy supporte des pilotes asynchrones sur les bases de donn\u00e9es PostgreSQL et SQLite. Les autres pilotes synchrones sont aussi support\u00e9s par le&nbsp;<code>Repository<\/code>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Dans l&rsquo;exemple suivant, voici comment ajouter et r\u00e9cup\u00e9rer des donn\u00e9es en base. Les deux fonctions sont appel\u00e9es depuis une session scop\u00e9e. Les repositories sont seulement disponibles en mode&nbsp;<code>scoped<\/code>&nbsp;car ils d\u00e9pendent d&rsquo;une session en base ouverte au d\u00e9but de la scope. Le m\u00e9canisme de commit de la session est automatique en sortie de scope.<\/p>\n\n\n\n<pre id=\"code-68\" class=\"wp-block-code\"><code>from bolinette.core.injection import Injection\nfrom bolinette.data.relational import Repository, repository\nfrom sqlalchemy import select\n\n@repository(User)\nclass UserRepository(Repository&#91;User]):\n  pass\n\ndef create_users(user_repo: UserRepository) -&gt; None:\n  user_repo.add(User(username=\"Bob\"))\n  user_repo.add(User(username=\"Alice\"))\n\nasync def get_user(username: str, user_repo: UserRepository) -&gt; User:\n  return await user_repo.first(select(User).where(User.username == username))\n\nasync def cmd(inject: Injection) -&gt; None:\n  async with inject.get_async_scoped_session() as scoped:\n    scoped.call(create_users)\n  async with inject.get_async_scoped_session() as scoped:\n    bob = await scoped.call(get_user, \"Bob\")\n    assert bob.username == \"Bob\"<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">La session SQLAlchemy est expos\u00e9e dans la classe&nbsp;<code>Repository<\/code>. Il est possible de l&rsquo;utiliser directement sans passer par les fonctions wrapper de Bolinette.<\/p>\n\n\n\n<pre id=\"code-69\" class=\"wp-block-code\"><code>@repository(User)\nclass UserRepository(Repository&#91;User]):\n  async def print_all_users_manual(self) -&gt; None:\n    \"\"\"It\u00e9ration directement sur le curseur SQLAlchemy.\"\"\"\n    result = await self.session.execute(select(User))\n    for user in result.scalars():\n      print(f\"&lt;User {user.username}&gt;\")\n\n  async def print_all_users_iter(self) -&gt; None:\n    \"\"\"It\u00e9ration sur un wrapper asynchrone.\"\"\"\n    async for user in self.iterate(select(User)):\n      print(f\"&lt;User {user.username}&gt;\")<\/code><\/pre>\n\n\n\n<h1 class=\"wp-block-heading\"><a href=\"#bolinetteweb\"><\/a><code>bolinette.web<\/code><\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">Le package&nbsp;<code>web<\/code>&nbsp;est bas\u00e9 sur la biblioth\u00e8que&nbsp;<code>aiohttp<\/code>&nbsp;et expose ses classes telles que&nbsp;<code>Request<\/code>&nbsp;et&nbsp;<code>Response<\/code>&nbsp;afin de personnaliser au maximum le format des donn\u00e9es renvoy\u00e9es au client.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><a href=\"#controlleurs-web\"><\/a>Controlleurs web<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Le principe du package&nbsp;<code>web<\/code>&nbsp;est mapper des endpoints web \u00e0 des fonctions Python. Ces fonctions sont des routes, de m\u00e9thodes de classes appel\u00e9es contr\u00f4leurs. Le contr\u00f4leur est instanci\u00e9 \u00e0 l&rsquo;invocation de la route. L&rsquo;<code>__init__<\/code>&nbsp;du contr\u00f4leur et la route peuvent demander des services dans leur signature, l&rsquo;<code>__init__<\/code>&nbsp;permetant de mutualiser les d\u00e9pendances communes des diff\u00e9rentes routes du contr\u00f4leur, comme un service, l&rsquo;environnement, le mapper, etc.<\/p>\n\n\n\n<pre id=\"code-70\" class=\"wp-block-code\"><code>from typing import Annotated\n\nfrom bolinette.core.mapping import Mapper\nfrom bolinette.web import controller, get, post, put, patch, delete, Payload\n\nfrom my_app.entities import Item\nfrom my_app.services import UserService\nfrom my_app.controllers.responses import ItemResponse\nfrom my_app.controllers.payloads import CreateItemPayload, UpdateItemPayload, PatchItemPayload\n\n@controller(\"\/api\/store\")\nclass StoreController:\n  def __init__(self, mapper: Mapper, service: UserService) -&gt; None:\n    self.mapper = mapper\n    self.service = service\n\n  @get(\"\")\n  async def get_all(self) -&gt; list&#91;ItemResponse]:\n    items = await self.service.get_all()\n    return self.mapper.map(list&#91;Item], list&#91;ItemResponse], items)\n\n  @post(\"\")\n  async def create(self, payload: Annotated&#91;CreateItemPayload, Payload()]) -&gt; ItemResponse:\n    item = await self.service.create(payload)\n    return self.mapper.map(Item, ItemResponse, item)\n\n  @get(\"{id}\")\n  async def get_one(self, id: int) -&gt; ItemResponse:\n    item = await self.service.get_by_id(id)\n    return self.mapper.map(Item, ItemResponse, item)\n\n  @put(\"{id}\")\n  async def update(self, id: int, payload: Annotated&#91;UpdateItemPayload, Payload()]) -&gt; ItemResponse:\n    item = await self.service.update(id, payload)\n    return self.mapper.map(Item, ItemResponse, item)\n\n  @patch(\"{id}\")\n  async def patch(self, id: int, payload: Annotated&#91;PatchItemPayload, Payload()]) -&gt; ItemResponse:\n    item = await self.service.update(id, payload)\n    return self.mapper.map(Item, ItemResponse, item)\n\n  @delete(\"{id}\")\n  async def delete(self, id: int) -&gt; None:\n    await self.service.delete(id)<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Voici un exemple typique d&rsquo;op\u00e9rations CRUD. Les variables de route, formatt\u00e9es entre accolades, peuvent \u00eatre inject\u00e9es dans la signature de la route et typ\u00e9es avec des&nbsp;<code>builtins<\/code>&nbsp;Python. Le body des requ\u00eates&nbsp;<code>POST<\/code>,&nbsp;<code>PUT<\/code>&nbsp;et&nbsp;<code>DELETE<\/code>&nbsp;peuvent \u00eatre mapp\u00e9s sur des classes DTO en annotant le type avec&nbsp;<code>Payload()<\/code>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Ici, le&nbsp;<code>service<\/code>&nbsp;est une classe m\u00e9tier. Il est possible de combiner les packages&nbsp;<code>web<\/code>&nbsp;et&nbsp;<code>data<\/code>&nbsp;afin de manipuler les objets d&rsquo;une base de donn\u00e9es. Pour cela, il est recommand\u00e9 de cr\u00e9er des objets interm\u00e9diaires afin de contr\u00f4ler quelles informations sortent de l&rsquo;API et quelles informations sont demand\u00e9es pour cr\u00e9er et modifier la base m\u00e9tier.<\/p>\n\n\n\n<pre id=\"code-71\" class=\"wp-block-code\"><code>from typing import TypedDict\n\nfrom bolinette.core.mapper import Profile, mapping\n\nfrom my_app.entities import Item\n\n@dataclass(init=False)  # permet d'\u00e9viter un warning sur les attributs non initialis\u00e9s et un init vide est n\u00e9cessaire pour le mapper\nclass ItemResponse:\n  name: str\n  price: float\n  tax: float\n  final_price: float\n\n@dataclass(init=False)\nclass CreateItemPayload:\n  name: str\n  price: float\n  tax: float\n\n@dataclass(init=False)\nclass UpdateItemPayload:\n  name: str\n  price: float\n  tax: float\n\nclass PatchItemPayload(TypedDict, total=False):\n  name: str\n  price: float\n  tax: float\n\n@mapping\nclass ItemProfile(Profile):\n  def __init__(self) -&gt; None:\n    super().__init__()\n    self.register(Item, ItemResponse).for_attr(\n      lambda dest: dest.final_price, lambda opt: opt.map_from(lambda src: src.price * src.tax)\n    )<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Dans cet exemple, les classes pour la r\u00e9cup\u00e9ration, la cr\u00e9ation et l&rsquo;\u00e9dition sont des dataclasses, enti\u00e8rement typ\u00e9es pour \u00eatre compatibles avec le mapper.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">La classe de patch est un&nbsp;<code>TypedDict<\/code>, qui est transform\u00e9 au runtime en&nbsp;<code>dict<\/code>&nbsp;classique. Cela permet de g\u00e9rer une requ\u00eate&nbsp;<code>PATCH<\/code>&nbsp;REST classique. Si l&rsquo;attribut est nul, il doit \u00eatre pass\u00e9 \u00e0 nul en base. Si l&rsquo;attribut n&rsquo;est pas pr\u00e9sent, il doit \u00eatre ignor\u00e9. La m\u00e9tadonn\u00e9e&nbsp;<code>total=False<\/code>&nbsp;permet de dire au mapper de ne pas lever d&rsquo;erreur lorsque l&rsquo;attribut n&rsquo;est pas pr\u00e9sent dans le body JSON. Le m\u00eame r\u00e9sultat est possible en d\u00e9corant les types avec&nbsp;<code>NotRequired<\/code>, comme par exemple&nbsp;<code>name: NotRequired[str]<\/code>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><a href=\"#middlewares\"><\/a>Middlewares<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Les middlewares s&rsquo;interposent entre la r\u00e9ponse et la route afin de faire des traitements, avant ou apr\u00e8s le traitement de la route du contr\u00f4leur.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Un middleware est une classe qui requiert deux m\u00e9thodes:<\/p>\n\n\n\n<pre id=\"code-72\" class=\"wp-block-code\"><code>class Middleware&#91;**MdlwInitP](Protocol):\n  def options(self, *args: MdlwInitP.args, **kwargs: MdlwInitP.kwargs) -&gt; None:\n    ...\n\n  async def handle(self, next: Callable&#91;&#91;], Awaitable&#91;web.Response]]) -&gt; web.Response:\n    ...<\/code><\/pre>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>options<\/code>&nbsp;permet de d\u00e9finir des param\u00e8tres \u00e0 renseigner dans le d\u00e9corateur.<\/li>\n\n\n\n<li><code>handle<\/code>&nbsp;est appel\u00e9e avant l&rsquo;ex\u00e9cution de la route. Il est attendu que le code appelle&nbsp;<code>next<\/code>&nbsp;afin de poursuivre la cha\u00eene des middlewares et enfin la route. Tout code plac\u00e9 avant l&rsquo;appel \u00e0&nbsp;<code>next<\/code>&nbsp;sera ex\u00e9cut\u00e9 avant la route et tout code plac\u00e9 apr\u00e8s sera ex\u00e9cut\u00e9 apr\u00e8s.<\/li>\n\n\n\n<li>Utilisez l&rsquo;<code>__init__<\/code>&nbsp;du middleware pour demander des services \u00e0 l&rsquo;injection. Les middlewares sont instanci\u00e9s \u00e0 chaque appel de route dans une session scop\u00e9e asynchrone.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Voici un exemple complet de d\u00e9claration et utilisation de middlewares:<\/p>\n\n\n\n<pre id=\"code-73\" class=\"wp-block-code\"><code>from aiohttp\nfrom bolinette.core.mapping import Mapper\nfrom bolinette.web import with_middleware, without_middleware, controller, get\nfrom bolinette.web.exceptions import UnauthorizedError, ForbiddenError\n\nfrom my_app.services import UserService, AuthService\nfrom my_app.controllers.responses import UserResponse, UserPublicResponse, UserAdminResponse\n\nclass AuthMiddleware:\n  def __init__(self, request: Request, user_service: UserService, auth_service: AuthService) -&gt; None:\n    self.request = request\n    self.user_service = user_service\n    self.auth_service = auth_service\n    self.roles: list&#91;str] | None\n\n  def options(self, roles: list&#91;str] | None = None) -&gt; None:\n    self.roles = roles\n\n  async def handle(self, next: Callable&#91;&#91;], Awaitable&#91;web.Response]]) -&gt; web.Response:\n    token: str | None = self.request.headers.get('Authorization')\n    if not self.auth_service.verify_token(token):\n      raise UnauthorizedError()\n    if self.roles is not None:\n      user = await self.user_service.get_from_token(token)\n      if not any(r for r in user.roles if r.name in self.roles):\n        raise ForbiddenErorr()\n    return await next()\n\n@controller(\"\/api\/user\")\n@with_middleware(AuthMiddleware)\nclass UserController:\n  def __init__(self, user_service: UserService, mapper: Mapper) -&gt; None:\n    self.user_service = user_service\n    self.mapper = mapper\n\n  @get(\"\")\n  async def get_all_users(self) -&gt; list&#91;UserPublicResponse]:\n    users = await self.user_service.get_all()\n    return self.mapper.map(list&#91;User], list&#91;UserResponse], users)\n\n  @get(\"public\")\n  @without_middleware(AuthMiddleware)\n  async def get_all_users_public(self) -&gt; list&#91;UserPublicResponse]:\n    users = await self.user_service.get_all()\n    return self.mapper.map(list&#91;User], list&#91;UserPublicResponse], users)\n\n  @get(\"admin\")\n  @with_middleware(AuthMiddleware, roles=&#91;'admin'])\n  async def get_all_users_admin(self) -&gt; list&#91;UserPublicResponse]:\n    users = await self.user_service.get_all()\n    return self.mapper.map(list&#91;User], list&#91;UserAdminResponse], users)<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Dans l&rsquo;exemple pr\u00e9c\u00e9dant, <strong>le middleware est appliqu\u00e9 \u00e0 la classe,<\/strong> ce qui l&rsquo;applique \u00e0 toutes les routes du contr\u00f4leur.<code>without_middleware<\/code>\u00a0permet d&rsquo;annuler l&rsquo;ex\u00e9cution du middleware global pour une route sp\u00e9cifique. Il est possible de red\u00e9finir un m\u00eame\u00a0<code>with_middleware<\/code>\u00a0afin de modifier les arguments attendus par la m\u00e9thode\u00a0<code>options<\/code>\u00a0du middleware pour une route sp\u00e9cifique.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Autant de&nbsp;<code>with_middleware<\/code>&nbsp;et&nbsp;<code>without_middleware<\/code>&nbsp;peuvent \u00eatre empil\u00e9s au-dessus d&rsquo;un contr\u00f4leur ou d&rsquo;une route que n\u00e9cessaire. Un middleware peut \u00eatre d\u00e9clar\u00e9 directement sur une route, sans qu&rsquo;il soit d\u00e9clar\u00e9 sur le contr\u00f4leur. Les middlewares sont ex\u00e9cut\u00e9s dans l&rsquo;ordre de d\u00e9claration, ceux de la classe puis ceux de la m\u00e9thode. Si un middleware est red\u00e9clar\u00e9 sur une route, il garde l&rsquo;ordre de passage qui a \u00e9t\u00e9 d\u00e9clar\u00e9 sur la classe.<\/p>\n\n\n\n<h1 class=\"wp-block-heading\"><a href=\"#les-tests\"><\/a>Les tests<\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">Une batterie de tests unitaires pouss\u00e9s permettent d&rsquo;ajouter et refactoriser sereinement les fonctionnalit\u00e9s les plus critiques du framework. <strong>Bolinette est test\u00e9 \u00e0 plus de 90% et de nouveaux tests significatifs<\/strong> sont ajout\u00e9s continuellement. Les tests utilisent la souplesse et la puissance de la biblioth\u00e8que pytest et ses extensions.<\/p>\n\n\n\n<h1 class=\"wp-block-heading\"><a href=\"#la-suite\"><\/a>La suite<\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">Si le framework est d\u00e9j\u00e0 fonctionnel, il reste beaucoup de travail pour r\u00e9aliser ma vision. Voici les prochaines fonctionnalit\u00e9s d\u00e9j\u00e0 pr\u00e9vue pour 2024:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>package&nbsp;<code>core<\/code>:\n<ul class=\"wp-block-list\">\n<li>am\u00e9liorer le mapper, ajouter des cas d&rsquo;utilisation<\/li>\n\n\n\n<li>ajouter le support SMTP ainsi que les fournisseurs de services mails les plus populaires<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>package&nbsp;<code>data<\/code>:\n<ul class=\"wp-block-list\">\n<li>cr\u00e9er un syst\u00e8me de validation d&rsquo;entit\u00e9s afin d&rsquo;\u00e9viter des erreurs de format relev\u00e9s par la base de donn\u00e9es<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>package&nbsp;<code>web<\/code>:\n<ul class=\"wp-block-list\">\n<li>ajouter le support des websockets<\/li>\n\n\n\n<li>ajouter un m\u00e9canisme d&rsquo;authentification normalis\u00e9<\/li>\n\n\n\n<li>ajouter un swagger automatique<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>nouveau package&nbsp;<code>api<\/code>:\n<ul class=\"wp-block-list\">\n<li>faire le lien entre&nbsp;<code>data<\/code>&nbsp;et&nbsp;<code>web<\/code>&nbsp;afin de g\u00e9n\u00e9rer des op\u00e9rations CRUD automatiques<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n<h1 class=\"wp-block-heading\"><a href=\"#pour-la-petite-histoire\"><\/a>Pour la petite histoire<\/h1>\n\n\n\n<p class=\"wp-block-paragraph\">J&rsquo;ai cr\u00e9\u00e9 <strong>une premi\u00e8re version de Bolinette en 2019<\/strong>. C&rsquo;\u00e9tait un projet \u00e0 greffer <strong>sur Flask, un framework web<\/strong>. Il manquait \u00e0 Flask des fonctionnalit\u00e9s qui me semblaient utiles pour faire une API web de mani\u00e8re efficace, mais Flask \u00e9tant d\u00e9crit comme un\u00a0<em>micro framework<\/em>, leur absence n&rsquo;est en rien un d\u00e9faut du framework.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">J&rsquo;ai donc, en quelques mois de travail sur mon temps libre, ajout\u00e9 un syst\u00e8me de s\u00e9rialisation automatique et param\u00e9trable afin de pouvoir renvoyer des objets m\u00e9tier directement depuis les contr\u00f4leurs, sans avoir \u00e0 manuellement construire un dictonnaire que le module&nbsp;<code>json<\/code>&nbsp;de Python sait manipuler.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Les fonctionnalit\u00e9s telles que la validation automatique des donn\u00e9es, la cr\u00e9ation de route automatiques et l&rsquo;ajout de middlewares se sont rajout\u00e9es au cours de l&rsquo;ann\u00e9e suivante.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">J&rsquo;ai ensuite r\u00e9alis\u00e9 quelques <strong>tests de performance <\/strong>afin de voir les temps de r\u00e9ponse d&rsquo;une API tr\u00e8s simple r\u00e9alis\u00e9e avec Bolinette. J&rsquo;ai \u00e9t\u00e9 horrifi\u00e9 par les 500ms n\u00e9cessaires \u00e0 la r\u00e9cup\u00e9ration de quelques entit\u00e9s de base de donn\u00e9es. Aujourd&rsquo;hui encore, je ne sais pas d&rsquo;o\u00f9 venait le probl\u00e8me, mais j&rsquo;ai pris la d\u00e9cision radicale de remplacer Flask par aiohttp.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>aiohttp n&rsquo;est pas un framework, mais une biblioth\u00e8que HTTP <\/strong>qui fournis un routeur et traite les requ\u00eates et r\u00e9ponses HTTP. J&rsquo;ai d\u00fb remplacer les fonctionnalit\u00e9s offertes par Flask par d&rsquo;autres biblioth\u00e8ques sp\u00e9cialis\u00e9es. Mes efforts de refactorisation ont \u00e9t\u00e9 couronn\u00e9s par un gain de vitesse multipli\u00e9 par 10!<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">L&rsquo;injection <strong>de d\u00e9pendances a \u00e9t\u00e9 ajout\u00e9e quelques temps apr\u00e8s, <\/strong>mais le syst\u00e8me fonctionnait seulement sur les routes de contr\u00f4leurs et n&rsquo;\u00e9tait absolument pas flexible. Le framework utilisait encore beaucoup des\u00a0<em>magic strings<\/em>, o\u00f9 les entit\u00e9s, services et contr\u00f4leurs \u00e9taient identifi\u00e9s avec un nom, tr\u00e8s difficile \u00e0 refactoriser. Bolinette \u00e9tait un projet monolithique, encore d\u00e9crit comme framework web.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Devant <strong>le constat de la compl\u00e9xit\u00e9 d&rsquo;utilisation et la difficult\u00e9 de d\u00e9m\u00e9ler<\/strong> le code intriqu\u00e9, j&rsquo;ai pris une autre d\u00e9cision radicale: tout recommencer.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Le chantier<strong> \u00e0 commenc\u00e9 en 2022.<\/strong> J&rsquo;ai d&rsquo;abord cr\u00e9\u00e9 le package\u00a0<code>core<\/code>\u00a0avec en t\u00eate une s\u00e9paration des facettes de Bolinette. Le framework n&rsquo;\u00e9tait plus un framework web, mais une plateforme de services divers li\u00e9s par un syst\u00e8me d&rsquo;inversion de contr\u00f4le flexible et intuitif.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Le reste <strong>a suivi et aujourd&rsquo;hui,<\/strong> je suis tr\u00e8s fier du travail accompli et je vois clairement ou je souhaite ammener le projet. Mon but ultime est <strong>d&rsquo;accepter des contributions d&rsquo;autres d\u00e9veloppeurs et que Bolinette soit utilis\u00e9.<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">See you in 2025\u00a0\ud83d\ude80<\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u00c9crit par Pierre Chat Depuis quelques ann\u00e9es, je poursuis un projet personnel, d\u00e9velopper un framework en Python. Un framework de quoi ? Bonne question ! Le<span class=\"excerpt-hellip\"> [\u2026]<\/span><\/p>\n","protected":false},"author":10,"featured_media":14542,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"content-type":"","inline_featured_image":false,"fifu_image_url":"","fifu_image_alt":"","footnotes":""},"categories":[34],"tags":[],"class_list":["post-14541","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-articles-techniques"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.9 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Bolinette, le framework Python multifonction - Ouidou<\/title>\n<meta name=\"description\" content=\"Bolinette, le framework Python multifonction : D\u00e9couvrez Bolinette et ses capacit\u00e9s pour simplifier le d\u00e9veloppement Python.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/ouidou.fr\/blog\/articles-techniques\/bolinette-le-framework-python-multifonction\" \/>\n<meta property=\"og:locale\" content=\"fr_FR\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Bolinette, le framework Python multifonction - Ouidou\" \/>\n<meta property=\"og:description\" content=\"Bolinette, le framework Python multifonction : D\u00e9couvrez Bolinette et ses capacit\u00e9s pour simplifier le d\u00e9veloppement Python.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/ouidou.fr\/blog\/articles-techniques\/bolinette-le-framework-python-multifonction\" \/>\n<meta property=\"og:site_name\" content=\"Ouidou\" \/>\n<meta property=\"article:published_time\" content=\"2024-05-06T09:07:39+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2024-09-20T08:08:00+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/ouidou.fr\/blog\/wp-content\/uploads\/2024\/03\/Bolinette-le-framework-Python-multifonction.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1105\" \/>\n\t<meta property=\"og:image:height\" content=\"564\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Sara Lourties\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"\u00c9crit par\" \/>\n\t<meta name=\"twitter:data1\" content=\"Sara Lourties\" \/>\n\t<meta name=\"twitter:label2\" content=\"Dur\u00e9e de lecture estim\u00e9e\" \/>\n\t<meta name=\"twitter:data2\" content=\"13 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/articles-techniques\\\/bolinette-le-framework-python-multifonction#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/articles-techniques\\\/bolinette-le-framework-python-multifonction\"},\"author\":{\"name\":\"Sara Lourties\",\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/#\\\/schema\\\/person\\\/e1d66085fb7c22ede319ce56adc373a4\"},\"headline\":\"Bolinette, le framework Python multifonction\",\"datePublished\":\"2024-05-06T09:07:39+00:00\",\"dateModified\":\"2024-09-20T08:08:00+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/articles-techniques\\\/bolinette-le-framework-python-multifonction\"},\"wordCount\":3127,\"publisher\":{\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/#organization\"},\"image\":{\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/articles-techniques\\\/bolinette-le-framework-python-multifonction#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/wp-content\\\/uploads\\\/2024\\\/03\\\/Bolinette-le-framework-Python-multifonction.png\",\"articleSection\":[\"Articles Techniques\"],\"inLanguage\":\"fr-FR\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/articles-techniques\\\/bolinette-le-framework-python-multifonction\",\"url\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/articles-techniques\\\/bolinette-le-framework-python-multifonction\",\"name\":\"Bolinette, le framework Python multifonction - Ouidou\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/articles-techniques\\\/bolinette-le-framework-python-multifonction#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/articles-techniques\\\/bolinette-le-framework-python-multifonction#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/wp-content\\\/uploads\\\/2024\\\/03\\\/Bolinette-le-framework-Python-multifonction.png\",\"datePublished\":\"2024-05-06T09:07:39+00:00\",\"dateModified\":\"2024-09-20T08:08:00+00:00\",\"description\":\"Bolinette, le framework Python multifonction : D\u00e9couvrez Bolinette et ses capacit\u00e9s pour simplifier le d\u00e9veloppement Python.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/articles-techniques\\\/bolinette-le-framework-python-multifonction#breadcrumb\"},\"inLanguage\":\"fr-FR\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/ouidou.fr\\\/blog\\\/articles-techniques\\\/bolinette-le-framework-python-multifonction\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"fr-FR\",\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/articles-techniques\\\/bolinette-le-framework-python-multifonction#primaryimage\",\"url\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/wp-content\\\/uploads\\\/2024\\\/03\\\/Bolinette-le-framework-Python-multifonction.png\",\"contentUrl\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/wp-content\\\/uploads\\\/2024\\\/03\\\/Bolinette-le-framework-Python-multifonction.png\",\"width\":1105,\"height\":564,\"caption\":\"image affiche blog technique\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/articles-techniques\\\/bolinette-le-framework-python-multifonction#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Accueil\",\"item\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Bolinette, le framework Python multifonction\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/#website\",\"url\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/\",\"name\":\"Blog Ouidou\",\"description\":\"Conseil et expertise en technologies\",\"publisher\":{\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"fr-FR\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/#organization\",\"name\":\"Ouidou\",\"url\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"fr-FR\",\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/wp-content\\\/uploads\\\/2022\\\/04\\\/image_2022-04-13_150237378.png\",\"contentUrl\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/wp-content\\\/uploads\\\/2022\\\/04\\\/image_2022-04-13_150237378.png\",\"width\":180,\"height\":180,\"caption\":\"Ouidou\"},\"image\":{\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/#\\\/schema\\\/logo\\\/image\\\/\"}},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/ouidou.fr\\\/blog\\\/#\\\/schema\\\/person\\\/e1d66085fb7c22ede319ce56adc373a4\",\"name\":\"Sara Lourties\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"fr-FR\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/b2ef32f9fc1e16168b39587a2ec1dafedc70a9d41fa1b4a930ec7744b3e35ec7?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/b2ef32f9fc1e16168b39587a2ec1dafedc70a9d41fa1b4a930ec7744b3e35ec7?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/b2ef32f9fc1e16168b39587a2ec1dafedc70a9d41fa1b4a930ec7744b3e35ec7?s=96&d=mm&r=g\",\"caption\":\"Sara Lourties\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Bolinette, le framework Python multifonction - Ouidou","description":"Bolinette, le framework Python multifonction : D\u00e9couvrez Bolinette et ses capacit\u00e9s pour simplifier le d\u00e9veloppement Python.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/ouidou.fr\/blog\/articles-techniques\/bolinette-le-framework-python-multifonction","og_locale":"fr_FR","og_type":"article","og_title":"Bolinette, le framework Python multifonction - Ouidou","og_description":"Bolinette, le framework Python multifonction : D\u00e9couvrez Bolinette et ses capacit\u00e9s pour simplifier le d\u00e9veloppement Python.","og_url":"https:\/\/ouidou.fr\/blog\/articles-techniques\/bolinette-le-framework-python-multifonction","og_site_name":"Ouidou","article_published_time":"2024-05-06T09:07:39+00:00","article_modified_time":"2024-09-20T08:08:00+00:00","og_image":[{"width":1105,"height":564,"url":"https:\/\/ouidou.fr\/blog\/wp-content\/uploads\/2024\/03\/Bolinette-le-framework-Python-multifonction.png","type":"image\/png"}],"author":"Sara Lourties","twitter_card":"summary_large_image","twitter_misc":{"\u00c9crit par":"Sara Lourties","Dur\u00e9e de lecture estim\u00e9e":"13 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/ouidou.fr\/blog\/articles-techniques\/bolinette-le-framework-python-multifonction#article","isPartOf":{"@id":"https:\/\/ouidou.fr\/blog\/articles-techniques\/bolinette-le-framework-python-multifonction"},"author":{"name":"Sara Lourties","@id":"https:\/\/ouidou.fr\/blog\/#\/schema\/person\/e1d66085fb7c22ede319ce56adc373a4"},"headline":"Bolinette, le framework Python multifonction","datePublished":"2024-05-06T09:07:39+00:00","dateModified":"2024-09-20T08:08:00+00:00","mainEntityOfPage":{"@id":"https:\/\/ouidou.fr\/blog\/articles-techniques\/bolinette-le-framework-python-multifonction"},"wordCount":3127,"publisher":{"@id":"https:\/\/ouidou.fr\/blog\/#organization"},"image":{"@id":"https:\/\/ouidou.fr\/blog\/articles-techniques\/bolinette-le-framework-python-multifonction#primaryimage"},"thumbnailUrl":"https:\/\/ouidou.fr\/blog\/wp-content\/uploads\/2024\/03\/Bolinette-le-framework-Python-multifonction.png","articleSection":["Articles Techniques"],"inLanguage":"fr-FR"},{"@type":"WebPage","@id":"https:\/\/ouidou.fr\/blog\/articles-techniques\/bolinette-le-framework-python-multifonction","url":"https:\/\/ouidou.fr\/blog\/articles-techniques\/bolinette-le-framework-python-multifonction","name":"Bolinette, le framework Python multifonction - Ouidou","isPartOf":{"@id":"https:\/\/ouidou.fr\/blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/ouidou.fr\/blog\/articles-techniques\/bolinette-le-framework-python-multifonction#primaryimage"},"image":{"@id":"https:\/\/ouidou.fr\/blog\/articles-techniques\/bolinette-le-framework-python-multifonction#primaryimage"},"thumbnailUrl":"https:\/\/ouidou.fr\/blog\/wp-content\/uploads\/2024\/03\/Bolinette-le-framework-Python-multifonction.png","datePublished":"2024-05-06T09:07:39+00:00","dateModified":"2024-09-20T08:08:00+00:00","description":"Bolinette, le framework Python multifonction : D\u00e9couvrez Bolinette et ses capacit\u00e9s pour simplifier le d\u00e9veloppement Python.","breadcrumb":{"@id":"https:\/\/ouidou.fr\/blog\/articles-techniques\/bolinette-le-framework-python-multifonction#breadcrumb"},"inLanguage":"fr-FR","potentialAction":[{"@type":"ReadAction","target":["https:\/\/ouidou.fr\/blog\/articles-techniques\/bolinette-le-framework-python-multifonction"]}]},{"@type":"ImageObject","inLanguage":"fr-FR","@id":"https:\/\/ouidou.fr\/blog\/articles-techniques\/bolinette-le-framework-python-multifonction#primaryimage","url":"https:\/\/ouidou.fr\/blog\/wp-content\/uploads\/2024\/03\/Bolinette-le-framework-Python-multifonction.png","contentUrl":"https:\/\/ouidou.fr\/blog\/wp-content\/uploads\/2024\/03\/Bolinette-le-framework-Python-multifonction.png","width":1105,"height":564,"caption":"image affiche blog technique"},{"@type":"BreadcrumbList","@id":"https:\/\/ouidou.fr\/blog\/articles-techniques\/bolinette-le-framework-python-multifonction#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Accueil","item":"https:\/\/ouidou.fr\/blog\/"},{"@type":"ListItem","position":2,"name":"Bolinette, le framework Python multifonction"}]},{"@type":"WebSite","@id":"https:\/\/ouidou.fr\/blog\/#website","url":"https:\/\/ouidou.fr\/blog\/","name":"Blog Ouidou","description":"Conseil et expertise en technologies","publisher":{"@id":"https:\/\/ouidou.fr\/blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/ouidou.fr\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"fr-FR"},{"@type":"Organization","@id":"https:\/\/ouidou.fr\/blog\/#organization","name":"Ouidou","url":"https:\/\/ouidou.fr\/blog\/","logo":{"@type":"ImageObject","inLanguage":"fr-FR","@id":"https:\/\/ouidou.fr\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/ouidou.fr\/blog\/wp-content\/uploads\/2022\/04\/image_2022-04-13_150237378.png","contentUrl":"https:\/\/ouidou.fr\/blog\/wp-content\/uploads\/2022\/04\/image_2022-04-13_150237378.png","width":180,"height":180,"caption":"Ouidou"},"image":{"@id":"https:\/\/ouidou.fr\/blog\/#\/schema\/logo\/image\/"}},{"@type":"Person","@id":"https:\/\/ouidou.fr\/blog\/#\/schema\/person\/e1d66085fb7c22ede319ce56adc373a4","name":"Sara Lourties","image":{"@type":"ImageObject","inLanguage":"fr-FR","@id":"https:\/\/secure.gravatar.com\/avatar\/b2ef32f9fc1e16168b39587a2ec1dafedc70a9d41fa1b4a930ec7744b3e35ec7?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/b2ef32f9fc1e16168b39587a2ec1dafedc70a9d41fa1b4a930ec7744b3e35ec7?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/b2ef32f9fc1e16168b39587a2ec1dafedc70a9d41fa1b4a930ec7744b3e35ec7?s=96&d=mm&r=g","caption":"Sara Lourties"}}]}},"_links":{"self":[{"href":"https:\/\/ouidou.fr\/blog\/wp-json\/wp\/v2\/posts\/14541","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ouidou.fr\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ouidou.fr\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ouidou.fr\/blog\/wp-json\/wp\/v2\/users\/10"}],"replies":[{"embeddable":true,"href":"https:\/\/ouidou.fr\/blog\/wp-json\/wp\/v2\/comments?post=14541"}],"version-history":[{"count":3,"href":"https:\/\/ouidou.fr\/blog\/wp-json\/wp\/v2\/posts\/14541\/revisions"}],"predecessor-version":[{"id":14915,"href":"https:\/\/ouidou.fr\/blog\/wp-json\/wp\/v2\/posts\/14541\/revisions\/14915"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ouidou.fr\/blog\/wp-json\/wp\/v2\/media\/14542"}],"wp:attachment":[{"href":"https:\/\/ouidou.fr\/blog\/wp-json\/wp\/v2\/media?parent=14541"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ouidou.fr\/blog\/wp-json\/wp\/v2\/categories?post=14541"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ouidou.fr\/blog\/wp-json\/wp\/v2\/tags?post=14541"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}