Files
mscclpp/docs
Qinghua Zhou 16a96ea77b Support detailed version tracking that captures git repository information (#639)
#### Version Format

The package version includes the git commit hash directly in the version
string for development builds:
- **Release version**: `0.7.0`
- **Development version**: `0.7.0.dev36+g6e2360d69` (includes short
commit hash)
- **Development with uncommitted changes**:
`0.7.0.dev36+g6e2360d69.dirty`

#### Checking Version Information

After installation, you can check the version information in several
ways:

**From Python:**
```python
import mscclpp

# Access individual attributes
print(f"Version: {mscclpp.__version__}")           # Full version with commit
Version: 0.7.0.dev36+g6e2360d69

# Get as dictionary
mscclpp.version()
{'version': '0.7.0.dev46+gb0d27c58f', 'base_version': '0.7.0', 'git_commit': 'b0d27c58f'}
```

#### Version Information Details

The version tracking captures:
- **Package Version** (`mscclpp.__version__`): Full version string
including git commit (e.g., `0.7.0.dev36+g6e2360d69`)

This information is embedded during the package build process and
remains accessible even after distribution, making it easier to debug
issues and ensure reproducibility.

---------

Co-authored-by: Binyang Li <binyli@microsoft.com>
2025-09-30 09:00:33 -07:00
..
2025-08-07 15:37:37 -07:00
2025-08-09 00:36:20 -07:00
2025-08-07 15:37:37 -07:00
2025-08-11 10:34:29 -07:00
2025-08-11 10:34:29 -07:00
2025-08-07 15:37:37 -07:00
2025-08-07 15:37:37 -07:00
2025-08-11 10:34:29 -07:00
2023-11-22 12:58:04 -08:00
2023-11-22 12:58:04 -08:00
2025-08-07 15:37:37 -07:00
2025-08-11 10:34:29 -07:00
2024-10-18 06:08:31 +00:00
2025-08-07 15:37:37 -07:00

How to build docs

  1. Install doxygen.

    $ sudo apt-get install doxygen graphviz
    
  2. Install Python packages below. If you install them on the user's local, you need to include ~/.local/bin to $PATH (to use sphinx-build).

    $ sudo python3 -m pip install -r ./requirements.txt
    
  3. Create Doxygen documents.

    $ doxygen
    
  4. Create Sphinx documents.

    $ make html
    
  5. Done. The HTML files will be on _build/ directory.