p_sync Milestone 1: Create Sync Client, implement pull operation, CLI, and overloads for log + call

.fernignore

@@ -13,10 +13,13 @@ mypy.ini
 README.md
 src/humanloop/decorators
 src/humanloop/otel
+src/humanloop/sync
+src/humanloop/cli
+pytest.ini
 
 ## Tests
 
-tests/
+tests/custom
 
 ## CI
 

.gitignore

@@ -7,3 +7,5 @@ poetry.toml
 .env
 tests/assets/*.jsonl
 tests/assets/*.parquet
+# Ignore humanloop directory which could mistakenly be committed when testing sync functionality as it's used as the default sync directory
+humanloop

pyproject.toml

@@ -1,13 +1,20 @@
+# This section is used by PyPI and follows PEP 621 for package metadata
 [project]
 name = "humanloop"
+description = "The Humanloop Python Library"
+authors = []
 
+# This section is used by Poetry for development and building
+# The metadata here is used during development but not published to PyPI
 [tool.poetry]
 name = "humanloop"
-version = "0.8.36b1"
-description = ""
+version = "0.8.39"
+description = "Humanloop Python SDK"
 readme = "README.md"
 authors = []
-keywords = []
+packages = [
+    { include = "humanloop", from = "src" },
+]
 
 classifiers = [
     "Intended Audience :: Developers",
@@ -26,9 +33,6 @@ classifiers = [
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Typing :: Typed"
 ]
-packages = [
-    { include = "humanloop", from = "src"}
-]
 
 [project.urls]
 Repository = 'https://github.com/humanloop/humanloop-python'
@@ -53,8 +57,10 @@ protobuf = ">=5.29.3"
 pydantic = ">= 1.9.2"
 pydantic-core = "^2.18.2"
 typing_extensions = ">= 4.0.0"
+click = "^8.0.0"
+python-dotenv = "^1.1.0"
 
-[tool.poetry.dev-dependencies]
+[tool.poetry.group.dev.dependencies]
 mypy = "1.0.1"
 pytest = "^7.4.0"
 pytest-asyncio = "^0.23.5"
@@ -70,11 +76,11 @@ pandas = "^2.2.0"
 parse-type = ">=0.6.4"
 pyarrow = "^19.0.0"
 pytest-retry = "^1.6.3"
-python-dotenv = "^1.0.1"
 replicate = "^1.0.3"
 ruff = "^0.5.6"
 types-jsonschema = "^4.23.0.20240813"
 types-protobuf = "^5.29.1.20250208"
+pytest-xdist = "^3.6.1"
 
 [tool.pytest.ini_options]
 testpaths = [ "tests" ]
@@ -86,7 +92,10 @@ plugins = ["pydantic.mypy"]
 [tool.ruff]
 line-length = 120
 
+[tool.poetry.scripts]
+humanloop = "humanloop.cli.__main__:cli"
 
 [build-system]
 requires = ["poetry-core"]
 build-backend = "poetry.core.masonry.api"
+

pytest.ini

@@ -0,0 +1,2 @@
+[pytest]
+addopts = -n auto