Set up pyproject.toml and Add Python project setup with protobuf generation (#5)

Author: timl3136

.gitignore

@@ -0,0 +1,107 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Logs
+*.log
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+.idea/
+*.iml
+*.ipr
+*.iws
+
+# VS Code
+.vscode/
+
+# macOS
+.DS_Store
+
+# Windows
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+
+# Project specific
+.temp_gen/
+*.pb.py
+*.pb.pyi
+
+# bin
+.bin/

README.md

@@ -18,6 +18,53 @@ git clone https://github.com/cadence-workflow/cadence-python-client.git
 cd cadence-python-client
 ```
 
+## Development
+
+### Setup
+
+1. **Create virtual environment:**
+   ```bash
+   python3 -m venv venv
+   source venv/bin/activate  # Windows: venv\Scripts\activate
+   ```
+
+2. **Install dependencies:**
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+### Generate Protobuf Files
+
+Run the generation script:
+```bash
+python scripts/generate_protobuf_final.py
+```
+
+This will:
+- Download protoc 29.1 binary
+- Generate Python files in `cadence/api/v1/`
+- Create proper package structure
+
+### Test
+
+Verify the generated files work:
+```bash
+python cadence/sample/simple_usage_example.py
+```
+
+### Usage
+
+```python
+from cadence.api.v1 import workflow, common, domain
+
+# Create objects
+wf_exec = common.WorkflowExecution()
+wf_exec.workflow_id = "my-workflow"
+
+# Use enums
+status = workflow.WORKFLOW_EXECUTION_CLOSE_STATUS_COMPLETED
+```
+
 ## License
 
 Apache 2.0 License, please see [LICENSE](LICENSE) for details.

cadence/api/__init__.py

@@ -0,0 +1,50 @@
+# Auto-generated __init__.py file
+# Import all generated protobuf modules
+from . import common_pb2
+from . import decision_pb2
+from . import domain_pb2
+from . import error_pb2
+from . import history_pb2
+from . import query_pb2
+from . import service_domain_pb2
+from . import service_meta_pb2
+from . import service_visibility_pb2
+from . import service_worker_pb2
+from . import service_workflow_pb2
+from . import tasklist_pb2
+from . import visibility_pb2
+from . import workflow_pb2
+
+# Create cleaner aliases for easier imports
+common = common_pb2
+decision = decision_pb2
+domain = domain_pb2
+error = error_pb2
+history = history_pb2
+query = query_pb2
+service_domain = service_domain_pb2
+service_meta = service_meta_pb2
+service_visibility = service_visibility_pb2
+service_worker = service_worker_pb2
+service_workflow = service_workflow_pb2
+tasklist = tasklist_pb2
+visibility = visibility_pb2
+workflow = workflow_pb2
+
+# Only expose clean module names (no _pb2)
+__all__ = [
+    'common',
+    'decision',
+    'domain',
+    'error',
+    'history',
+    'query',
+    'service_domain',
+    'service_meta',
+    'service_visibility',
+    'service_worker',
+    'service_workflow',
+    'tasklist',
+    'visibility',
+    'workflow',
+]