Showing Components¶
Use the show subcommand to view detailed information about a component. This includes the component name, it’s version, URL. Optionally, every file that makes up the component can be listed along with it’s md5sum.
Example: Viewing information about rook¶
$ hcm show bishop
---------- --------------------------------------------------------------------------
Component bishop
Version 1.1.0
URL http://svn/my_repo/comps
Source http://svn/my_repo/trunk/project_chess/components/bishop@26
---------- --------------------------------------------------------------------------
Example: Viewing manifest¶
$ hcm show rook --manifest
---------- ------------------------------------------------------------------------
Component rook
Version 3.0.0
URL http://svn/my_repo/comps
Source http://svn/my_repo/trunk/project_chess/components/rook@15
---------- ------------------------------------------------------------------------
Manifest
---------------------------------------------------------
10019aef04979acfac88673bc5dc6133 rook/lay/filelist.tcl
a461fa565f1f7822bcdbda0b450df476 rook/rtl/rook.vhd
Note
The manifest is extracted from the hcm.json file. It does not include any local changes to the files. Use the validate subcommand to compare the manifest against what is installed.
Example: Viewing available upgrades¶
All available upgrades and their log entries can be listed.
$ hcm show rook --upgrades
------------ ------------------------------------------------------------------------
Component rook
Version 3.0.0
URL http://svn/my_repo/comps
Source http://svn/my_repo/trunk/project_chess/components/rook@41
Dependencies king, queen
------------ ------------------------------------------------------------------------
Available Upgrades
==================
Version: 4.0.0
------------------------------------------------------------------------
r42 | jeremiah | 2019-06-11 19:09:53 -0500 (Tue, 11 Jun 2019) | 1 line
"testing dependencies"
------------------------------------------------------------------------
Version: 3.0.5
------------------------------------------------------------------------
r51 | jeremiah | 2019-06-13 19:37:16 -0500 (Thu, 13 Jun 2019) | 1 line
"Updating hcm config to the latest version."
------------------------------------------------------------------------
Version: 3.0.4
------------------------------------------------------------------------
r49 | jeremiah | 2019-06-12 20:02:38 -0500 (Wed, 12 Jun 2019) | 1 line
"Adding invalid component to test how HCM handles it."
------------------------------------------------------------------------
Version: 3.0.3
------------------------------------------------------------------------
r35 | jeremiah | 2019-05-30 22:00:03 -0500 (Thu, 30 May 2019) | 1 line
"testing -m works"
------------------------------------------------------------------------
Version: 3.0.2
------------------------------------------------------------------------
r34 | jeremiah | 2019-05-30 21:58:38 -0500 (Thu, 30 May 2019) | 6 lines
This is a test of using the -F argument when publishing.
It should allow the use of a file instead of a single line for the commit message.
------------------------------------------------------------------------
Version: 3.0.1
------------------------------------------------------------------------
r33 | jeremiah | 2019-05-30 21:57:37 -0500 (Thu, 30 May 2019) | 6 lines
This is a test of using the -F argument when publishing.
It should allow the use of a file instead of a single line for the commit message.
------------------------------------------------------------------------
Example: Viewing available updates¶
Updates are slightly different than upgrades. Updates include all versions that were committed after the currently installed version.
$ hcm show rook --updates
------------ ------------------------------------------------------------------------
Component rook
Version 3.0.0
URL http://svn/my_repo/comps
Source http://svn/my_repo/trunk/project_chess/components/rook@41
Dependencies king, queen
------------ ------------------------------------------------------------------------
Available Upgrades
==================
Version: 3.0.5
------------------------------------------------------------------------
r51 | jeremiah | 2019-06-13 19:37:16 -0500 (Thu, 13 Jun 2019) | 1 line
"Updating hcm config to the latest version."
------------------------------------------------------------------------
Version: 3.0.4
------------------------------------------------------------------------
r49 | jeremiah | 2019-06-12 20:02:38 -0500 (Wed, 12 Jun 2019) | 1 line
"Adding invalid component to test how HCM handles it."
------------------------------------------------------------------------
Version: 4.0.0
------------------------------------------------------------------------
r42 | jeremiah | 2019-06-11 19:09:53 -0500 (Tue, 11 Jun 2019) | 1 line
"testing dependencies"
------------------------------------------------------------------------
Version: 3.0.3
------------------------------------------------------------------------
r35 | jeremiah | 2019-05-30 22:00:03 -0500 (Thu, 30 May 2019) | 1 line
"testing -m works"
------------------------------------------------------------------------
Version: 3.0.2
------------------------------------------------------------------------
r34 | jeremiah | 2019-05-30 21:58:38 -0500 (Thu, 30 May 2019) | 6 lines
This is a test of using the -F argument when publishing.
It should allow the use of a file instead of a single line for the commit message.
------------------------------------------------------------------------
Version: 3.0.1
------------------------------------------------------------------------
r33 | jeremiah | 2019-05-30 21:57:37 -0500 (Thu, 30 May 2019) | 6 lines
This is a test of using the -F argument when publishing.
It should allow the use of a file instead of a single line for the commit message.
------------------------------------------------------------------------
Example: Viewing modifications¶
Modifications made to a component after installation can be viewed. The –modifications argument will display the log entries for every change since the last install. Both committed and uncommitted modifications will be shown.
$ hcm show rook --modifications
------------ ------------------------------------------------------------------------
Component rook
Version 4.0.0
URL http://svn/my_repo/comps
Source http://svn/my_repo/trunk/project_chess/components/rook@41
Dependencies king, queen
------------ ------------------------------------------------------------------------
Uncommitted Modifications
=========================
A + rook
? rook/rtl/movement.vhd
M + rook/rtl/rook-rtl.vhd
Committed Modifications
=======================
------------------------------------------------------------------------
r63 | jeremiah | 2019-06-21 06:13:40 -0500 (Fri, 21 Jun 2019) | 2 lines
Minor change to rook entity.
------------------------------------------------------------------------
r62 | jeremiah | 2019-06-21 06:05:24 -0500 (Fri, 21 Jun 2019) | 2 lines
Adding architecture.
------------------------------------------------------------------------
HCM will also indicate if no modifications were detected.
$ hcm show rook --modifications
------------ ------------------------------------------------------------------------
Component rook
Version 4.0.0
URL http://svn/my_repo/comps
Source http://svn/my_repo/trunk/project_chess/components/rook@41
Dependencies king, queen
------------ ------------------------------------------------------------------------
Uncommitted Modifications
=========================
No Uncommitted Modifications
Committed Modifications
=======================
No Committed Modifications