microbootstrap 0.2.2__tar.gz → 0.2.5__tar.gz

{microbootstrap-0.2.2 → microbootstrap-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: microbootstrap
-Version: 0.2.2
+Version: 0.2.5
 Summary: Package for bootstrapping new micro-services
 Keywords: python,microservice,bootstrap,opentelemetry,logging,error-tracing,litestar,fastapi
 Author: community-of-python
@@ -56,7 +56,7 @@ Description-Content-Type: text/markdown
     <a href="https://pypistats.org/packages/microbootstrap" target="_blank"><img src="https://img.shields.io/pypi/dm/microbootstrap"></a>
 </p>
 
-<b>microbootstrap</b> helps you create applications with all necessary instruments already set up.
+<b>microbootstrap</b> assists you in creating applications with all the necessary instruments already set up.
 
 ```python
 # settings.py
@@ -64,7 +64,7 @@ from microbootstrap import LitestarSettings
 
 
 class YourSettings(LitestarSettings):
-    # Your settings stored here
+    # Your settings are stored here
 
 
 settings = YourSettings()
@@ -76,23 +76,23 @@ from microbootstrap.bootstrappers.litestar import LitestarBootstrapper
 
 from your_application.settings import settings
 
-# Litestar application for use!
+# Use the Litestar application!
 application: litestar.Litestar = LitestarBootstrapper(settings).bootstrap()
 ```
 
-Only `litestar` is supported yet.  
-With <b>microbootstrap</b>, you get an application with lightweight built-in support for:
+Currently, only `litestar` is supported.  
+With <b>microbootstrap</b>, you receive an application with lightweight built-in support for:
 
 - `sentry`
 - `prometheus`
 - `opentelemetry`
 - `logging`
 - `cors`
-- `swagger` - additional offline version support
+- `swagger` - with additional offline version support
 
-Interested? Let's jump right into it ⚡
+Interested? Let's dive right in ⚡
 
-## Table of contents
+## Table of Contents
 
 - [Installation](#installation)
 - [Quickstart](#quickstart)
@@ -103,7 +103,7 @@ Interested? Let's jump right into it ⚡
   - [Prometheus](#prometheus)
   - [Opentelemetry](#opentelemetry)
   - [Logging](#logging)
-  - [Cors](#cors)
+  - [CORS](#cors)
   - [Swagger](#swagger)
 - [Configuration](#configuration)
   - [Instruments configuration](#instruments-configuration)
@@ -112,15 +112,15 @@ Interested? Let's jump right into it ⚡
 
 ## Installation
 
-You can install package with `pip` or `poetry`.
+You can install the package using either `pip` or `poetry`.
 
-poetry:
+For poetry:
 
 ```bash
 $ poetry add microbootstrap -E litestar
 ```
 
-pip:
+For pip:
 
 ```bash
 $ pip install microbootstrap[litestar]
@@ -128,7 +128,7 @@ $ pip install microbootstrap[litestar]
 
 ## Quickstart
 
-To manipulate your application, you can use settings object.
+To configure your application, you can use the settings object.
 
 ```python
 from microbootstrap import LitestarSettings
@@ -140,10 +140,10 @@ class YourSettings(LitestarSettings):
     service_name: str = "my-awesome-service"
 
     # Sentry settings
-    sentry_dsn: str = "your-setnry-dsn"
+    sentry_dsn: str = "your-sentry-dsn"
 
     # Prometheus settings
-    prometheus_metrics_path: str "/my-path"
+    prometheus_metrics_path: str = "/my-path"
 
     # Opentelemetry settings
     opentelemetry_container_name: str = "your-container"
@@ -154,7 +154,7 @@ class YourSettings(LitestarSettings):
 settings = YourSettings()
 ```
 
-Then, use the `Bootstrapper` object to create an application based on your settings.
+Next, use the `Bootstrapper` object to create an application based on your settings.
 
 ```python
 import litestar
@@ -163,17 +163,17 @@ from microbootstrap.bootstrappers.litestar import LitestarBootstrapper
 application: litestar.Litestar = LitestarBootstrapper(settings).bootstrap()
 ```
 
-This way, you'll have an application with all the essential instruments already set up for you.
+This approach will provide you with an application that has all the essential instruments already set up for you.
 
 ## Settings
 
-The settings object is at the heart of microbootstrap.
+The settings object is the core of microbootstrap.
 
-All framework-related settings inherit from the `BaseBootstrapSettings` object. `BaseBootstrapSettings` defines parameters for the service and different instruments.
+All framework-related settings inherit from the `BaseBootstrapSettings` object. `BaseBootstrapSettings` defines parameters for the service and various instruments.
 
-However, the number of parameters is <b>not limited</b> to those defined in `BaseBootstrapSettings`. You can add as many as you want.
+However, the number of parameters is <b>not confined</b> to those defined in `BaseBootstrapSettings`. You can add as many as you need.
 
-These parameters can be pulled from your environment. By default, no prefix is added to these parameters.
+These parameters can be sourced from your environment. By default, no prefix is added to these parameters.
 
 Example:
 
@@ -187,9 +187,9 @@ class YourSettings(BaseBootstrapSettings):
     ... # Other settings here
 ```
 
-To pull `your_awesome_parameter` from the environment, set the environment variable with the name `YOUR_AWESOME_PARAMETER`.
+To source `your_awesome_parameter` from the environment, set the environment variable named `YOUR_AWESOME_PARAMETER`.
 
-If you want to use a prefix when pulling parameters, set the `ENVIRONMENT_PREFIX` environment variable beforehand.
+If you prefer to use a prefix when sourcing parameters, set the `ENVIRONMENT_PREFIX` environment variable in advance.
 
 Example:
 
@@ -197,13 +197,13 @@ Example:
 $ export ENVIRONMENT_PREFIX=YOUR_PREFIX_
 ```
 
-Then the settings object will try to pull the variable with the name `YOUR_PREFIX_YOUR_AWESOME_PARAMETER`.
+Then the settings object will attempt to source the variable named `YOUR_PREFIX_YOUR_AWESOME_PARAMETER`.
 
 ## Service settings
 
-Every settings object for every framework contains service parameters that can be used by different instruments.
+Each settings object for every framework includes service parameters that can be utilized by various instruments.
 
-You can set them manually, or set the appropriate environment variables and let <b>microbootstrap</b> pull them automatically.
+You can configure them manually, or set the corresponding environment variables and let <b>microbootstrap</b> to source them automatically.
 
 ```python
 from microbootstrap.bootstrappers.litestar import BaseBootstrapSettings
@@ -222,7 +222,7 @@ class ServiceSettings(BaseBootstrapSettings):
 
 ## Instruments
 
-Currently, these instruments are already supported for bootstrapping:
+At present, the following instruments are supported for bootstrapping:
 
 - `sentry`
 - `prometheus`
@@ -231,12 +231,12 @@ Currently, these instruments are already supported for bootstrapping:
 - `cors`
 - `swagger`
 
-Let's make it clear, what it takes to bootstrap them.
+Let's clarify the process required to bootstrap these instruments.
 
 ### Sentry
 
-To bootstrap Sentry, you need to provide at least the `sentry_dsn`.  
-You can also provide other parameters through the settings object.
+To bootstrap Sentry, you must provide at least the `sentry_dsn`.  
+Additional parameters can also be supplied through the settings object.
 
 ```python
 from microbootstrap.bootstrappers.litestar import BaseBootstrapSettings
@@ -256,12 +256,12 @@ class YourSettings(BaseBootstrapSettings):
     ... # Other settings here
 ```
 
-All these settings are then passed to [sentry-sdk](https://pypi.org/project/sentry-sdk/) package, completing your Sentry integration.
+These settings are subsequently passed to the [sentry-sdk](https://pypi.org/project/sentry-sdk/) package, finalizing your Sentry integration.
 
 ### Prometheus
 
-To bootstrap Prometheus, you need to provide at least the `prometheus_metrics_path`.  
-You can also provide other parameters through the settings object.
+To bootstrap Prometheus, you must provide at least the `prometheus_metrics_path`.  
+Additional parameters can also be supplied through the settings object.
 
 ```python
 from microbootstrap.bootstrappers.litestar import BaseBootstrapSettings
@@ -276,14 +276,14 @@ class YourSettings(BaseBootstrapSettings):
     ... # Other settings here
 ```
 
-These settings will be passed to [prometheus-client](https://pypi.org/project/prometheus-client/).
-Still underlying top-level Prometheus library can change from framework to framework, but overall, you'll get a metrics handler at the provided path.
+These settings are subsequently passed to the [prometheus-client](https://pypi.org/project/prometheus-client/) package.
+The underlying top-level Prometheus library may vary from framework to framework, but in general, a metrics handler will be available at the provided path.
 
-By default, metrics are available at the `/metrics` path.
+By default, metrics are accessible at the `/metrics` path.
 
 ### Opentelemetry
 
-Opentelemetry requires a lot of parameters to be bootstrapped:
+To bootstrap Opentelemetry, you must provide several parameters:
 
 - `service_name`
 - `service_version`
@@ -291,7 +291,7 @@ Opentelemetry requires a lot of parameters to be bootstrapped:
 - `opentelemetry_namespace`
 - `opentelemetry_container_name`.
 
-But you can also provide some more if you need.
+However, additional parameters can also be supplied if needed.
 
 ```python
 from microbootstrap.bootstrappers.litestar import BaseBootstrapSettings
@@ -312,14 +312,14 @@ class YourSettings(BaseBootstrapSettings):
     ... # Other settings here
 ```
 
-All these settings are then passed to [opentelemetry](https://opentelemetry.io/), completing your Opentelemetry integration.
+These settings are subsequently passed to [opentelemetry](https://opentelemetry.io/), finalizing your Opentelemetry integration.
 
 ### Logging
 
-<b>microbootstrap</b> provides in-memory json logging using [structlog](https://pypi.org/project/structlog/).  
-To learn more about in-memory logging, check out [MemoryHandler](https://docs.python.org/3/library/logging.handlers.html#memoryhandler)
+<b>microbootstrap</b> provides in-memory JSON logging through the use of [structlog](https://pypi.org/project/structlog/).  
+For more information on in-memory logging, refer to [MemoryHandler](https://docs.python.org/3/library/logging.handlers.html#memoryhandler).
 
-To use this feature, your application has to be in non-debug mode, i.e. `service_debug` has to be `False`
+To utilize this feature, your application must be in non-debug mode, meaning `service_debug` should be set to `False`.
 
 ```python
 import logging
@@ -328,7 +328,7 @@ from microbootstrap.bootstrappers.litestar import BaseBootstrapSettings
 
 
 class YourSettings(BaseBootstrapSettings):
-    service_debug: bool = True
+    service_debug: bool = False
 
     logging_log_level: int = logging.INFO
     logging_flush_level: int = logging.ERROR
@@ -338,16 +338,16 @@ class YourSettings(BaseBootstrapSettings):
     logging_exclude_endpoints: list[str] = []
 ```
 
-Parameters description:
+Parameter descriptions:
 
-- `logging_log_level` - default log level.
-- `logging_flush_level` - all messages will be flushed from buffer, when log with this level appears.
-- `logging_buffer_capacity` - how much messages your buffer will store, until flushed.
-- `logging_unset_handlers` - unset logger handlers.
-- `logging_extra_processors` - set additional structlog processors if you have some.
-- `logging_exclude_endpoints` - remove logging on certain endpoints.
+- `logging_log_level` - The default log level.
+- `logging_flush_level` - All messages will be flushed from the buffer when a log with this level appears.
+- `logging_buffer_capacity` - The number of messages your buffer will store before being flushed.
+- `logging_unset_handlers` - Unset logger handlers.
+- `logging_extra_processors` - Set additional structlog processors if needed.
+- `logging_exclude_endpoints` - Exclude logging on specific endpoints.
 
-### Cors
+### CORS
 
 ```python
 from microbootstrap.bootstrappers.litestar import BaseBootstrapSettings
@@ -363,15 +363,15 @@ class YourSettings(BaseBootstrapSettings):
     cors_max_age: int = 600
 ```
 
-Parameters description:
+Parameter descriptions:
 
-- `cors_allowed_origins` - list of origins that are allowed.
-- `cors_allowed_methods` - list of allowed HTTP methods.
-- `cors_allowed_headers` - list of allowed headers.
-- `cors_exposed_headers` - list of headers that are exposed via the 'Access-Control-Expose-Headers' header.
-- `cors_allowed_credentials` - boolean dictating whether or not to set the 'Access-Control-Allow-Credentials' header.
-- `cors_allowed_origin_regex` - regex to match origins against.
-- `cors_max_age` - response caching TTL in seconds, defaults to 600.
+- `cors_allowed_origins` - A list of origins that are permitted.
+- `cors_allowed_methods` - A list of HTTP methods that are allowed.
+- `cors_allowed_headers` - A list of headers that are permitted.
+- `cors_exposed_headers` - A list of headers that are exposed via the 'Access-Control-Expose-Headers' header.
+- `cors_allowed_credentials` - A boolean value that dictates whether or not to set the 'Access-Control-Allow-Credentials' header.
+- `cors_allowed_origin_regex` - A regex used to match against origins.
+- `cors_max_age` - The response caching Time-To-Live (TTL) in seconds, defaults to 600.
 
 ### Swagger
 
@@ -390,25 +390,25 @@ class YourSettings(BaseBootstrapSettings):
     swagger_extra_params: dict[str, Any] = {}
 ```
 
-Parameters description:
+Parameter descriptions:
 
-- `service_environment` - will be displayed in docs.
-- `service_name` - will be displayed in docs.
-- `service_description` - will be displayed in docs.
-- `service_static_path` - set additional structlog processors if you have some.
-- `swagger_path` - path of the docs.
-- `swagger_offline_docs` - makes swagger js bundles access offline, because service starts to host via static.
-- `swagger_extra_params` - additional params to pass into openapi config.
+- `service_name` - The name of the service, which will be displayed in the documentation.
+- `service_description` - A brief description of the service, which will also be displayed in the documentation.
+- `service_version` - The current version of the service.
+- `service_static_path` - The path for static files in the service.
+- `swagger_path` - The path where the documentation can be found.
+- `swagger_offline_docs` - A boolean value that, when set to True, allows the Swagger JS bundles to be accessed offline. This is because the service starts to host via static.
+- `swagger_extra_params` - Additional parameters to pass into the OpenAPI configuration.
 
 ## Configuration
 
-Despite settings being pretty convenient mechanism, it's not always possible to store everything in settings.
+While settings provide a convenient mechanism, it's not always feasible to store everything within them.
 
-Sometimes one needs to configure some instrument on the spot, here, how it's being done.
+There may be cases where you need to configure a tool directly. Here's how it can be done.
 
 ### Instruments configuration
 
-To configure instruemt manually, you have to import one of available configs from <b>microbootstrap</b>:
+To manually configure an instrument, you need to import one of the available configurations from <b>microbootstrap</b>:
 
 - `SentryConfig`
 - `OpentelemetryConfig`
@@ -417,7 +417,7 @@ To configure instruemt manually, you have to import one of available configs fro
 - `SwaggerConfig`
 - `CorsConfig`
 
-And pass them into `.configure_instrument` or `.configure_instruments` bootstrapper method.
+These configurations can then be passed into the `.configure_instrument` or `.configure_instruments` bootstrapper methods.
 
 ```python
 import litestar
@@ -429,12 +429,12 @@ from microbootstrap import SentryConfig, OpentelemetryConfig
 application: litestar.Litestar = (
     LitestarBootstrapper(settings)
     .configure_instrument(SentryConfig(sentry_dsn="https://new-dsn"))
-    .configure_instrument(OpentelemetryConfig(sentry_dsn="/new-endpoint"))
+    .configure_instrument(OpentelemetryConfig(opentelemetry_endpoint="/new-endpoint"))
     .bootstrap()
 )
 ```
 
-Or
+Alternatively,
 
 ```python
 import litestar
@@ -455,7 +455,7 @@ application: litestar.Litestar = (
 
 ### Application configuration
 
-Application can be configured similarly
+The application can be configured in a similar manner:
 
 ```python
 import litestar
@@ -471,17 +471,16 @@ async def my_handler() -> str:
 
 application: litestar.Litestar = (
     LitestarBootstrapper(settings)
-    .configur_application(AppConfig(route_handlers=[my_handler]))
+    .configure_application(AppConfig(route_handlers=[my_handler]))
     .bootstrap()
 )
 ```
 
 > ### Important
 >
-> When configuring parameters with simple data types such as: `str`, `int`, `float`, e.t.c.  
-> Those variables are rewriting previous values.
+> When configuring parameters with simple data types such as: `str`, `int`, `float`, etc., these variables overwrite previous values.
 >
-> Example
+> Example:
 >
 > ```python
 > from microbootstrap import LitestarSettings, SentryConfig
@@ -500,13 +499,11 @@ application: litestar.Litestar = (
 > )
 > ```
 >
-> In this example application will be bootstrapped with new `https://my-new-configured-sentry-dsn` sentry dsn
-> instead of old one.
+> In this example, the application will be bootstrapped with the new `https://my-new-configured-sentry-dsn` Sentry DSN, replacing the old one.
 >
-> But if you configure parameters with complex data types such as: `list`, `tuple`, `dict` or `set`.  
-> They are being expanded or merged into each other.
+> However, when you configure parameters with complex data types such as: `list`, `tuple`, `dict`, or `set`, they are expanded or merged.
 >
-> Example
+> Example:
 >
 > ```python
 > from microbootstrap import LitestarSettings, PrometheusConfig
@@ -525,14 +522,12 @@ application: litestar.Litestar = (
 > )
 > ```
 >
-> In this case prometheus will receive `{"first_value: 1", "second_value": 2}` inside `prometheus_additional_params`  
-> This is also true for `list`, `tuple` and `set`
+> In this case, Prometheus will receive `{"first_value": 1, "second_value": 2}` inside `prometheus_additional_params`. This is also true for `list`, `tuple`, and `set`.
 
 ## Advanced
 
-If you miss some instrument, you can add your own.  
-Essentialy, `Instrument` is just a class with some abstractmethods.  
-Every instrument uses some config, so that's first thing, you have to define.
+If you need a specific instrument, you can create your own.
+Essentially, an `Instrument` is just a class with some abstract methods. Each instrument uses a certain configuration, which is the first thing you need to define.
 
 ```python
 from microbootstrap.instruments.base import BaseInstrumentConfig
@@ -543,7 +538,7 @@ class MyInstrumentConfig(BaseInstrumentConfig):
     your_list_parameter: list
 ```
 
-After that, you can create an instrument class, that is inheriting from `Instrument` and accepts your config as generic parameter
+Next, you can create an instrument class that inherits from `Instrument` and accepts your configuration as a generic parameter.
 
 ```python
 from microbootstrap.instruments.base import Instrument
@@ -567,21 +562,20 @@ class MyInstrument(Instrument[MyInstrumentConfig]):
         return MyInstrumentConfig
 ```
 
-And now you can define behaviour of your instrument
+Now, you can define the behavior of your instrument.
 
 Attributes:
 
-- `instrument_name` - Will be displayed in your console during bootstrap.
-- `ready_condition` - Will be displayed in your console during bootstrap if instument is not ready.
+- `instrument_name` - This will be displayed in your console during bootstrap.
+- `ready_condition` - This will be displayed in your console during bootstrap if the instrument is not ready.
 
 Methods:
 
-- `is_ready` - defines ready for bootstrapping state of instrument, based on it's config values. Required.
-- `teardown` - graceful shutdown for instrument during application shutdown. Not required.
-- `bootstrap` - main instrument's logic. Not required.
+- `is_ready` - This defines the readiness of the instrument for bootstrapping, based on its configuration values. This is required.
+- `teardown` - This allows for a graceful shutdown of the instrument during application shutdown. This is not required.
+- `bootstrap` - This is the main logic of the instrument. This is not required.
 
-When you have a carcass of instrument, you can adapt it for every framework existing.  
-Let's adapt it for litestar for example
+Once you have the framework of the instrument, you can adapt it for any existing framework. For instance, let's adapt it for litestar.
 
 ```python
 import litestar
@@ -595,17 +589,16 @@ class LitestarMyInstrument(MyInstrument):
 
     def bootstrap_after(self, application: litestar.Litestar) -> dict[str, typing.Any]:
         pass
-
 ```
 
-To bind instrument to a bootstrapper, you have to use `.use_instrument` decorator.
+To bind the instrument to a bootstrapper, use the `.use_instrument` decorator.
 
-To add some extra parameters to application you can use:
+To add extra parameters to the application, you can use:
 
-- `bootstrap_before` - add some arguments to application config before creation
-- `bootstrap_after` - add some arguments to application after creation
+- `bootstrap_before` - This adds arguments to the application configuration before creation.
+- `bootstrap_after` - This adds arguments to the application after creation.
 
-After that you can use your instrument during bootstrap process
+Afterwards, you can use your instrument during the bootstrap process.
 
 ```python
 import litestar
@@ -628,7 +621,7 @@ application: litestar.Litestar = (
 )
 ```
 
-or you can fill those parameters inside your main settings object
+Alternatively, you can fill these parameters within your main settings object.
 
 ```python
 from microbootstrap import LitestarSettings

{microbootstrap-0.2.2 → microbootstrap-0.2.5}/README.md

@@ -9,7 +9,7 @@
     <a href="https://pypistats.org/packages/microbootstrap" target="_blank"><img src="https://img.shields.io/pypi/dm/microbootstrap"></a>
 </p>
 
-<b>microbootstrap</b> helps you create applications with all necessary instruments already set up.
+<b>microbootstrap</b> assists you in creating applications with all the necessary instruments already set up.
 
 ```python
 # settings.py
@@ -17,7 +17,7 @@ from microbootstrap import LitestarSettings
 
 
 class YourSettings(LitestarSettings):
-    # Your settings stored here
+    # Your settings are stored here
 
 
 settings = YourSettings()
@@ -29,23 +29,23 @@ from microbootstrap.bootstrappers.litestar import LitestarBootstrapper
 
 from your_application.settings import settings
 
-# Litestar application for use!
+# Use the Litestar application!
 application: litestar.Litestar = LitestarBootstrapper(settings).bootstrap()
 ```
 
-Only `litestar` is supported yet.  
-With <b>microbootstrap</b>, you get an application with lightweight built-in support for:
+Currently, only `litestar` is supported.  
+With <b>microbootstrap</b>, you receive an application with lightweight built-in support for:
 
 - `sentry`
 - `prometheus`
 - `opentelemetry`
 - `logging`
 - `cors`
-- `swagger` - additional offline version support
+- `swagger` - with additional offline version support
 
-Interested? Let's jump right into it ⚡
+Interested? Let's dive right in ⚡
 
-## Table of contents
+## Table of Contents
 
 - [Installation](#installation)
 - [Quickstart](#quickstart)
@@ -56,7 +56,7 @@ Interested? Let's jump right into it ⚡
   - [Prometheus](#prometheus)
   - [Opentelemetry](#opentelemetry)
   - [Logging](#logging)
-  - [Cors](#cors)
+  - [CORS](#cors)
   - [Swagger](#swagger)
 - [Configuration](#configuration)
   - [Instruments configuration](#instruments-configuration)
@@ -65,15 +65,15 @@ Interested? Let's jump right into it ⚡
 
 ## Installation
 
-You can install package with `pip` or `poetry`.
+You can install the package using either `pip` or `poetry`.
 
-poetry:
+For poetry:
 
 ```bash
 $ poetry add microbootstrap -E litestar
 ```
 
-pip:
+For pip:
 
 ```bash
 $ pip install microbootstrap[litestar]
@@ -81,7 +81,7 @@ $ pip install microbootstrap[litestar]
 
 ## Quickstart
 
-To manipulate your application, you can use settings object.
+To configure your application, you can use the settings object.
 
 ```python
 from microbootstrap import LitestarSettings
@@ -93,10 +93,10 @@ class YourSettings(LitestarSettings):
     service_name: str = "my-awesome-service"
 
     # Sentry settings
-    sentry_dsn: str = "your-setnry-dsn"
+    sentry_dsn: str = "your-sentry-dsn"
 
     # Prometheus settings
-    prometheus_metrics_path: str "/my-path"
+    prometheus_metrics_path: str = "/my-path"
 
     # Opentelemetry settings
     opentelemetry_container_name: str = "your-container"
@@ -107,7 +107,7 @@ class YourSettings(LitestarSettings):
 settings = YourSettings()
 ```
 
-Then, use the `Bootstrapper` object to create an application based on your settings.
+Next, use the `Bootstrapper` object to create an application based on your settings.
 
 ```python
 import litestar
@@ -116,17 +116,17 @@ from microbootstrap.bootstrappers.litestar import LitestarBootstrapper
 application: litestar.Litestar = LitestarBootstrapper(settings).bootstrap()
 ```
 
-This way, you'll have an application with all the essential instruments already set up for you.
+This approach will provide you with an application that has all the essential instruments already set up for you.
 
 ## Settings
 
-The settings object is at the heart of microbootstrap.
+The settings object is the core of microbootstrap.
 
-All framework-related settings inherit from the `BaseBootstrapSettings` object. `BaseBootstrapSettings` defines parameters for the service and different instruments.
+All framework-related settings inherit from the `BaseBootstrapSettings` object. `BaseBootstrapSettings` defines parameters for the service and various instruments.
 
-However, the number of parameters is <b>not limited</b> to those defined in `BaseBootstrapSettings`. You can add as many as you want.
+However, the number of parameters is <b>not confined</b> to those defined in `BaseBootstrapSettings`. You can add as many as you need.
 
-These parameters can be pulled from your environment. By default, no prefix is added to these parameters.
+These parameters can be sourced from your environment. By default, no prefix is added to these parameters.
 
 Example:
 
@@ -140,9 +140,9 @@ class YourSettings(BaseBootstrapSettings):
     ... # Other settings here
 ```
 
-To pull `your_awesome_parameter` from the environment, set the environment variable with the name `YOUR_AWESOME_PARAMETER`.
+To source `your_awesome_parameter` from the environment, set the environment variable named `YOUR_AWESOME_PARAMETER`.
 
-If you want to use a prefix when pulling parameters, set the `ENVIRONMENT_PREFIX` environment variable beforehand.
+If you prefer to use a prefix when sourcing parameters, set the `ENVIRONMENT_PREFIX` environment variable in advance.
 
 Example:
 
@@ -150,13 +150,13 @@ Example:
 $ export ENVIRONMENT_PREFIX=YOUR_PREFIX_
 ```
 
-Then the settings object will try to pull the variable with the name `YOUR_PREFIX_YOUR_AWESOME_PARAMETER`.
+Then the settings object will attempt to source the variable named `YOUR_PREFIX_YOUR_AWESOME_PARAMETER`.
 
 ## Service settings
 
-Every settings object for every framework contains service parameters that can be used by different instruments.
+Each settings object for every framework includes service parameters that can be utilized by various instruments.
 
-You can set them manually, or set the appropriate environment variables and let <b>microbootstrap</b> pull them automatically.
+You can configure them manually, or set the corresponding environment variables and let <b>microbootstrap</b> to source them automatically.
 
 ```python
 from microbootstrap.bootstrappers.litestar import BaseBootstrapSettings
@@ -175,7 +175,7 @@ class ServiceSettings(BaseBootstrapSettings):
 
 ## Instruments
 
-Currently, these instruments are already supported for bootstrapping:
+At present, the following instruments are supported for bootstrapping:
 
 - `sentry`
 - `prometheus`
@@ -184,12 +184,12 @@ Currently, these instruments are already supported for bootstrapping:
 - `cors`
 - `swagger`
 
-Let's make it clear, what it takes to bootstrap them.
+Let's clarify the process required to bootstrap these instruments.
 
 ### Sentry
 
-To bootstrap Sentry, you need to provide at least the `sentry_dsn`.  
-You can also provide other parameters through the settings object.
+To bootstrap Sentry, you must provide at least the `sentry_dsn`.  
+Additional parameters can also be supplied through the settings object.
 
 ```python
 from microbootstrap.bootstrappers.litestar import BaseBootstrapSettings
@@ -209,12 +209,12 @@ class YourSettings(BaseBootstrapSettings):
     ... # Other settings here
 ```
 
-All these settings are then passed to [sentry-sdk](https://pypi.org/project/sentry-sdk/) package, completing your Sentry integration.
+These settings are subsequently passed to the [sentry-sdk](https://pypi.org/project/sentry-sdk/) package, finalizing your Sentry integration.
 
 ### Prometheus
 
-To bootstrap Prometheus, you need to provide at least the `prometheus_metrics_path`.  
-You can also provide other parameters through the settings object.
+To bootstrap Prometheus, you must provide at least the `prometheus_metrics_path`.  
+Additional parameters can also be supplied through the settings object.
 
 ```python
 from microbootstrap.bootstrappers.litestar import BaseBootstrapSettings
@@ -229,14 +229,14 @@ class YourSettings(BaseBootstrapSettings):
     ... # Other settings here
 ```
 
-These settings will be passed to [prometheus-client](https://pypi.org/project/prometheus-client/).
-Still underlying top-level Prometheus library can change from framework to framework, but overall, you'll get a metrics handler at the provided path.
+These settings are subsequently passed to the [prometheus-client](https://pypi.org/project/prometheus-client/) package.
+The underlying top-level Prometheus library may vary from framework to framework, but in general, a metrics handler will be available at the provided path.
 
-By default, metrics are available at the `/metrics` path.
+By default, metrics are accessible at the `/metrics` path.
 
 ### Opentelemetry
 
-Opentelemetry requires a lot of parameters to be bootstrapped:
+To bootstrap Opentelemetry, you must provide several parameters:
 
 - `service_name`
 - `service_version`
@@ -244,7 +244,7 @@ Opentelemetry requires a lot of parameters to be bootstrapped:
 - `opentelemetry_namespace`
 - `opentelemetry_container_name`.
 
-But you can also provide some more if you need.
+However, additional parameters can also be supplied if needed.
 
 ```python
 from microbootstrap.bootstrappers.litestar import BaseBootstrapSettings
@@ -265,14 +265,14 @@ class YourSettings(BaseBootstrapSettings):
     ... # Other settings here
 ```
 
-All these settings are then passed to [opentelemetry](https://opentelemetry.io/), completing your Opentelemetry integration.
+These settings are subsequently passed to [opentelemetry](https://opentelemetry.io/), finalizing your Opentelemetry integration.
 
 ### Logging
 
-<b>microbootstrap</b> provides in-memory json logging using [structlog](https://pypi.org/project/structlog/).  
-To learn more about in-memory logging, check out [MemoryHandler](https://docs.python.org/3/library/logging.handlers.html#memoryhandler)
+<b>microbootstrap</b> provides in-memory JSON logging through the use of [structlog](https://pypi.org/project/structlog/).  
+For more information on in-memory logging, refer to [MemoryHandler](https://docs.python.org/3/library/logging.handlers.html#memoryhandler).
 
-To use this feature, your application has to be in non-debug mode, i.e. `service_debug` has to be `False`
+To utilize this feature, your application must be in non-debug mode, meaning `service_debug` should be set to `False`.
 
 ```python
 import logging
@@ -281,7 +281,7 @@ from microbootstrap.bootstrappers.litestar import BaseBootstrapSettings
 
 
 class YourSettings(BaseBootstrapSettings):
-    service_debug: bool = True
+    service_debug: bool = False
 
     logging_log_level: int = logging.INFO
     logging_flush_level: int = logging.ERROR
@@ -291,16 +291,16 @@ class YourSettings(BaseBootstrapSettings):
     logging_exclude_endpoints: list[str] = []
 ```
 
-Parameters description:
+Parameter descriptions:
 
-- `logging_log_level` - default log level.
-- `logging_flush_level` - all messages will be flushed from buffer, when log with this level appears.
-- `logging_buffer_capacity` - how much messages your buffer will store, until flushed.
-- `logging_unset_handlers` - unset logger handlers.
-- `logging_extra_processors` - set additional structlog processors if you have some.
-- `logging_exclude_endpoints` - remove logging on certain endpoints.
+- `logging_log_level` - The default log level.
+- `logging_flush_level` - All messages will be flushed from the buffer when a log with this level appears.
+- `logging_buffer_capacity` - The number of messages your buffer will store before being flushed.
+- `logging_unset_handlers` - Unset logger handlers.
+- `logging_extra_processors` - Set additional structlog processors if needed.
+- `logging_exclude_endpoints` - Exclude logging on specific endpoints.
 
-### Cors
+### CORS
 
 ```python
 from microbootstrap.bootstrappers.litestar import BaseBootstrapSettings
@@ -316,15 +316,15 @@ class YourSettings(BaseBootstrapSettings):
     cors_max_age: int = 600
 ```
 
-Parameters description:
+Parameter descriptions:
 
-- `cors_allowed_origins` - list of origins that are allowed.
-- `cors_allowed_methods` - list of allowed HTTP methods.
-- `cors_allowed_headers` - list of allowed headers.
-- `cors_exposed_headers` - list of headers that are exposed via the 'Access-Control-Expose-Headers' header.
-- `cors_allowed_credentials` - boolean dictating whether or not to set the 'Access-Control-Allow-Credentials' header.
-- `cors_allowed_origin_regex` - regex to match origins against.
-- `cors_max_age` - response caching TTL in seconds, defaults to 600.
+- `cors_allowed_origins` - A list of origins that are permitted.
+- `cors_allowed_methods` - A list of HTTP methods that are allowed.
+- `cors_allowed_headers` - A list of headers that are permitted.
+- `cors_exposed_headers` - A list of headers that are exposed via the 'Access-Control-Expose-Headers' header.
+- `cors_allowed_credentials` - A boolean value that dictates whether or not to set the 'Access-Control-Allow-Credentials' header.
+- `cors_allowed_origin_regex` - A regex used to match against origins.
+- `cors_max_age` - The response caching Time-To-Live (TTL) in seconds, defaults to 600.
 
 ### Swagger
 
@@ -343,25 +343,25 @@ class YourSettings(BaseBootstrapSettings):
     swagger_extra_params: dict[str, Any] = {}
 ```
 
-Parameters description:
+Parameter descriptions:
 
-- `service_environment` - will be displayed in docs.
-- `service_name` - will be displayed in docs.
-- `service_description` - will be displayed in docs.
-- `service_static_path` - set additional structlog processors if you have some.
-- `swagger_path` - path of the docs.
-- `swagger_offline_docs` - makes swagger js bundles access offline, because service starts to host via static.
-- `swagger_extra_params` - additional params to pass into openapi config.
+- `service_name` - The name of the service, which will be displayed in the documentation.
+- `service_description` - A brief description of the service, which will also be displayed in the documentation.
+- `service_version` - The current version of the service.
+- `service_static_path` - The path for static files in the service.
+- `swagger_path` - The path where the documentation can be found.
+- `swagger_offline_docs` - A boolean value that, when set to True, allows the Swagger JS bundles to be accessed offline. This is because the service starts to host via static.
+- `swagger_extra_params` - Additional parameters to pass into the OpenAPI configuration.
 
 ## Configuration
 
-Despite settings being pretty convenient mechanism, it's not always possible to store everything in settings.
+While settings provide a convenient mechanism, it's not always feasible to store everything within them.
 
-Sometimes one needs to configure some instrument on the spot, here, how it's being done.
+There may be cases where you need to configure a tool directly. Here's how it can be done.
 
 ### Instruments configuration
 
-To configure instruemt manually, you have to import one of available configs from <b>microbootstrap</b>:
+To manually configure an instrument, you need to import one of the available configurations from <b>microbootstrap</b>:
 
 - `SentryConfig`
 - `OpentelemetryConfig`
@@ -370,7 +370,7 @@ To configure instruemt manually, you have to import one of available configs fro
 - `SwaggerConfig`
 - `CorsConfig`
 
-And pass them into `.configure_instrument` or `.configure_instruments` bootstrapper method.
+These configurations can then be passed into the `.configure_instrument` or `.configure_instruments` bootstrapper methods.
 
 ```python
 import litestar
@@ -382,12 +382,12 @@ from microbootstrap import SentryConfig, OpentelemetryConfig
 application: litestar.Litestar = (
     LitestarBootstrapper(settings)
     .configure_instrument(SentryConfig(sentry_dsn="https://new-dsn"))
-    .configure_instrument(OpentelemetryConfig(sentry_dsn="/new-endpoint"))
+    .configure_instrument(OpentelemetryConfig(opentelemetry_endpoint="/new-endpoint"))
     .bootstrap()
 )
 ```
 
-Or
+Alternatively,
 
 ```python
 import litestar
@@ -408,7 +408,7 @@ application: litestar.Litestar = (
 
 ### Application configuration
 
-Application can be configured similarly
+The application can be configured in a similar manner:
 
 ```python
 import litestar
@@ -424,17 +424,16 @@ async def my_handler() -> str:
 
 application: litestar.Litestar = (
     LitestarBootstrapper(settings)
-    .configur_application(AppConfig(route_handlers=[my_handler]))
+    .configure_application(AppConfig(route_handlers=[my_handler]))
     .bootstrap()
 )
 ```
 
 > ### Important
 >
-> When configuring parameters with simple data types such as: `str`, `int`, `float`, e.t.c.  
-> Those variables are rewriting previous values.
+> When configuring parameters with simple data types such as: `str`, `int`, `float`, etc., these variables overwrite previous values.
 >
-> Example
+> Example:
 >
 > ```python
 > from microbootstrap import LitestarSettings, SentryConfig
@@ -453,13 +452,11 @@ application: litestar.Litestar = (
 > )
 > ```
 >
-> In this example application will be bootstrapped with new `https://my-new-configured-sentry-dsn` sentry dsn
-> instead of old one.
+> In this example, the application will be bootstrapped with the new `https://my-new-configured-sentry-dsn` Sentry DSN, replacing the old one.
 >
-> But if you configure parameters with complex data types such as: `list`, `tuple`, `dict` or `set`.  
-> They are being expanded or merged into each other.
+> However, when you configure parameters with complex data types such as: `list`, `tuple`, `dict`, or `set`, they are expanded or merged.
 >
-> Example
+> Example:
 >
 > ```python
 > from microbootstrap import LitestarSettings, PrometheusConfig
@@ -478,14 +475,12 @@ application: litestar.Litestar = (
 > )
 > ```
 >
-> In this case prometheus will receive `{"first_value: 1", "second_value": 2}` inside `prometheus_additional_params`  
-> This is also true for `list`, `tuple` and `set`
+> In this case, Prometheus will receive `{"first_value": 1, "second_value": 2}` inside `prometheus_additional_params`. This is also true for `list`, `tuple`, and `set`.
 
 ## Advanced
 
-If you miss some instrument, you can add your own.  
-Essentialy, `Instrument` is just a class with some abstractmethods.  
-Every instrument uses some config, so that's first thing, you have to define.
+If you need a specific instrument, you can create your own.
+Essentially, an `Instrument` is just a class with some abstract methods. Each instrument uses a certain configuration, which is the first thing you need to define.
 
 ```python
 from microbootstrap.instruments.base import BaseInstrumentConfig
@@ -496,7 +491,7 @@ class MyInstrumentConfig(BaseInstrumentConfig):
     your_list_parameter: list
 ```
 
-After that, you can create an instrument class, that is inheriting from `Instrument` and accepts your config as generic parameter
+Next, you can create an instrument class that inherits from `Instrument` and accepts your configuration as a generic parameter.
 
 ```python
 from microbootstrap.instruments.base import Instrument
@@ -520,21 +515,20 @@ class MyInstrument(Instrument[MyInstrumentConfig]):
         return MyInstrumentConfig
 ```
 
-And now you can define behaviour of your instrument
+Now, you can define the behavior of your instrument.
 
 Attributes:
 
-- `instrument_name` - Will be displayed in your console during bootstrap.
-- `ready_condition` - Will be displayed in your console during bootstrap if instument is not ready.
+- `instrument_name` - This will be displayed in your console during bootstrap.
+- `ready_condition` - This will be displayed in your console during bootstrap if the instrument is not ready.
 
 Methods:
 
-- `is_ready` - defines ready for bootstrapping state of instrument, based on it's config values. Required.
-- `teardown` - graceful shutdown for instrument during application shutdown. Not required.
-- `bootstrap` - main instrument's logic. Not required.
+- `is_ready` - This defines the readiness of the instrument for bootstrapping, based on its configuration values. This is required.
+- `teardown` - This allows for a graceful shutdown of the instrument during application shutdown. This is not required.
+- `bootstrap` - This is the main logic of the instrument. This is not required.
 
-When you have a carcass of instrument, you can adapt it for every framework existing.  
-Let's adapt it for litestar for example
+Once you have the framework of the instrument, you can adapt it for any existing framework. For instance, let's adapt it for litestar.
 
 ```python
 import litestar
@@ -548,17 +542,16 @@ class LitestarMyInstrument(MyInstrument):
 
     def bootstrap_after(self, application: litestar.Litestar) -> dict[str, typing.Any]:
         pass
-
 ```
 
-To bind instrument to a bootstrapper, you have to use `.use_instrument` decorator.
+To bind the instrument to a bootstrapper, use the `.use_instrument` decorator.
 
-To add some extra parameters to application you can use:
+To add extra parameters to the application, you can use:
 
-- `bootstrap_before` - add some arguments to application config before creation
-- `bootstrap_after` - add some arguments to application after creation
+- `bootstrap_before` - This adds arguments to the application configuration before creation.
+- `bootstrap_after` - This adds arguments to the application after creation.
 
-After that you can use your instrument during bootstrap process
+Afterwards, you can use your instrument during the bootstrap process.
 
 ```python
 import litestar
@@ -581,7 +574,7 @@ application: litestar.Litestar = (
 )
 ```
 
-or you can fill those parameters inside your main settings object
+Alternatively, you can fill these parameters within your main settings object.
 
 ```python
 from microbootstrap import LitestarSettings

{microbootstrap-0.2.2 → microbootstrap-0.2.5}/microbootstrap/bootstrappers/litestar.py

@@ -3,18 +3,17 @@ import typing
 
 import litestar
 import litestar.types
-import sentry_sdk
 import typing_extensions
-from litestar import openapi, status_codes
-from litestar.config.app import AppConfig as LitestarConfig
+from litestar import openapi
 from litestar.config.cors import CORSConfig as LitestarCorsConfig
 from litestar.contrib.opentelemetry.config import OpenTelemetryConfig as LitestarOpentelemetryConfig
 from litestar.contrib.prometheus import PrometheusConfig as LitestarPrometheusConfig
 from litestar.contrib.prometheus import PrometheusController
-from litestar.exceptions.http_exceptions import HTTPException
 from litestar_offline_docs import generate_static_files_config
+from sentry_sdk.integrations.litestar import LitestarIntegration
 
 from microbootstrap.bootstrappers.base import ApplicationBootstrapper
+from microbootstrap.config.litestar import LitestarConfig
 from microbootstrap.instruments.cors_instrument import CorsInstrument
 from microbootstrap.instruments.logging_instrument import LoggingInstrument
 from microbootstrap.instruments.opentelemetry_instrument import OpentelemetryInstrument
@@ -41,19 +40,13 @@ class LitestarBootstrapper(
 
 @LitestarBootstrapper.use_instrument()
 class LitestarSentryInstrument(SentryInstrument):
-    @staticmethod
-    async def sentry_exception_catcher_hook(
-        exception: Exception,
-        _request_scope: litestar.types.Scope,
-    ) -> None:
-        if (
-            not isinstance(exception, HTTPException)
-            or exception.status_code >= status_codes.HTTP_500_INTERNAL_SERVER_ERROR
-        ):
-            sentry_sdk.capture_exception(exception)
-
-    def bootstrap_before(self) -> dict[str, typing.Any]:
-        return {"after_exception": [self.sentry_exception_catcher_hook]}
+    def bootstrap(self) -> None:
+        for sentry_integration in self.instrument_config.sentry_integrations:
+            if isinstance(sentry_integration, LitestarIntegration):
+                break
+        else:
+            self.instrument_config.sentry_integrations.append(LitestarIntegration())
+        super().bootstrap()
 
 
 @LitestarBootstrapper.use_instrument()

microbootstrap-0.2.5/microbootstrap/config/litestar.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+import dataclasses
+import typing
+
+from litestar.config.app import AppConfig
+
+
+if typing.TYPE_CHECKING:
+    from litestar.types import OnAppInitHandler
+
+
+@dataclasses.dataclass
+class LitestarConfig(AppConfig):
+    on_app_init: typing.Sequence[OnAppInitHandler] | None = None

{microbootstrap-0.2.2 → microbootstrap-0.2.5}/pyproject.toml

@@ -26,7 +26,7 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
 ]
-version = "0.2.2"
+version = "0.2.5"
 description = "Package for bootstrapping new micro-services"
 authors = ["community-of-python"]
 readme = "README.md"