[SDK] Python SDK Initial Implementation (v0.1.0) **Difficulty**: Advanced | **Area**: sdks/ | **Package Name**: urbackend #100

Activity

1. yash-pouranik

   added

   featureto add a new featureto add a new feature

   on Apr 13, 2026
2. yash-pouranik

   added the

   Feature

   issue type on Apr 13, 2026
3. yash-pouranik

   added

   backend

   nsoc26

   sdk

   level310 pts10 pts

   on Apr 13, 2026
4. Navyasree-ulava commented on Apr 23, 2026

   

   Navyasree-ulava

   on Apr 23, 2026

   Last edited by Navyasree-ulava

   Contributor

   More actions

   Hi @yash-pouranik,

   I would like to work on implementing the Python SDK for urBackend.

   I have reviewed the TypeScript SDK (@urbackend/sdk) and will mirror its architecture and method naming to ensure consistency across SDKs.

   ---

   Plan of Approach

   1. Client Design

   Implement a urBackendClient class with the required interface:

   client = urBackendClient()
   client.connect(api_key="YOUR_API_KEY", project_id="YOUR_PROJECT_ID", base_url="https://api.urbackend.com")
   

   ---

   2. Auth Module (client.auth)

   Initial methods:

   • login(email, password)

   The client will store the accessToken internally and reuse it for authenticated requests where required.

   ---

   3. Database Module (client.db)

   Implement:

   • collection(name) wrapper
   • .find(query)
   • .insert(data)

   These will map to the corresponding backend endpoints and support optional token passing for RLS-enabled collections.

   ---

   4. HTTP Layer

   • Use requests or httpx for HTTP communication

   • Implement a centralized request handler for:

     • headers (API key and auth token)
     • response parsing
     • error handling

   ---

   5. Project Structure

   sdks/urbackend-python/
   ├── urbackend/
   │   ├── client.py
   │   ├── auth.py
   │   ├── db.py
   │   ├── exceptions.py
   │   └── __init__.py
   ├── pyproject.toml
   └── README.md
   

   ---

   6. Packaging

   • Version: 0.1.0
   • Use pyproject.toml
   • Prepare the package for PyPI publishing

   ---

   7. Documentation

   • Provide a README with usage examples (auth and CRUD)
   • Add docstrings for all public methods

   ---

   Clarifications

   1. API Endpoints

      • Are backend routes identical to those used in the TypeScript SDK?
      • Is there a default base URL for production?

   2. Authentication Handling

      • Should the client automatically store accessToken after login and include it in subsequent requests?

   3. Database Mapping

      • Should .find(query) map directly to getAll with query parameters?
      • Should full query options (filter, sort, limit, page, populate) be supported in v0.1.0?

   4. Error Handling

      • Should we replicate SDK-style exceptions such as AuthError, NotFoundError, and RateLimitError?

   5. Testing

      • Is there a recommended local instance or sandbox environment for testing?

   6. Package Naming

      • Should the package be published as urbackend or urbackend-python on PyPI?

   ---

   I will begin with the core features (auth and database operations) once these points are clarified and expand incrementally.

   Thank you.
5. yash-pouranik commented on Apr 23, 2026

   

   yash-pouranik

   on Apr 23, 2026

   MemberAuthor

   More actions

   just reviewing the Approach @Navyasree-ulava

   👍React with 👍1Reacted by Navyasree
6. yash-pouranik commented on Apr 23, 2026

   

   yash-pouranik

   on Apr 23, 2026

   MemberAuthor

   More actions

   @Navyasree-ulava
   The Approach looks solid and AI gen, Thats okay.
   Last check is - urbackend api end point for public apis is - base_url="https://api.ub.bitbros.in"

   u can check everything about urbackend here - https://docs.ub.bitbros.in/
   And before working Go through the product once - and understand what exactly urbackend is then start
   Vibing on this.
   Lets go

   Let me know - Karde assign??
7. Navyasree-ulava commented on Apr 23, 2026

   

   Navyasree-ulava

   on Apr 23, 2026

   Contributor

   More actions

   Yes, i will go through the project thoroughly and will start working on it, you can assign me this issue
8. yash-pouranik

   assigned

   Navyasree-ulava

   on Apr 23, 2026
9. yash-pouranik commented on Apr 23, 2026

   

   yash-pouranik

   on Apr 23, 2026

   MemberAuthor

   More actions

   Done Lets go @Navyasree-ulava

   👍React with 👍1Reacted by Navyasree
10. yash-pouranik

    linked a pull request that will close this issueFeature/python sdk #135on Apr 26, 2026
11. yash-pouranik

    closed this as completedin #135on Apr 26, 2026