Release v0.1.15: Update testing framework and improve CI compatibility

- Added a README in the `tests/` directory detailing how to run tests and outlining testing conventions.
- Updated test performance thresholds to be more CI-friendly.
- Integration tests now utilize the working Promptix implementation by default.
- Ensured all tests pass consistently against the source code when using `PYTHONPATH=src`.
- Bumped version to 0.1.15 in `pyproject.toml` and `__init__.py`.
- Introduced new markers for slow tests to facilitate selective test execution.

This release enhances the testing framework and ensures better compatibility with continuous integration environments.

Author: Nisarg38

CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.1.15] - 2025-09-10
+
+### Added
+- README in `tests/` directory detailing how to run tests and testing conventions
+
+### Changed
+- Test performance thresholds updated to be CI-friendly
+- Integration tests use working Promptix implementation by default
+
+### Fixed
+- All tests passing consistently against source code (via `PYTHONPATH=src`)
+
+
 ## [0.1.14] - 2025-09-10
 
 ### 🧹 **Code Quality & Architecture Enhancements**

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "promptix"
-version = "0.1.14"
+version = "0.1.15"
 description = "A simple library for managing and using prompts locally with Promptix Studio"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -59,6 +59,9 @@ include-package-data = true
 testpaths = ["tests"]
 python_files = ["test_*.py"]
 addopts = "--cov=promptix --cov-report=term-missing"
+markers = [
+    "slow: marks tests as slow (deselect with '-m \"not slow\"')",
+]
 
 [tool.black]
 line-length = 88

src/promptix/__init__.py

@@ -23,5 +23,5 @@
 
 from .core.base_refactored import Promptix
 
-__version__ = "0.1.14"
+__version__ = "0.1.15"
 __all__ = ["Promptix"]

src/promptix/core/storage/loaders.py

@@ -56,7 +56,12 @@ def validate_loaded(self, data: Dict[str, Any]) -> None:
 
 class PromptLoaderFactory:
     @staticmethod
-    def get_loader(file_path: Path) -> PromptLoader:
+    def get_loader(file_path) -> PromptLoader:
+        # Convert string to Path if needed
+        if isinstance(file_path, str):
+            from pathlib import Path
+            file_path = Path(file_path)
+        
         if file_path.suffix.lower() in ['.yml', '.yaml']:
             return YAMLPromptLoader()
         elif file_path.suffix.lower() == '.json':

tests/README.md

@@ -0,0 +1,44 @@
+# Tests Directory
+
+This folder contains all pytest test files for the `promptix` library.
+
+## Running Tests
+
+To run all tests against the **source code** and gather coverage:
+
+```bash
+# Activate virtual environment
+source venv/bin/activate
+
+# Run tests with source path in PYTHONPATH
+PYTHONPATH=src python3 -m pytest --cov=promptix --cov-report=html tests/ -v
+```
+
+To run tests against the **installed package**:
+
+```bash
+pytest --cov=promptix --cov-report=html tests/ -v
+```
+
+## Test Organization
+
+- `test_01_basic.py`: Basic prompt retrieval tests
+- `test_02_builder.py`: Builder pattern tests
+- `test_03_template_features.py`: Template rendering tests
+- `test_04_complex.py`: Complex prompt scenarios
+- `test_05_api_integration.py`: OpenAI & Anthropic integration
+- `test_06_conditional_tools.py`: Conditional tools tests
+- `test_07_architecture_refactor.py`: Tests for future architecture (skipped)
+- `test_components.py`: Component-level tests (storage, config, adapters, utils)
+- `test_edge_cases.py`: Edge case and error condition tests
+- `test_integration_advanced.py`: Advanced end-to-end integration tests
+- `test_performance.py`: Performance benchmarks
+
+## Markers and Skips
+
+- Tests marked `@pytest.mark.skip` are for future features or components not yet implemented.
+- Use `-v` for verbose output and `--tb=line` for concise tracebacks.
+- Slow tests can be deselected with:
+  ```bash
+  pytest -m "not slow"
+  ```