[cueman] Add Unit Tests for Query and Listing Commands

[ramonfigueiredo]

Describe the enhancement
Implement tests for all query commands that list jobs, frames, processes, and layers with filtering and pagination.

Version Number

• https://github.com/AcademySoftwareFoundation/OpenCue/releases/tag/v1.11.66

Additional context
Create /cueman/tests/test_query_commands.py testing:

• Frame listing (-lf) with layer and state filters
• Process listing (-lp) with memory and duration filters
• Layer listing (-ll) with formatting and statistics
• Job info display (-info) with detailed output
• Pagination with page and limit parameters
• Filter combination validation
• Empty result handling
• Large dataset performance considerations

Mock job.getFrames(), job.getLayers(), opencue.api.getProcs(). Test various data sizes and filter combinations.

[ramonfigueiredo]

The Academy Software Foundation (ASWF) Dev Days (https://www.aswf.io/dev-days/) is a fantastic way to contribute to the amazing and important #ASWF projects (https://www.aswf.io/projects/) that positively impact our industry. Whether you’re in #vfx, #animation, #softwareengineering, or #softwaredeveloper, this is a great opportunity to get involved.

📅 Next Dev Days: September 25, 2025 (fully virtual, open worldwide)

For this event, we are highlighting OpenCue project - https://docs.opencue.io/, a production-proven render management system originally developed at Sony Pictures Imageworks and part of the ASWF. We’ve prepared more than 40 easy issues and enhancements that are ideal for first-time contributors. These tasks are straightforward, designed to take less than a day to complete, and some can be finished in just a few hours. Everyone is invited to participate and contribute!

🔗 OpenCue codebase: https://github.com/AcademySoftwareFoundation/OpenCue
📘 OpenCue documentation: https://docs.opencue.io
📖 Developer guide: https://docs.opencue.io/docs/developer-guide/index/
🧪 Using the OpenCue Sandbox for Testing: https://docs.opencue.io/docs/developer-guide/sandbox-testing/
💬 OpenCue Slack channel: https://academysoftwarefdn.slack.com/archives/CMFPXV39Q
✅ Available tasks/issues and enhancements (good first issue + help wanted): https://github.com/AcademySoftwareFoundation/OpenCue/issues?q=is%3Aissue%20state%3Aopen%20label%3A%22good%20first%20issue%22%20label%3A%22help%20wanted%22&page=2

---

✅ How to Contribute Effectively

• Focus on one issue at a time. Please don’t try to solve or implement all the main issues at once.
• When your work is complete, submit a full pull request (PR). We’ll review it as soon as possible.
• If your PR is not yet ready, submit it as a Draft Pull Request. Once you’re confident it’s ready, change the status to Open so maintainers know it can be reviewed.

How to create a Draft PR on GitHub:

1. When opening a pull request, click the dropdown on the green “Create pull request” button and select “Create draft pull request”.
2. Your PR will be clearly marked as Draft until you’re ready.
3. When it’s ready for review, click “Ready for review” at the top of the PR page - this changes the status to Open.

---

Thank you for your contribution!
Before we can move forward with the code review, please sign the CLA Authorization - EasyCLA

➡️ You only need to sign the CLA once, when you are submitting your first full request to the OpenCue project. After that, you’re all set for future contributions.

Everyone’s collaboration is very much appreciated. Thank you for helping grow OpenCue and for contributing to the software our industry relies on!

[ramonfigueiredo]

FYI ...

• [cueadmin/cuegui/cuesubmit/pycue/pyoutline/rqd] Standardize test file naming convention to test_*.py #1952

[ramonfigueiredo]

FYI

• [cueman] Add comprehensive test infrastructure and update documentation for Cueman #1954

Cueman Docs:

• Cueman - CLI Job Management Tool
• Cueman Tutorial

[ramonfigueiredo]

FYI ...

The OpenCue sandbox provides a quick way to run Cuebot, RQD, CueGUI, and CueSubmit locally for testing. This environment is ideal for developers who want to test changes, experiment with features, or learn how OpenCue works without setting up a full production environment.

• Using the OpenCue Sandbox for Testing