Skip to content

Conversation

@Raja-89
Copy link
Contributor

@Raja-89 Raja-89 commented Nov 2, 2025

Summary

This PR adds a new developer documentation file at
docs/sdk_developers/pylance.md.

The document introduces Pylance, a powerful VS Code language server for Python, and guides contributors on how to set it up and interpret its diagnostics to improve code quality before submitting pull requests.


Details

Added

  • docs/sdk_developers/pylance.md
    • Explains what Pylance is and why it’s important for the Hiero SDK Python repository.
    • Includes setup instructions for enabling and customizing Pylance in VS Code.
    • Demonstrates how to interpret Pylance error messages using real examples from the SDK.
    • Provides reference links to the SDK’s contributing guidelines, changelog, and commit signing documentation.

✅ Checklist

  • Documentation added under docs/sdk_developers/
  • Commit signed and verified (git commit -S -s -m "...")
  • Changelog entry added
  • Markdown formatting validated and linted
  • Follows repository contribution guidelines

🔗 References


Closes: #713

Raja-89 and others added 2 commits November 2, 2025 22:01
Signed-off-by: Raja Rathour <imraja729@gmail.com>
Signed-off-by: Raja Rathour <193507075+Raja-89@users.noreply.github.com>
Copy link
Contributor

@exploreriii exploreriii left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Raja-89 please check your difference between your submission and our main, each time, before requesting a review!
You can see you've deleted a changelog entry
https://github.com/hiero-ledger/hiero-sdk-python/pull/718/files#r2484971770

Signed-off-by: Raja Rathour <imraja729@gmail.com>
Signed-off-by: Raja Rathour <imraja729@gmail.com>
@Raja-89
Copy link
Contributor Author

Raja-89 commented Nov 3, 2025

@exploreriii , resolved



```python
from hiero_sdk.account import AccountId
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @Raja-89 very good!
However, this is wrong

correct:
from /src
from hiero_sdk_python.account.account_id import AccountId

from /examples
from hiero_sdk_python import AccountId

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please Review it once.

Signed-off-by: Raja Rathour <imraja729@gmail.com>
Copy link
Contributor

@exploreriii exploreriii left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Both methods work, there is no incorrect in this

@Raja-89
Copy link
Contributor Author

Raja-89 commented Nov 3, 2025

Both methods work, there is no incorrect in this

Hey @exploreriii , let me know...
What should be my next step?
Do we need the changes or keep it asit is ?

@exploreriii
Copy link
Contributor

@Raja-89 you are claiming the top one is incorrect, but its actually correct
The bottom one is correct as well

So you don't have an 'incorrect' example

Signed-off-by: Raja Rathour <imraja729@gmail.com>
@Raja-89
Copy link
Contributor Author

Raja-89 commented Nov 3, 2025

Hey @exploreriii
I’ve updated the Fixing Invalid Imports and Calls section as per your feedback.
It now correctly distinguishes between /src and /examples import usage with clear context and examples.

I’ve also synced my branch with the latest upstream changes everything should now be up to date.

Please review it once and let me know if any further refinements are needed.


- **Flagging incorrect imports**

- e.g., importing `hedera.account_id` instead of `hiero_sdk.account_id`
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this does not exist
hiero_sdk.account_id

should be
from hiero_sdk_python.account.account_id
or
from hiero_sdk_python import AccountId

If you mix up these contexts, Pylance will display an error such as:

```
Import "hiero_sdk.account.account_id" could not be resolved
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

hiero_sdk_python!!


---

## Fixing Invalid Imports and Calls
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

you are adding two correct examples, but your section is about invalid imports

why not give an invalid example?
that would be:

from hiero_sdk.account.account_id import AccountId

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants