[cueman] Add comprehensive test infrastructure and update documentation for cueman

- Fix pylint issues in `test_integration_workflows.py`
* Add module docstring and fix import style
* Remove trailing whitespace and add proper spacing
* Achieve 10/10 pylint rating

- Fix SystemExit test failures in integration tests:
* Update test_batch_operation_workflow to use comma-separated job format
* Mock displayLayers function properly in workflow tests
* Remove incorrect SystemExit expectations where not applicable
* All tests now pass successfully

- Add pytest and test dependencies to pyproject.toml:
* Add test optional dependencies: pytest, pytest-cov, pytest-mock, mock, pyfakefs
* Add dev optional dependencies including pylint, black, isort
* Configure pytest.ini_options with test discovery and execution settings
* Add coverage configuration with HTML/XML report generation
* Include test markers for unit, integration, and slow tests

- Create test infrastructure tools:
* Add `run_tests.sh` convenience script for running tests with coverage options
* Add `tox.ini` for multi-Python version testing and code quality checks
* Include GitHub Actions workflow example in pyproject.toml comments

- Update documentation comprehensively:
* Enhance README.md with detailed testing section covering tests
* Add test infrastructure description and development workflow
* Update docs/reference/tools/cueman.md with development and testing section
* Enhance docs/tutorials/cueman-tutorial.md with contribution information

- Improve development experience:
* Document coverage reporting capabilities
* Provide clear testing and development guidelines
* Include CI/CD integration documentation
* Add code quality tool usage instructions

All tests pass with comprehensive coverage reporting and lint-free code.

Author: ramonfigueiredo

cueman/README.md

@@ -391,7 +391,7 @@ cueman -v -info job_name     # Enable verbose logging
 
 ## Running Tests
 
-Cueman includes a comprehensive test suite with 42+ tests covering unit tests and integration workflows.
+Cueman includes a comprehensive test suite with tests covering unit tests and integration workflows.
 
 ### Quick Start
 
@@ -409,11 +409,11 @@ pytest --cov=cueman --cov-report=term-missing
 ### Test Infrastructure
 
 **Test Dependencies:**
-- `pytest>=8.0.0` - Modern test framework
-- `pytest-cov>=4.0.0` - Coverage reporting
-- `pytest-mock>=3.10.0` - Enhanced mocking
-- `mock>=4.0.0` - Core mocking library
-- `pyfakefs>=5.2.3` - Filesystem mocking
+- `pytest` - Modern test framework
+- `pytest` - Coverage reporting
+- `pytest-mock` - Enhanced mocking
+- `mock` - Core mocking library
+- `pyfakefs` - Filesystem mocking
 
 **Test Types:**
 - **Unit tests** - Function-level testing (`tests/test_main.py`)
@@ -540,8 +540,6 @@ Source code available in /opt/opencue/cueman/
 
 ## Contributing
 
-We welcome contributions to Cueman! The project includes comprehensive development infrastructure:
-
 ### Development Setup
 
 ```bash
@@ -556,7 +554,7 @@ pip install -e ".[dev]"
 ### Testing and Quality
 
 ```bash
-# Run comprehensive test suite (42+ tests)
+# Run comprehensive test suite (tests)
 pytest --cov=cueman --cov-report=term-missing
 
 # Code formatting and linting
@@ -565,21 +563,4 @@ pylint cueman tests
 
 # Multi-environment testing
 tox
-```
-
-### Project Quality
-
-- **Comprehensive test coverage** with unit and integration tests
-- **Modern testing infrastructure** using pytest, coverage, and CI/CD
-- **Code quality tools** including pylint, black, and isort
-- **Multi-Python version support** via tox
-- **Docker support** for containerized development
-
-For detailed contribution guidelines, see [CONTRIBUTING.md](CONTRIBUTING.md).
-
-### Get Involved
-
-- **Report Issues**: [GitHub Issues](https://github.com/AcademySoftwareFoundation/OpenCue/issues)
-- **Contribute Code**: Submit pull requests with tests and documentation
-- **Improve Documentation**: Help enhance tutorials and reference docs
-- **Share Use Cases**: Contribute real-world examples and workflows
+```

cueman/cueman/__init__.py

@@ -16,7 +16,8 @@
 """OpenCue Cueman job management tool."""
 
 try:
-    from importlib.metadata import version, PackageNotFoundError
+    from importlib.metadata import PackageNotFoundError, version
+
     try:
         __version__ = version("opencue_cueman")
     except PackageNotFoundError:
@@ -26,6 +27,7 @@
     # Python < 3.8
     try:
         import pkg_resources
+
         __version__ = pkg_resources.get_distribution("opencue_cueman").version
     except Exception:
         __version__ = "0.0.0+unknown"

cueman/cueman/__main__.py

@@ -16,9 +16,7 @@
 """Entrypoint for Cueman tool."""
 
 
-from __future__ import absolute_import
-from __future__ import division
-from __future__ import print_function
+from __future__ import absolute_import, division, print_function
 
 import logging
 import sys
@@ -27,7 +25,9 @@
 from cueman import main as opencueman
 
 # Suppress protobuf version warnings
-warnings.filterwarnings("ignore", category=UserWarning, module="google.protobuf.runtime_version")
+warnings.filterwarnings(
+    "ignore", category=UserWarning, module="google.protobuf.runtime_version"
+)
 
 logger = logging.getLogger("opencue.tools.cueman")
 
@@ -37,5 +37,5 @@ def main():
     opencueman.main(sys.argv)
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     main()