[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/run_tests.sh

@@ -58,4 +58,4 @@ fi
 
 echo "Running: $CMD"
 echo "----------------------------------------"
-$CMD
+$CMD

cueman/tox.ini

@@ -42,4 +42,4 @@ deps =
     isort>=5.12.0
 commands =
     black --check cueman tests
-    isort --check cueman tests
+    isort --check cueman tests

docs/_docs/reference/tools/cueman.md

@@ -419,7 +419,7 @@ cueman             # Running without args shows help
 
 ### Running Tests
 
-Cueman includes a comprehensive test suite with 42+ tests:
+Cueman includes a comprehensive test suite:
 
 ```bash
 # Install with test dependencies
@@ -461,5 +461,3 @@ The test suite is integrated into:
 ## Additional Resources
 
 - [Cueman Tutorial](/docs/tutorials/cueman-tutorial/) - Tutorial with real-world scenarios
-- [Cueman GitHub](https://github.com/AcademySoftwareFoundation/OpenCue/tree/master/cueman) - Source code and documentation
-- [OpenCue Documentation](/docs/) - Complete OpenCue documentation

docs/_docs/tutorials/cueman-tutorial.md

@@ -480,12 +480,11 @@ Cueman provides capabilities for OpenCue management. Start with simple operation
 - Practice with test jobs before using on production
 - Create scripts combining Cueman commands for automated workflows
 - Learn about [Cueman development and testing](/docs/reference/tools/cueman/#development-and-testing) if you want to contribute
-- Continue to the [Developer Guide](/docs/developer-guide/) to learn about contributing to OpenCue
 
 ## Development and Contributing
 
 Cueman is actively developed with:
-- **Comprehensive test suite** with 42+ tests covering unit and integration scenarios
+- **Comprehensive test suite** covering unit and integration scenarios
 - **Modern testing infrastructure** using pytest, coverage reporting, and CI/CD integration
 - **Development tools** including linting, formatting, and multi-Python version testing
 
@@ -502,5 +501,3 @@ pytest --cov=cueman --cov-report=term-missing
 black cueman tests && isort cueman tests
 pylint cueman tests
 ```
-
-See the [Cueman CONTRIBUTING.md](https://github.com/AcademySoftwareFoundation/OpenCue/blob/master/cueman/CONTRIBUTING.md) for detailed development guidelines.