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

adding docstring #2236

Merged
merged 5 commits into from
Mar 25, 2025
Merged

adding docstring #2236

merged 5 commits into from
Mar 25, 2025

Conversation

VindeeR
Copy link
Contributor

@VindeeR VindeeR commented Mar 18, 2025

No description provided.

@codecov-commenter
Copy link

codecov-commenter commented Mar 18, 2025

Codecov Report

Attention: Patch coverage is 45.60000% with 68 lines in your changes missing coverage. Please review.

Project coverage is 52.62%. Comparing base (50d3c50) to head (a932995).

Files with missing lines Patch % Lines
autosubmit/platforms/slurmplatform.py 45.60% 62 Missing and 6 partials ⚠️
Additional details and impacted files
@@                       Coverage Diff                        @@
##           create-maestro-platform#2165    #2236      +/-   ##
================================================================
- Coverage                         52.75%   52.62%   -0.14%     
================================================================
  Files                                72       73       +1     
  Lines                             17614    17634      +20     
  Branches                           3418     3418              
================================================================
- Hits                               9293     9280      -13     
- Misses                             7480     7559      +79     
+ Partials                            841      795      -46     
Flag Coverage Δ
fast-tests 52.62% <45.60%> (-0.14%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@kinow
Copy link
Member

kinow commented Mar 18, 2025

Make it a draft?

@VindeeR VindeeR self-assigned this Mar 18, 2025
@VindeeR VindeeR added documentation Improvements or additions to documentation enhancement New feature or request Refactor labels Mar 18, 2025
@VindeeR VindeeR marked this pull request as draft March 18, 2025 15:39
@VindeeR
Copy link
Contributor Author

VindeeR commented Mar 19, 2025

@isimo00 I've implemented many changes and lint fixes to the files, I too add Documentation to all function but I doubt they are perfectly explained so, I would like to ask if you could do a double check and raise any and all issues you find with the changes so we can improve the documentation/understanding of the behavior

@isimo00
Copy link
Contributor

isimo00 commented Mar 19, 2025

Will do tomorrow, thanks @VindeeR :)

if not duplicated_jobs_already_checked:
job_name = package.name if hasattr(package, "name") else package.jobs[0].name
jobid = self.get_jobid_by_jobname(job_name)
if len(jobid) > 1: # Cancel each job that is not the associated
ids_to_check = [package.jobs[0].id]
if package.jobs[0].het:
for i in range(1,package.jobs[0].het.get("HETSIZE",1)):
for i in range(1,package.jobs[0].het.get("HETSIZE",1)): # noqa
Copy link
Contributor

Choose a reason for hiding this comment

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

What's #noqa?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

# noqa is a way to ignore errors in linters based in Flake8 and Pep8
So I'm technically ignoring any and all errors in this line, but the idea was just to ignore the HETSIZE since linters identify it as a misspelled word

Copy link
Member

Choose a reason for hiding this comment

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

I think the word comes from no quality assurance, as normally linters and other static analyzers would be grouped as quality assurance tools (but a random guess).

Copy link
Contributor

Choose a reason for hiding this comment

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

Ooh, thank you!

@VindeeR VindeeR marked this pull request as ready for review March 20, 2025 13:13
@VindeeR VindeeR merged commit 90b83d7 into create-maestro-platform#2165 Mar 25, 2025
6 checks passed
@kinow kinow deleted the docstring-maestro branch March 25, 2025 16:36
isimo00 pushed a commit that referenced this pull request Mar 31, 2025
Ini docstring

fixing SlurmPlatform docstring

Add some descriptions (testing)

Add skeleton of Maestro platform class

adding docstring (#2236)

* adding docstring

* import failling CI/CD

* docstring slurmplatform

* linting + docstring

Fix exit code in autosubmit commands that return bool

4.1.12 recovery is slow (#2237)

* Changelog

* WIP DROPME Use a dev version of config parser

* WIP DROPME Use a dev version of config parser

* rebse

* update asconfigparser version

* removed update_parameters call

---------

Co-authored-by: Bruno P. Kinoshita <[email protected]>

specify python version and update command line

4.1.12 release branch (#2042)

* Changelog

* WIP DROPME Use a dev version of config parser

* WIP DROPME Use a dev version of config parser

* rebse

* update asconfigparser version

* 4.1.12 recovery is slow (#2237)

* Changelog

* WIP DROPME Use a dev version of config parser

* WIP DROPME Use a dev version of config parser

* rebse

* update asconfigparser version

* removed update_parameters call

---------

Co-authored-by: Bruno P. Kinoshita <[email protected]>

* WIP DROPME Use a dev version of config parser

* WIP DROPME Use a dev version of config parser

* rebse

* changelog added

* changelog added

---------

Co-authored-by: Bruno P. Kinoshita <[email protected]>

Add documentation about workflow commit, fix make watch

update eb recipe (#2243)

Update setuptools requirement from <=76.0.0 to <=77.0.3

Updates the requirements on [setuptools](https://github.com/pypa/setuptools) to permit the latest version.
- [Release notes](https://github.com/pypa/setuptools/releases)
- [Changelog](https://github.com/pypa/setuptools/blob/main/NEWS.rst)
- [Commits](pypa/setuptools@0.6...v77.0.3)

---
updated-dependencies:
- dependency-name: setuptools
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <[email protected]>

Update setuptools requirement from <=77.0.3 to <=78.0.2

Updates the requirements on [setuptools](https://github.com/pypa/setuptools) to permit the latest version.
- [Release notes](https://github.com/pypa/setuptools/releases)
- [Changelog](https://github.com/pypa/setuptools/blob/main/NEWS.rst)
- [Commits](pypa/setuptools@0.6...v78.0.2)

---
updated-dependencies:
- dependency-name: setuptools
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <[email protected]>

Use pytestify to convert unittests to pytest

Clean unused code

Adding slurm_monitor and strategies tests, deleting unused function in slurm_monitor (see BSC-ES/autosubmit-api#175)

Add Docker marker, update CONTRIBUTING docs with information for contributors to run integration+docker tests

Update portalocker requirement from <=2.7.0 to <=3.1.1

Updates the requirements on [portalocker](https://github.com/wolph/portalocker) to permit the latest version.
- [Release notes](https://github.com/wolph/portalocker/releases)
- [Changelog](https://github.com/wolph/portalocker/blob/develop/CHANGELOG.rst)
- [Commits](wolph/portalocker@v0.5.6...v3.1.1)

---
updated-dependencies:
- dependency-name: portalocker
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <[email protected]>

Add DbManager factory function (#2107)

* add DbManager factory function

* add extra typings

* Update autosubmit/job/job_list_persistence.py

Co-authored-by: Luiggi Tenorio <[email protected]>

---------

Co-authored-by: Bruno P. Kinoshita <[email protected]>

verify args to format message (#2113)

Documentation improvement maestro (#2247)

* fixing some minor documentation problems and removing verbosity that would cause confusion

* fixing sphinx identation problem

* Creating a step-by-step of slurm tests + reaorganizing existing documentation

* refining test

* removing file that shouldnt be there

* removing duplicated parameters simplifying description and proportions

* adjusting docstring of the function

improving quality of documentation bettering wording of instruction and giving hints

changes to platform to simulate different behaviours between slurm and maestro

Change file name

Update job.py

revert

Update ecplatform.py

revert

Update paramiko_submitter.py

revert

removing unused imports

fixing instructions

Fix sphyinx local build and example_platform name change

Small fixes

adjusting configure platform

draft of a extending platform

Add some references

extra information where might be needed changes

Clean Configure Experiments page

small fixes document

Move autosubmit create syntax doc

Move autosubmit create docs

Rewrite some snippets

Add permalinks and formatting
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation enhancement New feature or request Refactor
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants