Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Standardize doc-strings #26

Open
wants to merge 39 commits into
base: main
Choose a base branch
from
Open

Standardize doc-strings #26

wants to merge 39 commits into from

Conversation

elbeejay
Copy link
Contributor

@elbeejay elbeejay commented Mar 12, 2024

Close #15 by standardizing the doc-strings. To be merged after #21.

This PR standardizes the doc-strings per the numpy style. It also resolves the failing pre-commit continuous integration job, by fixing issues (primarily codespell and ruff) where possible, but also skipping files.

elbeejay and others added 30 commits February 27, 2024 20:27
ignore-regex = '^\s*"image\/png":\s.*'
ignore-words-list = "gost,"
ignore-words-list = "gost,GOST,ALOS,ans,NAM"
Copy link
Contributor Author

Choose a reason for hiding this comment

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

This ignore-words-list parameter doesn't seem to be working as expected so I had to add the relevant notebooks to the skip field above.

Comment on lines +67 to +85
[tool.ruff]
exclude = [
"WSF_DECAT_B_ExploringIDCerrors.ipynb",
"KAZ_Urbanization_Review.ipynb",
"Urban_metrics_Fullness.ipynb",
"Urban_metrics_Shape.ipynb",
"Urban_metrics_Sprawl.ipynb",
"Urban_metrics_Structure.ipynb",
"URB_DECAT_B_ExploringGHSSMODcode.ipynb",
"URB_SCAUR_UKR_B_I_urbanizationReview.ipynb",
"URB_SEAU1_B_A_Ka_ExtractDataUrban.ipynb",
"Zonal_statistics.ipynb",
"Data_Preparation.ipynb",
"URB_SEAU1_B_A_Ka_NovelUrbanizaton.ipynb",
"Create_Mosaick_Datasets.ipynb",
"GHSL_Standardize_To_Country.ipynb",
"MAP_Urbanization.ipynb",
"NGA_specific_results.ipynb",
]
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Many of the notebooks in the Implementations/ folder contain paths to local file systems, or reference source code held relative to some local file system, so these don't work. There are also many examples of references to variables that are not used. I didn't want to delete these notebooks in the event they are of some importance.

Please weigh in and let me know what you think @bpstewar

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@g4brielvs looking for some guidance here as well beyond the overall review.

Copy link
Member

@g4brielvs g4brielvs Jun 26, 2024

Choose a reason for hiding this comment

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

@bpstewar @andresfchamorro Whenever you have a chance, could you please look into this?

@elbeejay elbeejay mentioned this pull request Mar 18, 2024
@elbeejay elbeejay marked this pull request as ready for review March 22, 2024 12:21
@elbeejay
Copy link
Contributor Author

elbeejay commented Mar 22, 2024

Ready to be merged after #21

@elbeejay elbeejay mentioned this pull request Mar 23, 2024
@elbeejay elbeejay mentioned this pull request May 27, 2024
@elbeejay elbeejay requested a review from g4brielvs June 13, 2024 02:43
@g4brielvs g4brielvs added the enhancement New feature or request label Jun 17, 2024
@elbeejay
Copy link
Contributor Author

Resolved merge conflicts - still waiting for input on the "Implementations" notebooks that cannot be executed as they currently are (see comment / notes above).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Standardize doc-strings
2 participants