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

Make create_empty.py less verbose - easier for beginners #309

Closed

Conversation

VladimirFokow
Copy link
Contributor

@VladimirFokow VladimirFokow commented Mar 21, 2024

Description

For me personally (as a beginner), the current file is too verbose - all the comments stand in the way of clearly seeing only the operations which need to happen.

Plus, some comments just repeat the function names (like main) which doesn't really add info. Code here can be self-documenting.

The proposed result (without red/green diffs): here.

TODO (after the code has been approved):

  • update the line numbers which highlight the code in the docs

Type of change

  • This change requires a documentation update

Checklist

  • I have run the pre-commit checks with ./orbit.sh --format
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings
  • I have added tests that prove my fix is effective or that my feature works
  • I have run all the tests with ./orbit.sh --test and they pass
  • I have updated the changelog and the corresponding version in the extension's config/extension.toml file
  • I have added my name to the CONTRIBUTORS.md or my name already exists there

@VladimirFokow VladimirFokow marked this pull request as draft March 21, 2024 20:56
@Mayankm96
Copy link
Contributor

Mayankm96 commented Mar 22, 2024

To me, this seems like a matter of personal preference. For a new user who wants to go through the code and understand it, the comments may help or may come in the way depending on what you're used to. Thus, I don't think this is necessary for us.

@Mayankm96 Mayankm96 closed this Mar 22, 2024
ADebor pushed a commit to ADebor/IsaacLab that referenced this pull request Apr 8, 2024
…saac-sim#327)

# Description

This PR adds a script to run all the unit tests (any Python script named
`test_*.py`) and report on the success rate and timing. It also enables
the skipping of known breaking tests via tests_to_skip.py. The tests can
be run via `orbit -t`, and the test output will be printed to both a log
(`test_results.log`) and to the console.

This can be used for CI/CD but also can be temporarily used to run each
test without invoking them manually one by one until we have a better
solution.

A few tests are currently broken; for now, these are added to
tests_to_skip - I will put follow-up issues + PRs to fix these as soon
as possible. I recommend we add running tests as a requirement before
merging PRs until the CI/CD project is complete, too. One way to help
facilitate this is to have PR authors copy/paste the results at the end
of the test run to the PR description.

Fixes isaac-sim#309 

## Type of change

- New feature (non-breaking change which adds functionality)

## Screenshots

An example test result summary with timeout set to 60 seconds running on
my workstation:

```
===================
Test Result Summary
===================
Total: 39
Passing: 29
Failing: 0
Skipped: 8
Timing Out: 2
Passing Percentage: 94.87%
Total Time Elapsed: 0.0h31.0m52.38s
```

## Checklist

- [x] I have run the [`pre-commit` checks](https://pre-commit.com/) with
`./orbit.sh --format`
- [ ] I have made corresponding changes to the documentation
- [x] My changes generate no new warnings
- [x] I have added tests that prove my fix is effective or that my
feature works
- [ ] I have updated the changelog and the corresponding version in the
extension's `config/extension.toml` file
- [ ] I have added my name to the `CONTRIBUTORS.md` or my name already
exists there
fatimaanes pushed a commit to fatimaanes/omniperf that referenced this pull request Aug 8, 2024
…saac-sim#327)

# Description

This PR adds a script to run all the unit tests (any Python script named
`test_*.py`) and report on the success rate and timing. It also enables
the skipping of known breaking tests via tests_to_skip.py. The tests can
be run via `orbit -t`, and the test output will be printed to both a log
(`test_results.log`) and to the console.

This can be used for CI/CD but also can be temporarily used to run each
test without invoking them manually one by one until we have a better
solution.

A few tests are currently broken; for now, these are added to
tests_to_skip - I will put follow-up issues + PRs to fix these as soon
as possible. I recommend we add running tests as a requirement before
merging PRs until the CI/CD project is complete, too. One way to help
facilitate this is to have PR authors copy/paste the results at the end
of the test run to the PR description.

Fixes isaac-sim#309 

## Type of change

- New feature (non-breaking change which adds functionality)

## Screenshots

An example test result summary with timeout set to 60 seconds running on
my workstation:

```
===================
Test Result Summary
===================
Total: 39
Passing: 29
Failing: 0
Skipped: 8
Timing Out: 2
Passing Percentage: 94.87%
Total Time Elapsed: 0.0h31.0m52.38s
```

## Checklist

- [x] I have run the [`pre-commit` checks](https://pre-commit.com/) with
`./orbit.sh --format`
- [ ] I have made corresponding changes to the documentation
- [x] My changes generate no new warnings
- [x] I have added tests that prove my fix is effective or that my
feature works
- [ ] I have updated the changelog and the corresponding version in the
extension's `config/extension.toml` file
- [ ] I have added my name to the `CONTRIBUTORS.md` or my name already
exists there
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