add comments about autogen'd files

Author: archeoss

backend/src/connector/api.rs

@@ -1,3 +1,10 @@
+//!
+//! This file was auto-generated using OpenAPI server generator
+//!     at <https://openapi-generator.tech/docs/generators/rust>
+//!     on 2023-07-07
+//!     using BOB's REST API schema, commit = ade0eadf1db7cda072cfab07dff7b1b57247e34a:
+//!     <https://github.com/qoollo/bob/blob/928faef96ced755b75e3396b84febad1ecaf1dae/config-examples/openapi.yaml>
+//!
 use super::context::ContextWrapper;
 use super::dto::{self};
 use crate::prelude::*;

backend/src/connector/client.rs

@@ -1,10 +1,22 @@
+//!
+//! This file was *partly* auto-generated using OpenAPI server generator
+//!     at <https://openapi-generator.tech/docs/generators/rust>
+//!     on 2023-07-07
+//!     using BOB's REST API schema, commit = ade0eadf1db7cda072cfab07dff7b1b57247e34a:
+//!     <https://github.com/qoollo/bob/blob/928faef96ced755b75e3396b84febad1ecaf1dae/config-examples/openapi.yaml>
+//!
+//!     This file was modified in order to get rid of the "swagger" crate, which brings
+//!     a lot of unnecessary dependencies (for example, openssl, which can cause problems
+//!     when creating docker images, even if we use only the http client). In addition,
+//!     some refactoring was done to reduce the code size (from 2k-ish LOC to 500).
+//!
+
 #![allow(
     missing_docs,
     clippy::module_name_repetitions,
     dead_code,
     unused_variables
 )]
-
 use super::{
     api::prelude::*,
     context::{BodyExt, DropContextService},
@@ -29,7 +41,6 @@ use std::{
     task::{Context, Poll},
 };
 use thiserror::Error;
-
 /// Error type for failing to create a Client
 #[derive(Debug, Error)]
 pub enum ClientInitError {

backend/src/connector/dto.rs

@@ -1,6 +1,15 @@
-/*
-* Note: This file is mostly autogenerated
-*/
+//!
+//! This file was *partly* auto-generated using OpenAPI server generator
+//!     at <https://openapi-generator.tech/docs/generators/rust>
+//!     on 2023-07-07
+//!     using BOB's REST API schema, commit = ade0eadf1db7cda072cfab07dff7b1b57247e34a:
+//!     <https://github.com/qoollo/bob/blob/928faef96ced755b75e3396b84febad1ecaf1dae/config-examples/openapi.yaml>
+//!
+//!     This file was modified in order to get rid of the "swagger" crate, which brings
+//!     a lot of unnecessary dependencies (for example, openssl, which can cause problems
+//!     when creating docker images, even if we use only the http client). In addition,
+//!     some refactoring was done to reduce the code size.
+//!
 
 use std::collections::HashMap;