About the merging of subcommands

[zhouhao3]

I do not understand why the image-tools in the three sub-command split into three software, I think these three commands should be combined into a tool, after all, they belong to image-tools, I think the merger will Easy to understand and application, if I was a user, I would think that the use of a software implementation of the three commands than the use of three software to implement a command to be more convenient.
I currently have a plan to merge, don't know how you think .

[zhouhao3]

@philips @vbatts @stevvooe @coolljt0725 @xiekeyang @runcom @wking

[wking]

I don't care either way.

[coolljt0725]

I prefer the merging just like oci-runtime-tool, but other maintainers may have other opinions :）

[stevvooe]

Could you please provide an example of the proposal?

I'd like to see some actual design work.

[zhouhao3]

@stevvooe #103 is some of my ideas, if possible, I will continue to improve.

[stevvooe]

@q384566678 That is a PR.

Do you have a design document?

[zhouhao3]

@stevvooe This picture is my overall idea, the above separation of the three functions into a whole function. This is not only convenient to use, but also to reduce the duplication of some functions.

[stevvooe]

@q384566678 Ok, that is a start.

However, it looks like this is just thrown together. Let's use an object verb pattern to structure the commands:

oci-image-tool [object] [verb]
oci-image-tool image validate IMAGE
oci-image-tool image unpack IMAGE
oci-image-tool bundle create DST IMAGE

The above is just an example, but as you can see, we need to do some thinking about the objects that exist and the actions that can be taken with them.

[zhouhao3]

@stevvooe OK, I will rectify the next, thank you for your suggestion.

[stevvooe]

@q384566678 Please don't make changes on this PR.

Make a design document with a proposal.

[zhouhao3]

@stevvooe I don't quite understand what you said design document, design ideas or the final generated file? would you please say this to me?

[stevvooe]

@q384566678 Write something that describes what you plan to do. It should include details about what commands and subcommands there are.

[zhouhao3]

@stevvooe Here's what I want to do：

oci-image-tool [global options] command [command options] [arguments...]

commands:
validate
bundleCreate
unpack
(In each order will have their own sub-command below)

global options:
--version
--help
(I'm going to add other options later in global options)

[stevvooe]

@q384566678 Let's try and organize around object verb. For example, your proposal begs the question "What am I unpacking?" and "What am I validating?". Can we achieve the same with the following:

bundle validate
bundle create
bundle unpack

However, I am still not sure what a bundle and what the difference between unpacking and creating is.

I think opencontainers/image-spec#467 needs to be fleshed out further.