fabricatio 0.2.0.dev18__tar.gz → 0.2.0.dev20__tar.gz

{fabricatio-0.2.0.dev18 → fabricatio-0.2.0.dev20}/.github/workflows/build-package.yaml

@@ -49,7 +49,7 @@ jobs:
           rustup default nightly
       - name: Install deps
         run: |
-          uv sync --no-install-project  --all-extras
+          uv sync --no-install-project  --all-extras --index https://pypi.org/simple
       - name: Build
         run: |
           make

{fabricatio-0.2.0.dev18 → fabricatio-0.2.0.dev20}/.github/workflows/tests.yaml

@@ -22,8 +22,8 @@ jobs:
 
       - name: Install deps
         run: |
-          uv sync
-
+          uv sync --no-install-project  --all-extras --index https://pypi.org/simple
+          make dev
       - name: Build
         run: |
           pytest tests

{fabricatio-0.2.0.dev18 → fabricatio-0.2.0.dev20}/Cargo.lock

@@ -67,6 +67,18 @@ dependencies = [
  "windows-sys 0.59.0",
 ]
 
+[[package]]
+name = "arrayref"
+version = "0.3.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "76a2e8124351fda1ef8aaaa3bbd7ebbcb486bbcd4225aca0aa0d84bb2db8fecb"
+
+[[package]]
+name = "arrayvec"
+version = "0.7.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7c02d123df017efcdfbd739ef81735b36c5ba83ec3c59c80a9d7ecc718f92e50"
+
 [[package]]
 name = "atomic-waker"
 version = "1.1.2"
@@ -106,6 +118,20 @@ version = "2.8.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "8f68f53c83ab957f72c32642f3868eec03eb974d1fb82e453128456482613d36"
 
+[[package]]
+name = "blake3"
+version = "1.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1230237285e3e10cde447185e8975408ae24deaa67205ce684805c25bc0c7937"
+dependencies = [
+ "arrayref",
+ "arrayvec",
+ "cc",
+ "cfg-if",
+ "constant_time_eq",
+ "memmap2",
+]
+
 [[package]]
 name = "block-buffer"
 version = "0.10.4"
@@ -188,6 +214,12 @@ version = "1.0.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "5b63caa9aa9397e2d9480a9b13673856c78d8ac123288526c37d7839f2a86990"
 
+[[package]]
+name = "constant_time_eq"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7c74b8349d32d297c9134b8c88677813a227df8f779daa29bfc29c183fe3dca6"
+
 [[package]]
 name = "core-foundation"
 version = "0.9.4"
@@ -369,8 +401,11 @@ dependencies = [
 name = "fabricatio"
 version = "0.0.0"
 dependencies = [
+ "blake3",
  "handlebars",
  "pyo3",
+ "pythonize",
+ "serde_json",
  "walkdir",
 ]
 
@@ -910,6 +945,15 @@ version = "2.7.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "78ca9ab1a0babb1e7d5695e3530886289c18cf2f87ec19a575a0abdce112e3a3"
 
+[[package]]
+name = "memmap2"
+version = "0.9.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fd3f7eed9d3848f8b98834af67102b720745c4ec028fcd0aa0239277e7de374f"
+dependencies = [
+ "libc",
+]
+
 [[package]]
 name = "memoffset"
 version = "0.9.1"
@@ -1189,6 +1233,16 @@ dependencies = [
  "syn",
 ]
 
+[[package]]
+name = "pythonize"
+version = "0.23.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "91a6ee7a084f913f98d70cdc3ebec07e852b735ae3059a1500db2661265da9ff"
+dependencies = [
+ "pyo3",
+ "serde",
+]
+
 [[package]]
 name = "quote"
 version = "1.0.38"

{fabricatio-0.2.0.dev18 → fabricatio-0.2.0.dev20}/Cargo.toml

@@ -6,8 +6,11 @@ edition = "2024"
 crate-type = ["cdylib"]
 
 [dependencies]
+blake3 = "1.6.0"
 handlebars = "6.3.1"
 pyo3 = { version = "0.23.4", features = ["extension-module"] }
+pythonize = "0.23.0"
+serde_json = "1.0.138"
 walkdir = "2.5.0"
 
 [workspace]

{fabricatio-0.2.0.dev18 → fabricatio-0.2.0.dev20}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fabricatio
-Version: 0.2.0.dev18
+Version: 0.2.0.dev20
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: 3.12
@@ -10,6 +10,7 @@ Classifier: Framework :: Pydantic :: 2
 Classifier: Typing :: Typed
 Requires-Dist: appdirs>=1.4.4
 Requires-Dist: asyncio>=3.4.3
+Requires-Dist: asyncstdlib>=3.13.0
 Requires-Dist: code2prompt
 Requires-Dist: gitpython>=3.1.44
 Requires-Dist: litellm>=1.60.0
@@ -47,26 +48,28 @@ Fabricatio is a powerful framework designed to facilitate the creation and manag
 
 - [Installation](#installation)
 - [Usage](#usage)
-    - [Defining a Task](#defining-a-task)
-    - [Creating an Action](#creating-an-action)
-    - [Assigning a Role](#assigning-a-role)
-    - [Logging](#logging)
+  - [Defining a Task](#defining-a-task)
+  - [Creating an Action](#creating-an-action)
+  - [Assigning a Role](#assigning-a-role)
+  - [Logging](#logging)
 - [Configuration](#configuration)
-    - [LLM Configuration](#llm-configuration)
-    - [Debug Configuration](#debug-configuration)
+  - [LLM Configuration](#llm-configuration)
+  - [Debug Configuration](#debug-configuration)
 - [Examples](#examples)
-    - [Simple Task Example](#simple-task-example)
-    - [Complex Workflow Example](#complex-workflow-example)
+  - [Simple Task Example](#simple-task-example)
+  - [Complex Workflow Example](#complex-workflow-example)
 - [Contributing](#contributing)
 - [License](#license)
 
 ## Installation
+
 To install Fabricatio, you can use pip:
 
 ```bash
 pip install fabricatio
 ```
 
+
 Alternatively, you can clone the repository and install it manually:
 
 ```bash
@@ -231,3 +234,109 @@ Contributions to Fabricatio are welcome! Please submit a pull request with your
 
 Fabricatio is licensed under the MIT License. See the [LICENSE](LICENSE) file for more information.
 
+---
+
+### Additional Features and Modules
+
+#### Advanced Models and Functionalities
+
+The `advanced.py` module provides advanced models and functionalities for handling complex tasks and workflows.
+
+```python
+from fabricatio.models.advanced import ProposeTask, HandleTask
+
+class ProposeTaskExample(ProposeTask):
+    pass
+
+class HandleTaskExample(HandleTask):
+    pass
+```
+
+
+#### Toolboxes
+
+Fabricatio includes various toolboxes for different types of operations. For example, the `arithmetic.py` toolbox provides arithmetic operations.
+
+```python
+from fabricatio.toolboxes.arithmetic import add, subtract, multiply, divide
+
+result = add(1, 2)
+print(result)  # Output: 3
+```
+
+
+#### File System Operations
+
+The `fs.py` toolbox offers tools for file system operations such as copying, moving, deleting files, and creating directories.
+
+```python
+from fabricatio.toolboxes.fs import copy_file, move_file, delete_file, create_directory
+
+copy_file("source.txt", "destination.txt")
+move_file("old_location.txt", "new_location.txt")
+delete_file("file_to_delete.txt")
+create_directory("new_directory")
+```
+
+
+#### Logging Setup
+
+The logging setup in Fabricatio is handled by the `journal.py` module, which configures Loguru for logging.
+
+```python
+from fabricatio.journal import logger
+
+logger.debug("This is a debug message.")
+logger.info("This is an info message.")
+logger.success("This is a success message.")
+logger.warning("This is a warning message.")
+logger.error("This is an error message.")
+logger.critical("This is a critical message.")
+```
+
+
+#### Configuration Management
+
+The configuration management in Fabricatio is handled by the `config.py` module, which uses Pydantic for defining and validating configurations.
+
+```python
+from fabricatio.config import Settings, LLMConfig, DebugConfig
+
+settings = Settings()
+llm_config = LLMConfig(api_endpoint="https://api.example.com")
+debug_config = DebugConfig(log_level="DEBUG", log_file="fabricatio.log")
+```
+
+
+#### Testing
+
+Fabricatio includes a suite of test cases to ensure the stability and correctness of the codebase. The tests are located in the `tests` directory and cover various modules and functionalities.
+
+```python
+# Example of a test case for the config module
+import pytest
+from fabricatio.config import DebugConfig
+
+def test_debug_config_initialization():
+    temp_log_file = "fabricatio.log"
+    debug_config = DebugConfig(log_level="DEBUG", log_file=temp_log_file)
+    assert debug_config.log_level == "DEBUG"
+    assert str(debug_config.log_file) == temp_log_file
+```
+
+
+---
+
+### Conclusion
+
+Fabricatio is a versatile and powerful framework for managing tasks, actions, and workflows. It provides a robust set of tools and features to facilitate task automation and orchestration. Whether you're building a simple script or a complex application, Fabricatio has the capabilities to meet your needs.
+
+For more detailed information and examples, please refer to the [official documentation](https://fabricatio.readthedocs.io).
+
+---
+
+If you have any questions or need further assistance, feel free to reach out to the community or open an issue on the GitHub repository.
+
+Happy coding!
+
+

{fabricatio-0.2.0.dev18 → fabricatio-0.2.0.dev20}/README.md

@@ -8,26 +8,28 @@ Fabricatio is a powerful framework designed to facilitate the creation and manag
 
 - [Installation](#installation)
 - [Usage](#usage)
-    - [Defining a Task](#defining-a-task)
-    - [Creating an Action](#creating-an-action)
-    - [Assigning a Role](#assigning-a-role)
-    - [Logging](#logging)
+  - [Defining a Task](#defining-a-task)
+  - [Creating an Action](#creating-an-action)
+  - [Assigning a Role](#assigning-a-role)
+  - [Logging](#logging)
 - [Configuration](#configuration)
-    - [LLM Configuration](#llm-configuration)
-    - [Debug Configuration](#debug-configuration)
+  - [LLM Configuration](#llm-configuration)
+  - [Debug Configuration](#debug-configuration)
 - [Examples](#examples)
-    - [Simple Task Example](#simple-task-example)
-    - [Complex Workflow Example](#complex-workflow-example)
+  - [Simple Task Example](#simple-task-example)
+  - [Complex Workflow Example](#complex-workflow-example)
 - [Contributing](#contributing)
 - [License](#license)
 
 ## Installation
+
 To install Fabricatio, you can use pip:
 
 ```bash
 pip install fabricatio
 ```
 
+
 Alternatively, you can clone the repository and install it manually:
 
 ```bash
@@ -191,3 +193,109 @@ Contributions to Fabricatio are welcome! Please submit a pull request with your
 ## License
 
 Fabricatio is licensed under the MIT License. See the [LICENSE](LICENSE) file for more information.
+
+---
+
+### Additional Features and Modules
+
+#### Advanced Models and Functionalities
+
+The `advanced.py` module provides advanced models and functionalities for handling complex tasks and workflows.
+
+```python
+from fabricatio.models.advanced import ProposeTask, HandleTask
+
+class ProposeTaskExample(ProposeTask):
+    pass
+
+class HandleTaskExample(HandleTask):
+    pass
+```
+
+
+#### Toolboxes
+
+Fabricatio includes various toolboxes for different types of operations. For example, the `arithmetic.py` toolbox provides arithmetic operations.
+
+```python
+from fabricatio.toolboxes.arithmetic import add, subtract, multiply, divide
+
+result = add(1, 2)
+print(result)  # Output: 3
+```
+
+
+#### File System Operations
+
+The `fs.py` toolbox offers tools for file system operations such as copying, moving, deleting files, and creating directories.
+
+```python
+from fabricatio.toolboxes.fs import copy_file, move_file, delete_file, create_directory
+
+copy_file("source.txt", "destination.txt")
+move_file("old_location.txt", "new_location.txt")
+delete_file("file_to_delete.txt")
+create_directory("new_directory")
+```
+
+
+#### Logging Setup
+
+The logging setup in Fabricatio is handled by the `journal.py` module, which configures Loguru for logging.
+
+```python
+from fabricatio.journal import logger
+
+logger.debug("This is a debug message.")
+logger.info("This is an info message.")
+logger.success("This is a success message.")
+logger.warning("This is a warning message.")
+logger.error("This is an error message.")
+logger.critical("This is a critical message.")
+```
+
+
+#### Configuration Management
+
+The configuration management in Fabricatio is handled by the `config.py` module, which uses Pydantic for defining and validating configurations.
+
+```python
+from fabricatio.config import Settings, LLMConfig, DebugConfig
+
+settings = Settings()
+llm_config = LLMConfig(api_endpoint="https://api.example.com")
+debug_config = DebugConfig(log_level="DEBUG", log_file="fabricatio.log")
+```
+
+
+#### Testing
+
+Fabricatio includes a suite of test cases to ensure the stability and correctness of the codebase. The tests are located in the `tests` directory and cover various modules and functionalities.
+
+```python
+# Example of a test case for the config module
+import pytest
+from fabricatio.config import DebugConfig
+
+def test_debug_config_initialization():
+    temp_log_file = "fabricatio.log"
+    debug_config = DebugConfig(log_level="DEBUG", log_file=temp_log_file)
+    assert debug_config.log_level == "DEBUG"
+    assert str(debug_config.log_file) == temp_log_file
+```
+
+
+---
+
+### Conclusion
+
+Fabricatio is a versatile and powerful framework for managing tasks, actions, and workflows. It provides a robust set of tools and features to facilitate task automation and orchestration. Whether you're building a simple script or a complex application, Fabricatio has the capabilities to meet your needs.
+
+For more detailed information and examples, please refer to the [official documentation](https://fabricatio.readthedocs.io).
+
+---
+
+If you have any questions or need further assistance, feel free to reach out to the community or open an issue on the GitHub repository.
+
+Happy coding!
+

fabricatio-0.2.0.dev20/examples/llm_usages/llm_usage.py

@@ -0,0 +1,60 @@
+"""Example of using the library."""
+
+import asyncio
+
+from fabricatio import Action, Role, Task, WorkFlow
+from fabricatio.journal import logger
+from fabricatio.models.events import Event
+from fabricatio.parser import PythonCapture
+
+
+class WriteCode(Action):
+    """Action that says hello to the world."""
+
+    name: str = "write code"
+    output_key: str = "task_output"
+
+    async def _execute(self, task_input: Task[str], **_) -> str:
+        return await self.aask_validate(
+            task_input.briefing,
+            validator=PythonCapture.capture,
+        )
+
+
+class WriteDocumentation(Action):
+    """Action that says hello to the world."""
+
+    name: str = "write documentation"
+    description: str = "write documentation for the code in markdown format"
+    output_key: str = "task_output"
+
+    async def _execute(self, task_input: Task[str], **_) -> str:
+        return await self.aask(task_input.briefing, task_input.dependencies_prompt)
+
+
+async def main() -> None:
+    """Main function."""
+    role = Role(
+        name="Coder",
+        description="A python coder who can write code and documentation",
+        registry={
+            Event.instantiate_from("coding.*").push("pending"): WorkFlow(name="write code", steps=(WriteCode,)),
+            Event.instantiate_from("doc.*").push("pending"): WorkFlow(
+                name="write documentation", steps=(WriteDocumentation,)
+            ),
+        },
+    )
+
+    prompt = "write a python cli app which can add a list of numbers writen in a file together,with detailed google style documentation."
+
+    proposed_task = await role.propose(prompt)
+    code = await proposed_task.move_to("coding").delegate()
+    logger.success(f"Code: \n{code}")
+
+    proposed_task = await role.propose(f"{code} \n\n write Readme.md file for the code.")
+    doc = await proposed_task.move_to("doc").delegate()
+    logger.success(f"Documentation: \n{doc}")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

{fabricatio-0.2.0.dev18 → fabricatio-0.2.0.dev20}/examples/propose_task/propose.py

@@ -14,7 +14,7 @@ class Talk(Action):
     name: str = "talk"
     output_key: str = "task_output"
 
-    async def _execute(self, task_input: Task[str], **_) -> Any:
+    async def _execute(self, **_) -> Any:
         ret = "Hello fabricatio!"
         logger.info("executing talk action")
         return ret
@@ -25,7 +25,7 @@ async def main() -> None:
     role = Role(
         name="talker", description="talker role", registry={task.pending_label: WorkFlow(name="talk", steps=(Talk,))}
     )
-    logger.info(Task.json_example())
+    logger.info(f"Task example:\n{Task.json_example()}")
     logger.info(f"proposed task: {await role.propose('write a rust clap cli that can download a html page')}")
 
 

{fabricatio-0.2.0.dev18 → fabricatio-0.2.0.dev20}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fabricatio"
-version = "0.2.0-dev.18"
+version = "0.2.0-dev.20"
 description = "A LLM multi-agent framework."
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -29,6 +29,7 @@ requires-python = ">=3.12"
 dependencies = [
     "appdirs>=1.4.4",
     "asyncio>=3.4.3",
+    "asyncstdlib>=3.13.0",
     "code2prompt",
     "gitpython>=3.1.44",
     "litellm>=1.60.0",
@@ -137,6 +138,8 @@ addopts = "-ra -q"
 testpaths = [
     "tests",
 ]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
 
 [tool.uv.sources]
 code2prompt = { git = "https://github.com/mufeedvh/code2prompt", rev = "d157ee84827458bd6816142e213886487d28bd3d" }

{fabricatio-0.2.0.dev18 → fabricatio-0.2.0.dev20}/python/fabricatio/__init__.py

@@ -11,6 +11,7 @@ from fabricatio.models.task import Task
 from fabricatio.models.tool import ToolBox
 from fabricatio.models.utils import Message, Messages
 from fabricatio.parser import Capture, CodeBlockCapture, JsonCapture, PythonCapture
+from fabricatio.toolboxes import arithmetic_toolbox, basic_toolboxes, fs_toolbox, task_toolbox
 
 __all__ = [
     "Action",
@@ -25,8 +26,12 @@ __all__ = [
     "Task",
     "ToolBox",
     "WorkFlow",
+    "arithmetic_toolbox",
+    "basic_toolboxes",
     "env",
+    "fs_toolbox",
     "logger",
     "magika",
+    "task_toolbox",
     "template_manager",
 ]

{fabricatio-0.2.0.dev18 → fabricatio-0.2.0.dev20}/python/fabricatio/_rust.pyi

@@ -2,40 +2,30 @@ from pathlib import Path
 from typing import Any, Dict, List, Optional
 
 class TemplateManager:
-    def __init__(self, template_dirs: List[Path], suffix: Optional[str] = None) -> None:
+    """TemplateManager class for managing handlebars templates."""
+    def __init__(
+        self, template_dirs: List[Path], suffix: Optional[str] = None, active_loading: Optional[bool] = None
+    ) -> None:
         """Initialize the template manager.
 
         Args:
             template_dirs (List[Path]): A list of paths to directories containing templates.
-            suffix (str, optional): The suffix of template files. None means 'hbs' suffix .
+            suffix (str, optional): The suffix of template files. None means 'hbs' suffix.
+            active_loading (bool, optional): Whether to enable active loading of templates.
         """
 
     @property
     def template_count(self) -> int:
         """Get the number of templates discovered."""
 
-    @property
-    def templates(self) -> List[str]:
-        """Get a list of template names."""
-
-    def get_template(self, name: str) -> str:
-        """Get a template by name.
-
-        Args:
-            name (str): The name of the template to retrieve.
-
-        Returns:
-            str: The template content.
-        """
-
-    def get_template_source(self, name: str) -> str:
+    def get_template_source(self, name: str) -> Optional[str]:
         """Get the source path of a template by name.
 
         Args:
             name (str): The name of the template to retrieve.
 
         Returns:
-            str: The source path of the template.
+            Optional[str]: The source path of the template.
         """
 
     def discover_templates(self) -> None:
@@ -51,3 +41,13 @@ class TemplateManager:
         Returns:
             str: The rendered template.
         """
+
+def blake3_hash(content: bytes) -> str:
+    """Calculate the BLAKE3 hash of the given data.
+
+    Args:
+        content (bytes): The data to hash.
+
+    Returns:
+        str: The BLAKE3 hash of the data.
+    """

fabricatio-0.2.0.dev20/python/fabricatio/_rust_instances.py

@@ -0,0 +1,8 @@
+from fabricatio._rust import TemplateManager
+from fabricatio.config import configs
+
+template_manager = TemplateManager(
+    template_dirs=configs.templates.template_dir,
+    suffix=configs.templates.template_suffix,
+    active_loading=configs.templates.active_loading,
+)

{fabricatio-0.2.0.dev18 → fabricatio-0.2.0.dev20}/python/fabricatio/actions/communication.py

@@ -12,4 +12,4 @@ class Talk(Action):
 
     async def _execute(self, task_input: Task[str], **_) -> str:
         """Execute the action."""
-        return await self.aask(task_input.briefing, system_message=task_input.generate_prompt())
+        return await self.aask(task_input.briefing, system_message=task_input.dependencies_prompt())