ddeutil-workflow 0.0.40__tar.gz → 0.0.42__tar.gz

{ddeutil_workflow-0.0.40/src/ddeutil_workflow.egg-info → ddeutil_workflow-0.0.42}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ddeutil-workflow
-Version: 0.0.40
+Version: 0.0.42
 Summary: Lightweight workflow orchestration
 Author-email: ddeutils <korawich.anu@gmail.com>
 License: MIT
@@ -27,6 +27,12 @@ Requires-Dist: ddeutil-io[toml,yaml]>=0.2.10
 Requires-Dist: pydantic==2.11.1
 Requires-Dist: python-dotenv==1.1.0
 Requires-Dist: schedule<2.0.0,==1.2.2
+Provides-Extra: all
+Requires-Dist: fastapi<1.0.0,>=0.115.0; extra == "all"
+Requires-Dist: httpx; extra == "all"
+Requires-Dist: ujson; extra == "all"
+Requires-Dist: aiofiles; extra == "all"
+Requires-Dist: aiohttp; extra == "all"
 Provides-Extra: api
 Requires-Dist: fastapi<1.0.0,>=0.115.0; extra == "api"
 Requires-Dist: httpx; extra == "api"
@@ -258,7 +264,7 @@ it will use default value and do not raise any error to you.
 | Name                         | Component | Default                                                                                                                         | Description                                                                                                        |
 |:-----------------------------|:---------:|:--------------------------------------------------------------------------------------------------------------------------------|:-------------------------------------------------------------------------------------------------------------------|
 | **ROOT_PATH**                |   Core    | `.`                                                                                                                             | The root path of the workflow application.                                                                         |
-| **REGISTRY**                 |   Core    | `.`                                                                                                                             | List of importable string for the call stage.                                                                      |
+| **REGISTRY_CALLER**          |   Core    | `.`                                                                                                                             | List of importable string for the call stage.                                                                      |
 | **REGISTRY_FILTER**          |   Core    | `ddeutil.workflow.templates`                                                                                                    | List of importable string for the filter template.                                                                 |
 | **CONF_PATH**                |   Core    | `conf`                                                                                                                          | The config path that keep all template `.yaml` files.                                                              |
 | **TIMEZONE**                 |   Core    | `Asia/Bangkok`                                                                                                                  | A Timezone string value that will pass to `ZoneInfo` object.                                                       |
@@ -266,20 +272,17 @@ it will use default value and do not raise any error to you.
 | **STAGE_RAISE_ERROR**        |   Core    | `false`                                                                                                                         | A flag that all stage raise StageException from stage execution.                                                   |
 | **JOB_DEFAULT_ID**           |   Core    | `false`                                                                                                                         | A flag that enable default job ID that use for catch an execution output. The ID that use will be sequence number. |
 | **JOB_RAISE_ERROR**          |   Core    | `true`                                                                                                                          | A flag that all job raise JobException from job strategy execution.                                                |
-| **MAX_NUM_POKING**           |   Core    | `4`                                                                                                                             | .                                                                                                                  |
-| **MAX_JOB_PARALLEL**         |   Core    | `2`                                                                                                                             | The maximum job number that able to run parallel in workflow executor.                                             |
-| **MAX_JOB_EXEC_TIMEOUT**     |   Core    | `600`                                                                                                                           |                                                                                                                    |
 | **MAX_CRON_PER_WORKFLOW**    |   Core    | `5`                                                                                                                             |                                                                                                                    |
 | **MAX_QUEUE_COMPLETE_HIST**  |   Core    | `16`                                                                                                                            |                                                                                                                    |
 | **GENERATE_ID_SIMPLE_MODE**  |   Core    | `true`                                                                                                                          | A flog that enable generating ID with `md5` algorithm.                                                             |
-| **PATH**                     |    Log    | `./logs`                                                                                                                        | The log path of the workflow saving log.                                                                           |
+| **TRACE_PATH**               |    Log    | `./logs`                                                                                                                        | The log path of the workflow saving log.                                                                           |
 | **DEBUG_MODE**               |    Log    | `true`                                                                                                                          | A flag that enable logging with debug level mode.                                                                  |
 | **FORMAT**                   |    Log    | `%(asctime)s.%(msecs)03d (%(name)-10s, %(process)-5d,%(thread)-5d) [%(levelname)-7s] %(message)-120s (%(filename)s:%(lineno)s)` |                                                                                                                    |
 | **FORMAT_FILE**              |    Log    | `{datetime} ({process:5d}, {thread:5d}) {message:120s} ({filename}:{lineno})`                                                   |                                                                                                                    |
 | **DATETIME_FORMAT**          |    Log    | `%Y-%m-%d %H:%M:%S`                                                                                                             |                                                                                                                    |
-| **ENABLE_WRITE**             |    Log    | `false`                                                                                                                         |                                                                                                                    |
-| **PATH**                     |   Audit   | `./audits`                                                                                                                      |                                                                                                                    |
-| **ENABLE_WRITE**             |   Audit   | `true`                                                                                                                          | A flag that enable logging object saving log to its destination.                                                   |
+| **TRACE_ENABLE_WRITE**       |    Log    | `false`                                                                                                                         |                                                                                                                    |
+| **AUDIT_PATH**               |    Log    | `./audits`                                                                                                                      |                                                                                                                    |
+| **AUDIT_ENABLE_WRITE**       |    Log    | `true`                                                                                                                          | A flag that enable logging object saving log to its destination.                                                   |
 | **MAX_PROCESS**              |    App    | `2`                                                                                                                             | The maximum process worker number that run in scheduler app module.                                                |
 | **MAX_SCHEDULE_PER_PROCESS** |    App    | `100`                                                                                                                           | A schedule per process that run parallel.                                                                          |
 | **STOP_BOUNDARY_DELTA**      |    App    | `'{"minutes": 5, "seconds": 20}'`                                                                                               | A time delta value that use to stop scheduler app in json string format.                                           |

{ddeutil_workflow-0.0.40 → ddeutil_workflow-0.0.42}/README.md

@@ -220,7 +220,7 @@ it will use default value and do not raise any error to you.
 | Name                         | Component | Default                                                                                                                         | Description                                                                                                        |
 |:-----------------------------|:---------:|:--------------------------------------------------------------------------------------------------------------------------------|:-------------------------------------------------------------------------------------------------------------------|
 | **ROOT_PATH**                |   Core    | `.`                                                                                                                             | The root path of the workflow application.                                                                         |
-| **REGISTRY**                 |   Core    | `.`                                                                                                                             | List of importable string for the call stage.                                                                      |
+| **REGISTRY_CALLER**          |   Core    | `.`                                                                                                                             | List of importable string for the call stage.                                                                      |
 | **REGISTRY_FILTER**          |   Core    | `ddeutil.workflow.templates`                                                                                                    | List of importable string for the filter template.                                                                 |
 | **CONF_PATH**                |   Core    | `conf`                                                                                                                          | The config path that keep all template `.yaml` files.                                                              |
 | **TIMEZONE**                 |   Core    | `Asia/Bangkok`                                                                                                                  | A Timezone string value that will pass to `ZoneInfo` object.                                                       |
@@ -228,20 +228,17 @@ it will use default value and do not raise any error to you.
 | **STAGE_RAISE_ERROR**        |   Core    | `false`                                                                                                                         | A flag that all stage raise StageException from stage execution.                                                   |
 | **JOB_DEFAULT_ID**           |   Core    | `false`                                                                                                                         | A flag that enable default job ID that use for catch an execution output. The ID that use will be sequence number. |
 | **JOB_RAISE_ERROR**          |   Core    | `true`                                                                                                                          | A flag that all job raise JobException from job strategy execution.                                                |
-| **MAX_NUM_POKING**           |   Core    | `4`                                                                                                                             | .                                                                                                                  |
-| **MAX_JOB_PARALLEL**         |   Core    | `2`                                                                                                                             | The maximum job number that able to run parallel in workflow executor.                                             |
-| **MAX_JOB_EXEC_TIMEOUT**     |   Core    | `600`                                                                                                                           |                                                                                                                    |
 | **MAX_CRON_PER_WORKFLOW**    |   Core    | `5`                                                                                                                             |                                                                                                                    |
 | **MAX_QUEUE_COMPLETE_HIST**  |   Core    | `16`                                                                                                                            |                                                                                                                    |
 | **GENERATE_ID_SIMPLE_MODE**  |   Core    | `true`                                                                                                                          | A flog that enable generating ID with `md5` algorithm.                                                             |
-| **PATH**                     |    Log    | `./logs`                                                                                                                        | The log path of the workflow saving log.                                                                           |
+| **TRACE_PATH**               |    Log    | `./logs`                                                                                                                        | The log path of the workflow saving log.                                                                           |
 | **DEBUG_MODE**               |    Log    | `true`                                                                                                                          | A flag that enable logging with debug level mode.                                                                  |
 | **FORMAT**                   |    Log    | `%(asctime)s.%(msecs)03d (%(name)-10s, %(process)-5d,%(thread)-5d) [%(levelname)-7s] %(message)-120s (%(filename)s:%(lineno)s)` |                                                                                                                    |
 | **FORMAT_FILE**              |    Log    | `{datetime} ({process:5d}, {thread:5d}) {message:120s} ({filename}:{lineno})`                                                   |                                                                                                                    |
 | **DATETIME_FORMAT**          |    Log    | `%Y-%m-%d %H:%M:%S`                                                                                                             |                                                                                                                    |
-| **ENABLE_WRITE**             |    Log    | `false`                                                                                                                         |                                                                                                                    |
-| **PATH**                     |   Audit   | `./audits`                                                                                                                      |                                                                                                                    |
-| **ENABLE_WRITE**             |   Audit   | `true`                                                                                                                          | A flag that enable logging object saving log to its destination.                                                   |
+| **TRACE_ENABLE_WRITE**       |    Log    | `false`                                                                                                                         |                                                                                                                    |
+| **AUDIT_PATH**               |    Log    | `./audits`                                                                                                                      |                                                                                                                    |
+| **AUDIT_ENABLE_WRITE**       |    Log    | `true`                                                                                                                          | A flag that enable logging object saving log to its destination.                                                   |
 | **MAX_PROCESS**              |    App    | `2`                                                                                                                             | The maximum process worker number that run in scheduler app module.                                                |
 | **MAX_SCHEDULE_PER_PROCESS** |    App    | `100`                                                                                                                           | A schedule per process that run parallel.                                                                          |
 | **STOP_BOUNDARY_DELTA**      |    App    | `'{"minutes": 5, "seconds": 20}'`                                                                                               | A time delta value that use to stop scheduler app in json string format.                                           |

{ddeutil_workflow-0.0.40 → ddeutil_workflow-0.0.42}/pyproject.toml

@@ -35,6 +35,13 @@ dependencies = [
 dynamic = ["version"]
 
 [project.optional-dependencies]
+all = [
+    "fastapi>=0.115.0,<1.0.0",
+    "httpx",
+    "ujson",
+    "aiofiles",
+    "aiohttp",
+]
 api = [
     "fastapi>=0.115.0,<1.0.0",
     "httpx",
@@ -97,6 +104,7 @@ markers = [
     "poke: marks tests as slow by poking (deselect with '-m \"not poke\"')",
     "schedule: marks tests as schedule (deselect with '-m \"not schedule\"')",
     "api: marks tests as api (deselect with '-m \"not api\"')",
+    "asyncio: marks async testcases",
 ]
 console_output_style = "count"
 addopts = [

ddeutil_workflow-0.0.42/src/ddeutil/workflow/__about__.py

@@ -0,0 +1 @@
+__version__: str = "0.0.42"

{ddeutil_workflow-0.0.40 → ddeutil_workflow-0.0.42}/src/ddeutil/workflow/__init__.py

@@ -5,17 +5,6 @@
 # ------------------------------------------------------------------------------
 from .__cron import CronJob, CronRunner
 from .__types import Re
-from .audit import (
-    Audit,
-    get_audit,
-)
-from .caller import (
-    ReturnTagFunc,
-    TagFunc,
-    extract_call,
-    make_registry,
-    tag,
-)
 from .conf import (
     Config,
     Loader,
@@ -43,8 +32,10 @@ from .job import (
     local_execute_strategy,
 )
 from .logs import (
+    Audit,
     TraceData,
     TraceLog,
+    get_audit,
     get_dt_tznow,
     get_trace,
 )
@@ -58,7 +49,24 @@ from .params import (
 from .result import (
     Result,
     Status,
-    default_gen_id,
+)
+from .reusables import (
+    FILTERS,
+    FilterFunc,
+    FilterRegistry,
+    ReturnTagFunc,
+    TagFunc,
+    custom_filter,
+    extract_call,
+    get_args_const,
+    has_template,
+    make_filter_registry,
+    make_registry,
+    map_post_filter,
+    not_in_template,
+    param2template,
+    str2template,
+    tag,
 )
 from .scheduler import (
     Schedule,
@@ -77,22 +85,10 @@ from .stages import (
     Stage,
     TriggerStage,
 )
-from .templates import (
-    FILTERS,
-    FilterFunc,
-    FilterRegistry,
-    custom_filter,
-    get_args_const,
-    has_template,
-    make_filter_registry,
-    map_post_filter,
-    not_in_template,
-    param2template,
-    str2template,
-)
 from .utils import (
     batch,
     cross_product,
+    default_gen_id,
     delay,
     filter_func,
     gen_id,

{ddeutil_workflow-0.0.40 → ddeutil_workflow-0.0.42}/src/ddeutil/workflow/api/api.py

@@ -20,7 +20,7 @@ from fastapi.middleware.gzip import GZipMiddleware
 from fastapi.responses import UJSONResponse
 
 from ..__about__ import __version__
-from ..conf import config, get_logger
+from ..conf import api_config, config, get_logger
 from ..scheduler import ReleaseThread, ReleaseThreads
 from ..workflow import ReleaseQueue, WorkflowTask
 from .repeat import repeat_at
@@ -96,24 +96,24 @@ async def health():
 
 
 # NOTE Add the jobs and logs routes by default.
-app.include_router(job, prefix=config.prefix_path)
-app.include_router(log, prefix=config.prefix_path)
+app.include_router(job, prefix=api_config.prefix_path)
+app.include_router(log, prefix=api_config.prefix_path)
 
 
 # NOTE: Enable the workflows route.
-if config.enable_route_workflow:
+if api_config.enable_route_workflow:
     from .routes import workflow
 
-    app.include_router(workflow, prefix=config.prefix_path)
+    app.include_router(workflow, prefix=api_config.prefix_path)
 
 
 # NOTE: Enable the schedules route.
-if config.enable_route_schedule:
-    from ..audit import get_audit
+if api_config.enable_route_schedule:
+    from ..logs import get_audit
     from ..scheduler import schedule_task
     from .routes import schedule
 
-    app.include_router(schedule, prefix=config.prefix_path)
+    app.include_router(schedule, prefix=api_config.prefix_path)
 
     @schedule.on_event("startup")
     @repeat_at(cron="* * * * *", delay=2)

{ddeutil_workflow-0.0.40 → ddeutil_workflow-0.0.42}/src/ddeutil/workflow/api/routes/logs.py

@@ -10,8 +10,7 @@ from fastapi import APIRouter, Path, Query
 from fastapi import status as st
 from fastapi.responses import UJSONResponse
 
-from ...audit import get_audit
-from ...logs import get_trace_obj
+from ...logs import get_audit, get_trace_obj
 
 log_route = APIRouter(
     prefix="/logs",

{ddeutil_workflow-0.0.40 → ddeutil_workflow-0.0.42}/src/ddeutil/workflow/api/routes/schedules.py

@@ -28,7 +28,7 @@ schedule_route = APIRouter(
 async def get_schedules(name: str):
     """Get schedule object."""
     try:
-        schedule: Schedule = Schedule.from_loader(name=name, externals={})
+        schedule: Schedule = Schedule.from_conf(name=name, extras={})
     except ValueError:
         raise HTTPException(
             status_code=st.HTTP_404_NOT_FOUND,
@@ -51,7 +51,7 @@ async def get_deploy_schedulers(request: Request):
 @schedule_route.get(path="/deploy/{name}", status_code=st.HTTP_200_OK)
 async def get_deploy_scheduler(request: Request, name: str):
     if name in request.state.scheduler:
-        schedule = Schedule.from_loader(name)
+        schedule = Schedule.from_conf(name)
         getter: list[dict[str, dict[str, list[datetime]]]] = []
         for workflow in schedule.workflows:
             getter.append(
@@ -94,7 +94,7 @@ async def add_deploy_scheduler(request: Request, name: str):
 
     # NOTE: Create a pair of workflow and on from schedule model.
     try:
-        schedule: Schedule = Schedule.from_loader(name)
+        schedule: Schedule = Schedule.from_conf(name)
     except ValueError as err:
         request.state.scheduler.remove(name)
         logger.exception(err)
@@ -107,7 +107,7 @@ async def add_deploy_scheduler(request: Request, name: str):
         schedule.tasks(
             start_date_waiting,
             queue=request.state.workflow_queue,
-            externals={},
+            extras={},
         ),
     )
     return {
@@ -124,7 +124,7 @@ async def del_deploy_scheduler(request: Request, name: str):
         # NOTE: Remove current schedule name from the state.
         request.state.scheduler.remove(name)
 
-        schedule: Schedule = Schedule.from_loader(name)
+        schedule: Schedule = Schedule.from_conf(name)
 
         for task in schedule.tasks(datetime.now(tz=config.tz), queue={}):
             if task in request.state.workflow_tasks:

{ddeutil_workflow-0.0.40 → ddeutil_workflow-0.0.42}/src/ddeutil/workflow/api/routes/workflows.py

@@ -15,8 +15,8 @@ from fastapi.responses import UJSONResponse
 from pydantic import BaseModel
 
 from ...__types import DictData
-from ...audit import Audit, get_audit
 from ...conf import Loader, get_logger
+from ...logs import Audit, get_audit
 from ...result import Result
 from ...workflow import Workflow
 
@@ -44,7 +44,7 @@ async def get_workflows() -> DictData:
 async def get_workflow_by_name(name: str) -> DictData:
     """Return model of workflow that passing an input workflow name."""
     try:
-        workflow: Workflow = Workflow.from_loader(name=name, externals={})
+        workflow: Workflow = Workflow.from_conf(name=name, extras={})
     except ValueError as err:
         logger.exception(err)
         raise HTTPException(
@@ -69,7 +69,7 @@ class ExecutePayload(BaseModel):
 async def workflow_execute(name: str, payload: ExecutePayload) -> DictData:
     """Return model of workflow that passing an input workflow name."""
     try:
-        workflow: Workflow = Workflow.from_loader(name=name, externals={})
+        workflow: Workflow = Workflow.from_conf(name=name, extras={})
     except ValueError:
         raise HTTPException(
             status_code=st.HTTP_404_NOT_FOUND,

{ddeutil_workflow-0.0.40 → ddeutil_workflow-0.0.42}/src/ddeutil/workflow/conf.py

@@ -12,6 +12,7 @@ from collections.abc import Iterator
 from datetime import timedelta
 from functools import cached_property, lru_cache
 from pathlib import Path
+from typing import Optional, TypeVar
 from zoneinfo import ZoneInfo
 
 from ddeutil.core import str2bool
@@ -20,20 +21,24 @@ from ddeutil.io.paths import glob_files, is_ignored, read_ignore
 
 from .__types import DictData, TupleStr
 
+T = TypeVar("T")
 PREFIX: str = "WORKFLOW"
 
 
 def env(var: str, default: str | None = None) -> str | None:  # pragma: no cov
+    """Get environment variable with uppercase and adding prefix string."""
     return os.getenv(f"{PREFIX}_{var.upper().replace(' ', '_')}", default)
 
 
 __all__: TupleStr = (
+    "api_config",
     "env",
     "get_logger",
     "Config",
     "SimLoad",
     "Loader",
     "config",
+    "dynamic",
 )
 
 
@@ -94,11 +99,19 @@ class Config(BaseConfig):  # pragma: no cov
     # NOTE: Register
     @property
     def regis_call(self) -> list[str]:
-        regis_call_str: str = env("CORE_REGISTRY", ".")
+        """Register Caller module importer str.
+
+        :rtype: list[str]
+        """
+        regis_call_str: str = env("CORE_REGISTRY_CALLER", ".")
         return [r.strip() for r in regis_call_str.split(",")]
 
     @property
     def regis_filter(self) -> list[str]:
+        """Register Filter module.
+
+        :rtype: list[str]
+        """
         regis_filter_str: str = env(
             "CORE_REGISTRY_FILTER", "ddeutil.workflow.templates"
         )
@@ -107,7 +120,7 @@ class Config(BaseConfig):  # pragma: no cov
     # NOTE: Log
     @property
     def log_path(self) -> Path:
-        return Path(env("LOG_PATH", "./logs"))
+        return Path(env("LOG_TRACE_PATH", "./logs"))
 
     @property
     def debug(self) -> bool:
@@ -136,16 +149,15 @@ class Config(BaseConfig):  # pragma: no cov
 
     @property
     def enable_write_log(self) -> bool:
-        return str2bool(env("LOG_ENABLE_WRITE", "false"))
+        return str2bool(env("LOG_TRACE_ENABLE_WRITE", "false"))
 
-    # NOTE: Audit Log
     @property
     def audit_path(self) -> Path:
-        return Path(env("AUDIT_PATH", "./audits"))
+        return Path(env("LOG_AUDIT_PATH", "./audits"))
 
     @property
     def enable_write_audit(self) -> bool:
-        return str2bool(env("AUDIT_ENABLE_WRITE", "false"))
+        return str2bool(env("LOG_AUDIT_ENABLE_WRITE", "false"))
 
     @property
     def log_datetime_format(self) -> str:
@@ -169,29 +181,12 @@ class Config(BaseConfig):  # pragma: no cov
     def job_default_id(self) -> bool:
         return str2bool(env("CORE_JOB_DEFAULT_ID", "false"))
 
-    # NOTE: Workflow
-    @property
-    def max_job_parallel(self) -> int:
-        max_job_parallel = int(env("CORE_MAX_JOB_PARALLEL", "2"))
-
-        # VALIDATE: the MAX_JOB_PARALLEL value should not less than 0.
-        if max_job_parallel < 0:
-            raise ValueError(
-                f"``WORKFLOW_MAX_JOB_PARALLEL`` should more than 0 but got "
-                f"{max_job_parallel}."
-            )
-        return max_job_parallel
-
-    @property
-    def max_job_exec_timeout(self) -> int:
-        return int(env("CORE_MAX_JOB_EXEC_TIMEOUT", "600"))
-
-    @property
-    def max_poking_pool_worker(self) -> int:
-        return int(env("CORE_MAX_NUM_POKING", "4"))
-
     @property
     def max_on_per_workflow(self) -> int:
+        """The maximum on value that store in workflow model.
+
+        :rtype: int
+        """
         return int(env("CORE_MAX_CRON_PER_WORKFLOW", "5"))
 
     @property
@@ -220,7 +215,9 @@ class Config(BaseConfig):  # pragma: no cov
                 f"timedelta with {stop_boundary_delta_str}."
             ) from err
 
-    # NOTE: API
+
+class APIConfig:
+
     @property
     def prefix_path(self) -> str:
         return env("API_PREFIX_PATH", "/api/v1")
@@ -326,7 +323,8 @@ class SimLoad:
     def filter_yaml(cls, file: Path, name: str | None = None) -> DictData:
         if any(file.suffix.endswith(s) for s in (".yml", ".yaml")):
             values: DictData = YamlFlResolve(file).read()
-            return values.get(name, {}) if name else values
+            if values is not None:
+                return values.get(name, {}) if name else values
         return {}
 
     @cached_property
@@ -379,6 +377,29 @@ class Loader(SimLoad):
 
 
 config: Config = Config()
+api_config: APIConfig = APIConfig()
+
+
+def dynamic(
+    key: Optional[str] = None,
+    *,
+    f: Optional[T] = None,
+    extras: Optional[DictData] = None,
+) -> Optional[T]:
+    """Dynamic get config if extra value was passed at run-time.
+
+    :param key: (str) A config key that get from Config object.
+    :param f: An inner config function scope.
+    :param extras: An extra values that pass at run-time.
+    """
+    rsx: Optional[T] = extras[key] if extras and key in extras else None
+    rs: Optional[T] = f or getattr(config, key, None)
+    if rsx is not None and not isinstance(rsx, type(rs)):
+        raise TypeError(
+            f"Type of config {key!r} from extras: {rsx!r} does not valid "
+            f"as config {type(rs)}."
+        )
+    return rsx or rs
 
 
 @lru_cache

{ddeutil_workflow-0.0.40 → ddeutil_workflow-0.0.42}/src/ddeutil/workflow/cron.py

@@ -72,17 +72,16 @@ class On(BaseModel):
 
     model_config = ConfigDict(arbitrary_types_allowed=True)
 
-    # NOTE: This is fields of the base schedule.
     extras: Annotated[
         DictData,
         Field(
             default_factory=dict,
-            description="An extras mapping parameters",
+            description="An extras mapping parameters.",
         ),
     ]
     cronjob: Annotated[
         CronJob,
-        Field(description="Cron job of this schedule"),
+        Field(description="A Cronjob object of this schedule."),
     ]
     tz: Annotated[
         str,
@@ -93,12 +92,12 @@ class On(BaseModel):
     ] = "Etc/UTC"
 
     @classmethod
-    def from_value(cls, value: DictStr, externals: DictData) -> Self:
+    def from_value(cls, value: DictStr, extras: DictData) -> Self:
         """Constructor from values that will generate crontab by function.
 
         :param value: A mapping value that will generate crontab before create
             schedule model.
-        :param externals: An extras external parameter that will keep in extras.
+        :param extras: An extras parameter that will keep in extras.
         """
         passing: DictStr = {}
         if "timezone" in value:
@@ -106,22 +105,22 @@ class On(BaseModel):
         passing["cronjob"] = interval2crontab(
             **{v: value[v] for v in value if v in ("interval", "day", "time")}
         )
-        return cls(extras=externals | passing.pop("extras", {}), **passing)
+        return cls(extras=extras | passing.pop("extras", {}), **passing)
 
     @classmethod
-    def from_loader(
+    def from_conf(
         cls,
         name: str,
-        externals: DictData | None = None,
+        extras: DictData | None = None,
     ) -> Self:
         """Constructor from the name of config that will use loader object for
         getting the data.
 
         :param name: A name of config that will get from loader.
-        :param externals: An extras external parameter that will keep in extras.
+        :param extras: An extra parameter that will keep in extras.
         """
-        externals: DictData = externals or {}
-        loader: Loader = Loader(name, externals=externals)
+        extras: DictData = extras or {}
+        loader: Loader = Loader(name, externals=extras)
 
         # NOTE: Validate the config type match with current connection model
         if loader.type != cls.__name__:
@@ -138,7 +137,7 @@ class On(BaseModel):
                             if v in ("interval", "day", "time")
                         }
                     ),
-                    extras=externals | loader_data.pop("extras", {}),
+                    extras=extras | loader_data.pop("extras", {}),
                     **loader_data,
                 )
             )
@@ -149,7 +148,7 @@ class On(BaseModel):
         return cls.model_validate(
             obj=dict(
                 cronjob=loader_data.pop("cronjob"),
-                extras=externals | loader_data.pop("extras", {}),
+                extras=extras | loader_data.pop("extras", {}),
                 **loader_data,
             )
         )