feat: add GitHub Actions CI for lint and smoke test

[cxhello]

Background

Currently, the project has no CI/CD pipeline configured. PRs are merged without any automated checks, which may lead to syntax errors, import chain breakage, or dependency issues going unnoticed.

Research

I investigated how similar Python SDK projects handle CI:

Project	Lint Tool	Python Matrix	Smoke Test
boto3 (AWS SDK)	ruff	3.9~3.15-dev	❌
google-cloud-python	nox + mypy	3.7~3.14	❌
apache/dubbo-python	ruff	3.9~3.13	✅
openai-python	ruff	single version	✅ (examples)
nacos-sdk-go (same ecosystem)	gofmt	Go 1.21	✅ (go test)

Key takeaway: ruff has become the standard lint tool for Python SDKs, and most projects run at least basic import/smoke tests across multiple Python versions.

Proposal

Add a lightweight GitHub Actions workflow with two jobs:

1. Lint

• ruff check — catch syntax errors, unused imports, common issues
• ruff format --check — ensure consistent code style

2. Smoke Test

• Python version matrix: 3.9, 3.11, 3.13
• Install dependencies from requirements.txt
• Verify module import: import nacos (v1) and import v2.nacos (v2)
• This ensures the dependency chain and import graph are not broken

Non-goals (for now)

• Unit tests / integration tests (requires Nacos Server)
• mypy type checking (v2 type hints coverage is incomplete)
• Code coverage reporting

Happy to submit a PR if this direction is acceptable.

[Sunrisea]

Thanks for the well-researched proposal! The comparison table across similar SDK projects is very helpful.

We've been planning to add CI/CD to this repo recently, and your proposal aligns well with what we had in mind. A lightweight lint + smoke test pipeline is a great starting point — it covers the most common breakage scenarios without requiring a running Nacos server.

A couple of thoughts:

• ruff as the lint tool sounds good — it's fast and has become the de facto standard for Python projects.
• The Python version matrix (3.9, 3.11, 3.13) looks reasonable

One heads-up: we've just completed a branch restructuring — the master branch has been switched to the v3 codebase, and v2 code has moved to the feature/v2 maintenance branch. Please keep this in mind when setting up the CI workflow (e.g., which branches to trigger on, and which modules to smoke test per branch). Detail in #308

Feel free to submit a PR — happy to review it. Welcome aboard!

[cxhello]

Update: CI workflow has been implemented and merged.

• ci: add GitHub Actions workflow for lint and smoke test #310 merged to feature/v2
• ci: add GitHub Actions workflow for lint and smoke test #309 open for master (CI passing)
• ci: fix Python matrix version for smoke test #311 follow-up fix for feature/v2 Python matrix (CI passing)

During CI setup, we discovered that both branches require Python 3.10+ due to PEP 604 union type syntax (X | None). The smoke-test matrix has been updated to ['3.10', '3.12', '3.13'] accordingly.

This issue can be closed once #309 and #311 are merged.