Skip to content

Commit 496f4bf

Browse files
siddhss5siddhss5
committed
Open-source prep: finalize authorship, templates, SPDX headers
Preparing mj_viser for public release (see personalrobotics/robot-code#3). Licensing: - LICENSE: "siddhss5" → "Siddhartha Srinivasa <siddhartha.srinivasa@gmail.com>". - pyproject.toml: add authors/maintainers/urls. - SPDX + copyright header on every .py (src/, tests/, examples/). Templates synced from robot-code/.github-templates/. Code cleanup: - Removed dead `geom_name` variable in src/mj_viser/scene.py. - ruff check --fix + ruff format across src/, tests/, examples/. - [tool.ruff] config bumped to 120 line-length, F/E/W/I, __init__ F401 ignore. Verified: 21 tests pass, ruff check clean, ruff format clean.
1 parent b6af764 commit 496f4bf

29 files changed

Lines changed: 363 additions & 100 deletions

‎.github/CODEOWNERS‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
* @siddhss5

‎.github/ISSUE_TEMPLATE/bug_report.md‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
---
2+
name: Bug report
3+
about: Report a reproducible bug
4+
labels: bug
5+
---
6+
7+
## Environment
8+
- OS:
9+
- Python version:
10+
- uv version:
11+
- Package version or commit:
12+
13+
## Reproduction
14+
<!-- Minimal steps to reproduce the problem. -->
15+
16+
## Expected behavior
17+
18+
## Actual behavior
19+
20+
## Logs / traceback
21+
```
22+
```

‎.github/ISSUE_TEMPLATE/config.yml‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
blank_issues_enabled: false
2+
contact_links:
3+
- name: Questions and discussion
4+
url: https://github.com/personalrobotics/robot-code/discussions
5+
about: Ask questions or discuss design in the umbrella repo.

‎.github/ISSUE_TEMPLATE/improvement.md‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
---
2+
name: Improvement
3+
about: Propose an enhancement to existing functionality
4+
labels: enhancement
5+
---
6+
7+
## Motivation
8+
<!-- What problem or limitation prompts this improvement? -->
9+
10+
## Proposal
11+
<!-- What should change, concretely? -->
12+
13+
## Alternatives considered

‎.github/ISSUE_TEMPLATE/task.md‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
name: Task
3+
about: A planned unit of work
4+
labels: task
5+
---
6+
7+
## Goal
8+
9+
## Acceptance criteria
10+
- [ ]
11+
12+
## Notes

‎.github/pull_request_template.md‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
## Summary
2+
3+
<!-- One or two sentences describing what this PR does and why. -->
4+
5+
## Changes
6+
7+
<!-- Bulleted list of the concrete changes made. -->
8+
-
9+
10+
## Testing
11+
12+
- [ ] `uv run pytest tests/ -v` passes
13+
- [ ] `uv run ruff check .` passes
14+
- [ ] `uv run ruff format --check .` passes
15+
- [ ] Integration tested locally against the robot-code workspace (if cross-repo)
16+
17+
## Breaking changes
18+
19+
- [ ] None
20+
- [ ] Yes (describe migration below):
21+
22+
## Related issues
23+
24+
<!-- e.g. Fixes #123, Part of personalrobotics/robot-code#3 -->

‎.github/workflows/ci.yml‎

Lines changed: 37 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -5,28 +5,54 @@ on:
55
branches: [main]
66
pull_request:
77
branches: [main]
8+
workflow_dispatch:
9+
10+
concurrency:
11+
group: ci-${{ github.ref }}
12+
cancel-in-progress: true
813

914
jobs:
1015
test:
1116
runs-on: ubuntu-latest
1217
strategy:
18+
fail-fast: false
1319
matrix:
1420
python-version: ["3.10", "3.11", "3.12"]
15-
1621
steps:
1722
- uses: actions/checkout@v4
1823

19-
- name: Install uv
20-
uses: astral-sh/setup-uv@v4
21-
22-
- name: Set up Python ${{ matrix.python-version }}
23-
run: uv python install ${{ matrix.python-version }}
24+
- name: Set up uv
25+
uses: astral-sh/setup-uv@v5
26+
with:
27+
enable-cache: true
28+
python-version: ${{ matrix.python-version }}
2429

2530
- name: Install dependencies
26-
run: uv sync --all-extras
31+
run: uv sync --all-extras --dev
32+
33+
- name: Ruff lint
34+
run: uv run ruff check .
2735

28-
- name: Lint
29-
run: uv run ruff check src/ tests/
36+
- name: Ruff format check
37+
run: uv run ruff format --check .
3038

31-
- name: Test
32-
run: uv run pytest tests/ -v --cov=mj_viser --cov-report=term-missing
39+
- name: Pytest
40+
run: |
41+
if [ -d tests ]; then
42+
uv run pytest tests/ -v
43+
else
44+
echo "No tests/ directory; skipping pytest."
45+
fi
46+
47+
notify-robot-code:
48+
needs: test
49+
if: github.event_name == 'push' && github.ref == 'refs/heads/main'
50+
runs-on: ubuntu-latest
51+
steps:
52+
- name: Dispatch integration run
53+
uses: peter-evans/repository-dispatch@v3
54+
with:
55+
token: ${{ secrets.ROBOT_CODE_DISPATCH_TOKEN }}
56+
repository: personalrobotics/robot-code
57+
event-type: sibling-updated
58+
client-payload: '{"repo":"${{ github.event.repository.name }}","sha":"${{ github.sha }}"}'

‎CODE_OF_CONDUCT.md‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
# Code of Conduct
2+
3+
This project adopts the [Contributor Covenant, version 2.1][cc].
4+
5+
The full text is available at <https://www.contributor-covenant.org/version/2/1/code_of_conduct/>.
6+
7+
## Reporting
8+
9+
Instances of unacceptable behavior may be reported privately to the project
10+
maintainer at **siddhartha.srinivasa@gmail.com**. All reports will be
11+
reviewed and investigated promptly and fairly.
12+
13+
[cc]: https://www.contributor-covenant.org/version/2/1/code_of_conduct/

‎CONTRIBUTING.md‎

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
# Contributing
2+
3+
This repository is part of the [robot-code workspace](https://github.com/personalrobotics/robot-code).
4+
All projects in the workspace share a common layout (`src/` + `tests/`), a single
5+
package manager (`uv`), and a common CI setup.
6+
7+
## Development setup
8+
9+
```bash
10+
git clone https://github.com/personalrobotics/robot-code
11+
cd robot-code
12+
./setup.sh
13+
```
14+
15+
This clones every sibling repo (including this one) into a single uv workspace
16+
and runs `uv sync`. You can then work in any sibling's directory.
17+
18+
## Running tests and linters
19+
20+
From inside this repo:
21+
22+
```bash
23+
uv run pytest tests/ -v
24+
uv run ruff check .
25+
uv run ruff format --check .
26+
```
27+
28+
From the workspace root, you can also run the cross-repo integration suite:
29+
30+
```bash
31+
uv run pytest tests/integration -v
32+
```
33+
34+
## Pull requests
35+
36+
- Branch from `main`. Open a PR with a clear summary and test plan.
37+
- Per-repo CI (ruff + pytest) must pass.
38+
- Cross-repo integration CI in robot-code runs automatically when this repo's
39+
`main` advances, and on scheduled nightly runs.
40+
- Review is by [@siddhss5](https://github.com/siddhss5) (enforced via CODEOWNERS).
41+
42+
## Package manager: uv only
43+
44+
We use [uv](https://docs.astral.sh/uv/) exclusively. **Do not use pip.**
45+
The workspace layout in robot-code relies on uv's workspace resolution.
46+
47+
## License
48+
49+
By contributing, you agree that your contributions will be licensed under the
50+
MIT License (see [LICENSE](LICENSE)).

‎LICENSE‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
MIT License
22

3-
Copyright (c) 2026 siddhss5
3+
Copyright (c) 2025 Siddhartha Srinivasa <siddhartha.srinivasa@gmail.com>
44

55
Permission is hereby granted, free of charge, to any person obtaining a copy
66
of this software and associated documentation files (the "Software"), to deal

0 commit comments

Comments
 (0)