basic-open-agent-tools 0.2.0__tar.gz → 0.3.0__tar.gz

{basic_open_agent_tools-0.2.0 → basic_open_agent_tools-0.3.0}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Open Agent Tools
+Copyright (c) 2024 Open Agent Tools
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

{basic_open_agent_tools-0.2.0 → basic_open_agent_tools-0.3.0}/PKG-INFO

@@ -1,38 +1,17 @@
 Metadata-Version: 2.4
 Name: basic-open-agent-tools
-Version: 0.2.0
+Version: 0.3.0
 Summary: An open foundational toolkit providing essential components for building AI agents with minimal dependencies for local (non-HTTP/API) actions.
+Home-page: https://github.com/open-agent-tools/basic-open-agent-tools
+Author: Open Agent Tools
+Author-email: Open Agent Tools <unseriousai@gmail.com>
 Project-URL: Homepage, https://github.com/open-agent-tools/basic-open-agent-tools
 Project-URL: Documentation, https://github.com/open-agent-tools/basic-open-agent-tools#readme
 Project-URL: Repository, https://github.com/open-agent-tools/basic-open-agent-tools
 Project-URL: Issues, https://github.com/open-agent-tools/basic-open-agent-tools/issues
-Author-email: Open Agent Tools <info@openagenttools.org>
-License: MIT License
-        
-        Copyright (c) 2025 Open Agent Tools
-        
-        Permission is hereby granted, free of charge, to any person obtaining a copy
-        of this software and associated documentation files (the "Software"), to deal
-        in the Software without restriction, including without limitation the rights
-        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-        copies of the Software, and to permit persons to whom the Software is
-        furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in all
-        copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-        SOFTWARE.
-License-File: LICENSE
-Keywords: agents,ai,automation,local-tools,toolkit
+Keywords: ai,agents,toolkit,automation,local-tools
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.8
@@ -40,19 +19,24 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
 Provides-Extra: dev
-Requires-Dist: mypy>=1.0.0; extra == 'dev'
-Requires-Dist: pre-commit>=3.0.0; extra == 'dev'
-Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
-Requires-Dist: pytest>=7.0.0; extra == 'dev'
-Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: pre-commit>=3.0.0; extra == "dev"
 Provides-Extra: test
-Requires-Dist: pytest-cov>=4.0.0; extra == 'test'
-Requires-Dist: pytest>=7.0.0; extra == 'test'
-Description-Content-Type: text/markdown
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: pytest-cov>=4.0.0; extra == "test"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
 
 # basic-open-agent-tools
 
@@ -72,19 +56,22 @@ uv add basic-open-agent-tools
 ## Quick Start
 
 ```python
-
 import logging
 import warnings
 from dotenv import load_dotenv
 from google.adk.agents import Agent
 from google.adk.models.lite_llm import LiteLlm
-from basic_open_agent_tools.file_system.operations import (
-    append_to_file, copy_file, create_directory, delete_directory, delete_file,
-    list_directory_contents, move_file, read_file_to_string, write_file_from_string,
-)
-from basic_open_agent_tools.file_system.info import (
-    directory_exists, file_exists, get_file_info, get_file_size, is_empty_directory,
-)
+
+import basic_open_agent_tools as boat
+
+# Load tools by category
+fs_tools = boat.load_all_filesystem_tools()    # 18 functions
+text_tools = boat.load_all_text_tools()       # 10 functions
+data_tools = boat.load_all_data_tools()       # 28 functions (Phase 1 ✅)
+
+# Merge for agent use (automatically deduplicates)
+agent_tools = boat.merge_tool_lists(fs_tools, text_tools, data_tools)
+
 
 load_dotenv()
 
@@ -108,13 +95,45 @@ file_ops_agent = Agent(
     name="FileOps",
     instruction=agent_instruction,
     description="Specialized file and directory operations sub-agent for the Python developer.",
-    tools=[
-        append_to_file, copy_file, create_directory, delete_directory, delete_file,
-        directory_exists, file_exists, get_file_info, get_file_size, is_empty_directory,
-        list_directory_contents, move_file, read_file_to_string, write_file_from_string,
-    ],
+    tools=agent_tools,
 )
 
+"""
+The above would load:
+
+File and Directory Operations:
+    read_file_to_string
+    write_file_from_string
+    append_to_file
+    list_directory_contents
+    create_directory
+    delete_file
+    delete_directory
+    move_file
+    copy_file
+    get_file_info
+    file_exists
+    directory_exists
+    get_file_size
+    is_empty_directory
+    list_all_directory_contents
+    generate_directory_tree
+    validate_path
+    validate_file_content
+
+Text Processing Tools:
+    clean_whitespace
+    normalize_line_endings
+    strip_html_tags
+    normalize_unicode
+    to_snake_case
+    to_camel_case
+    to_title_case
+    smart_split_lines
+    extract_sentences
+    join_with_oxford_comma
+
+"""
 
 ```
 
@@ -127,19 +146,35 @@ file_ops_agent = Agent(
 
 ## Current Features
 
-### File System Tools
+### File System Tools ✅ (18 functions)
 - File operations (read, write, append, delete, copy, move)
 - Directory operations (create, list, delete, tree visualization)
 - File information and existence checking
 - Path validation and error handling
 
-### Planned Modules
-- HTTP request utilities
-- Text processing and manipulation
-- Data parsing and conversion
-- System information and process management
-- Cryptographic utilities
-- Common helper functions
+### Text Processing Tools ✅ (10 functions)
+- Text cleaning and normalization
+- Case conversion utilities (snake_case, camelCase, Title Case)
+- Smart text splitting and sentence extraction
+- HTML tag removal and Unicode normalization
+
+### Data Tools ✅ (28 functions - Phase 1 Complete)
+**Phase 1 ✅**: Data structures, JSON/CSV processing, validation (28 functions)
+- Data structure manipulation (flatten, merge, nested access)
+- JSON serialization with compression and validation  
+- CSV file processing and data cleaning
+- Schema validation and data type checking
+
+**Phase 2 📋**: Object serialization, configuration files (15 functions)
+**Phase 3 📋**: Data transformation, YAML/TOML support (16 functions)  
+**Phase 4 📋**: Binary data, archives, streaming (18 functions)
+**Phase 5 📋**: Caching, database processing (13 functions)
+
+### Future Modules 🚧
+- **Network Tools** - HTTP utilities, API helpers
+- **System Tools** - Process management, system information  
+- **Crypto Tools** - Hashing, encoding, basic cryptographic utilities
+- **Utilities** - Development and debugging helpers
 
 ## Contributing
 

{basic_open_agent_tools-0.2.0 → basic_open_agent_tools-0.3.0}/README.md

@@ -16,19 +16,22 @@ uv add basic-open-agent-tools
 ## Quick Start
 
 ```python
-
 import logging
 import warnings
 from dotenv import load_dotenv
 from google.adk.agents import Agent
 from google.adk.models.lite_llm import LiteLlm
-from basic_open_agent_tools.file_system.operations import (
-    append_to_file, copy_file, create_directory, delete_directory, delete_file,
-    list_directory_contents, move_file, read_file_to_string, write_file_from_string,
-)
-from basic_open_agent_tools.file_system.info import (
-    directory_exists, file_exists, get_file_info, get_file_size, is_empty_directory,
-)
+
+import basic_open_agent_tools as boat
+
+# Load tools by category
+fs_tools = boat.load_all_filesystem_tools()    # 18 functions
+text_tools = boat.load_all_text_tools()       # 10 functions
+data_tools = boat.load_all_data_tools()       # 28 functions (Phase 1 ✅)
+
+# Merge for agent use (automatically deduplicates)
+agent_tools = boat.merge_tool_lists(fs_tools, text_tools, data_tools)
+
 
 load_dotenv()
 
@@ -52,13 +55,45 @@ file_ops_agent = Agent(
     name="FileOps",
     instruction=agent_instruction,
     description="Specialized file and directory operations sub-agent for the Python developer.",
-    tools=[
-        append_to_file, copy_file, create_directory, delete_directory, delete_file,
-        directory_exists, file_exists, get_file_info, get_file_size, is_empty_directory,
-        list_directory_contents, move_file, read_file_to_string, write_file_from_string,
-    ],
+    tools=agent_tools,
 )
 
+"""
+The above would load:
+
+File and Directory Operations:
+    read_file_to_string
+    write_file_from_string
+    append_to_file
+    list_directory_contents
+    create_directory
+    delete_file
+    delete_directory
+    move_file
+    copy_file
+    get_file_info
+    file_exists
+    directory_exists
+    get_file_size
+    is_empty_directory
+    list_all_directory_contents
+    generate_directory_tree
+    validate_path
+    validate_file_content
+
+Text Processing Tools:
+    clean_whitespace
+    normalize_line_endings
+    strip_html_tags
+    normalize_unicode
+    to_snake_case
+    to_camel_case
+    to_title_case
+    smart_split_lines
+    extract_sentences
+    join_with_oxford_comma
+
+"""
 
 ```
 
@@ -71,19 +106,35 @@ file_ops_agent = Agent(
 
 ## Current Features
 
-### File System Tools
+### File System Tools ✅ (18 functions)
 - File operations (read, write, append, delete, copy, move)
 - Directory operations (create, list, delete, tree visualization)
 - File information and existence checking
 - Path validation and error handling
 
-### Planned Modules
-- HTTP request utilities
-- Text processing and manipulation
-- Data parsing and conversion
-- System information and process management
-- Cryptographic utilities
-- Common helper functions
+### Text Processing Tools ✅ (10 functions)
+- Text cleaning and normalization
+- Case conversion utilities (snake_case, camelCase, Title Case)
+- Smart text splitting and sentence extraction
+- HTML tag removal and Unicode normalization
+
+### Data Tools ✅ (28 functions - Phase 1 Complete)
+**Phase 1 ✅**: Data structures, JSON/CSV processing, validation (28 functions)
+- Data structure manipulation (flatten, merge, nested access)
+- JSON serialization with compression and validation  
+- CSV file processing and data cleaning
+- Schema validation and data type checking
+
+**Phase 2 📋**: Object serialization, configuration files (15 functions)
+**Phase 3 📋**: Data transformation, YAML/TOML support (16 functions)  
+**Phase 4 📋**: Binary data, archives, streaming (18 functions)
+**Phase 5 📋**: Caching, database processing (13 functions)
+
+### Future Modules 🚧
+- **Network Tools** - HTTP utilities, API helpers
+- **System Tools** - Process management, system information  
+- **Crypto Tools** - Hashing, encoding, basic cryptographic utilities
+- **Utilities** - Development and debugging helpers
 
 ## Contributing
 

{basic_open_agent_tools-0.2.0 → basic_open_agent_tools-0.3.0}/pyproject.toml

@@ -1,16 +1,15 @@
 [build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta:__legacy__"
 
 [project]
 name = "basic-open-agent-tools"
-dynamic = ["version"]
+version = "0.3.0"  # Version fix for GitHub Actions build
 description = "An open foundational toolkit providing essential components for building AI agents with minimal dependencies for local (non-HTTP/API) actions."
 readme = "README.md"
-license = {file = "LICENSE"}
 requires-python = ">=3.8"
 authors = [
-    { name = "Open Agent Tools", email = "info@openagenttools.org" },
+    { name = "Open Agent Tools", email = "unseriousai@gmail.com" },
 ]
 keywords = [
     "ai",
@@ -22,7 +21,6 @@ keywords = [
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
-    "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.8",
@@ -54,19 +52,8 @@ test = [
     "pytest-cov>=4.0.0",
 ]
 
-[tool.hatch.version]
-path = "src/basic_open_agent_tools/__init__.py"
-
-[tool.hatch.build.targets.sdist]
-include = [
-    "/src",
-    "/tests",
-    "/README.md",
-    "/LICENSE",
-]
-
-[tool.hatch.build.targets.wheel]
-packages = ["src/basic_open_agent_tools"]
+[tool.setuptools.packages.find]
+where = ["src"]
 
 [tool.ruff]
 target-version = "py38"

basic_open_agent_tools-0.3.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

basic_open_agent_tools-0.3.0/setup.py

@@ -0,0 +1,65 @@
+#!/usr/bin/env python3
+
+from setuptools import setup, find_packages
+import os
+
+# Read version from __init__.py
+def get_version():
+    with open("src/basic_open_agent_tools/__init__.py", "r") as f:
+        for line in f:
+            if line.startswith("__version__"):
+                return line.split("=")[1].strip().strip('"\'')
+    raise RuntimeError("Version not found")
+
+# Read long description from README
+def get_long_description():
+    with open("README.md", "r", encoding="utf-8") as f:
+        return f.read()
+
+setup(
+    name="basic-open-agent-tools",
+    version=get_version(),
+    description="An open foundational toolkit providing essential components for building AI agents with minimal dependencies for local (non-HTTP/API) actions.",
+    long_description=get_long_description(),
+    long_description_content_type="text/markdown",
+    author="Open Agent Tools",
+    author_email="unseriousai@gmail.com",
+    url="https://github.com/open-agent-tools/basic-open-agent-tools",
+    project_urls={
+        "Homepage": "https://github.com/open-agent-tools/basic-open-agent-tools",
+        "Documentation": "https://github.com/open-agent-tools/basic-open-agent-tools#readme",
+        "Repository": "https://github.com/open-agent-tools/basic-open-agent-tools",
+        "Issues": "https://github.com/open-agent-tools/basic-open-agent-tools/issues",
+    },
+    packages=find_packages(where="src"),
+    package_dir={"": "src"},
+    python_requires=">=3.8",
+    keywords=["ai", "agents", "toolkit", "automation", "local-tools"],
+    classifiers=[
+        "Development Status :: 3 - Alpha",
+        "Intended Audience :: Developers", 
+        "Operating System :: OS Independent",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+        "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    ],
+    install_requires=[],
+    extras_require={
+        "dev": [
+            "pytest>=7.0.0",
+            "pytest-cov>=4.0.0", 
+            "ruff>=0.1.0",
+            "mypy>=1.0.0",
+            "pre-commit>=3.0.0",
+        ],
+        "test": [
+            "pytest>=7.0.0",
+            "pytest-cov>=4.0.0",
+        ],
+    },
+)

{basic_open_agent_tools-0.2.0 → basic_open_agent_tools-0.3.0}/src/basic_open_agent_tools/__init__.py

@@ -6,17 +6,22 @@ with minimal dependencies for local (non-HTTP/API) actions.
 
 from typing import List
 
-__version__ = "0.2.0"
+__version__ = "0.3.0"
 
 # Modular structure
-from . import exceptions, file_system, text, types
+from . import data, exceptions, file_system, text, types
 
 # Helper functions for tool management
 from .helpers import (
     get_tool_info,
     list_all_available_tools,
+    load_all_data_tools,
     load_all_filesystem_tools,
     load_all_text_tools,
+    load_data_csv_tools,
+    load_data_json_tools,
+    load_data_structure_tools,
+    load_data_validation_tools,
     merge_tool_lists,
 )
 
@@ -31,10 +36,10 @@ __all__: List[str] = [
     # Implemented modules
     "file_system",
     "text",
+    "data",
     # Future modules (uncomment when implemented)
     # "system",
     # "network",
-    # "data",
     # "crypto",
     # "utilities",
     # Common infrastructure
@@ -43,6 +48,11 @@ __all__: List[str] = [
     # Helper functions
     "load_all_filesystem_tools",
     "load_all_text_tools",
+    "load_all_data_tools",
+    "load_data_json_tools",
+    "load_data_csv_tools",
+    "load_data_structure_tools",
+    "load_data_validation_tools",
     "merge_tool_lists",
     "get_tool_info",
     "list_all_available_tools",

basic_open_agent_tools-0.3.0/src/basic_open_agent_tools/data/__init__.py

@@ -0,0 +1,85 @@
+"""Data tools for AI agents.
+
+This module provides data processing and manipulation tools organized into logical submodules:
+
+- structures: Data structure manipulation and transformation
+- json_tools: JSON serialization, compression, and validation
+- csv_tools: CSV file processing, parsing, and cleaning
+- validation: Data validation and schema checking
+"""
+
+from typing import List
+
+# Import all functions from submodules
+from .csv_tools import (
+    clean_csv_data,
+    csv_to_dict_list,
+    detect_csv_delimiter,
+    dict_list_to_csv,
+    read_csv_file,
+    validate_csv_structure,
+    write_csv_file,
+)
+from .json_tools import (
+    compress_json_data,
+    decompress_json_data,
+    safe_json_deserialize,
+    safe_json_serialize,
+    validate_json_string,
+)
+from .structures import (
+    compare_data_structures,
+    extract_keys,
+    flatten_dict,
+    get_nested_value,
+    merge_dicts,
+    remove_empty_values,
+    rename_keys,
+    safe_get,
+    set_nested_value,
+    unflatten_dict,
+)
+from .validation import (
+    aggregate_validation_errors,
+    check_required_fields,
+    create_validation_report,
+    validate_data_types,
+    validate_range,
+    validate_schema,
+)
+
+# Re-export all functions at module level for convenience
+__all__: List[str] = [
+    # Data structures
+    "flatten_dict",
+    "unflatten_dict",
+    "get_nested_value",
+    "set_nested_value",
+    "merge_dicts",
+    "compare_data_structures",
+    "safe_get",
+    "remove_empty_values",
+    "extract_keys",
+    "rename_keys",
+    # JSON processing
+    "safe_json_serialize",
+    "safe_json_deserialize",
+    "validate_json_string",
+    "compress_json_data",
+    "decompress_json_data",
+    # CSV processing
+    "read_csv_file",
+    "write_csv_file",
+    "csv_to_dict_list",
+    "dict_list_to_csv",
+    "detect_csv_delimiter",
+    "validate_csv_structure",
+    "clean_csv_data",
+    # Validation
+    "validate_schema",
+    "check_required_fields",
+    "validate_data_types",
+    "validate_range",
+    "aggregate_validation_errors",
+    "create_validation_report",
+]