Add Inspect method & command to inspect db structure

[ahrtr]

Example 1: inspect etcd db file

$ ./bbolt inspect etcd_data_db_file 
{
    "name": "root",
    "keyN": 0,
    "buckets": [
        {
            "name": "alarm",
            "keyN": 0
        },
        {
            "name": "auth",
            "keyN": 2
        },
        {
            "name": "authRoles",
            "keyN": 1
        },
        {
            "name": "authUsers",
            "keyN": 1
        },
        {
            "name": "cluster",
            "keyN": 1
        },
        {
            "name": "key",
            "keyN": 1285
        },
        {
            "name": "lease",
            "keyN": 2
        },
        {
            "name": "members",
            "keyN": 1
        },
        {
            "name": "members_removed",
            "keyN": 0
        },
        {
            "name": "meta",
            "keyN": 3
        }
    ]
}

Example 2: inspect the db file generated in test case TestBucket_Inspect

$ ./bbolt inspect TestBucket_Inspect_db
{
    "name": "root",
    "keyN": 0,
    "buckets": [
        {
            "name": "b1",
            "keyN": 3,
            "buckets": [
                {
                    "name": "b1_1",
                    "keyN": 6
                },
                {
                    "name": "b1_2",
                    "keyN": 7
                },
                {
                    "name": "b1_3",
                    "keyN": 8
                }
            ]
        },
        {
            "name": "b2",
            "keyN": 4,
            "buckets": [
                {
                    "name": "b2_1",
                    "keyN": 10
                },
                {
                    "name": "b2_2",
                    "keyN": 12,
                    "buckets": [
                        {
                            "name": "b2_2_1",
                            "keyN": 2
                        },
                        {
                            "name": "b2_2_2",
                            "keyN": 3
                        }
                    ]
                },
                {
                    "name": "b2_3",
                    "keyN": 11
                }
            ]
        }
    ]
}

[ahrtr]

@fuweid @tjungblu @Elbehery

[fuweid]

LGTM

[sanjams2]

Just curious: was there a reason not to add this to the Run method as well?

Currently it seems the inspect command does not work, but the code is there thanks to this commit. trying to understand if that's intentional

[ahrtr]

When the commands are not found in the Run method, bbolt will automatically try to run the cobra commands,

bbolt/cmd/bbolt/main.go

Lines 68 to 69 in 92c7414

	} else if err == ErrUnknownCommand {
	cobraExecute()

Currently it seems the inspect command does not work

Have you tried it out? This isn't the first time I see this false statement. Please try it out, let me know whether you really have issue.

[sanjams2]

Using 1.3.11 I get:

$ bbolt inspect /tmp/meta.db
unknown command

[sanjams2]

Ok it seems the latest released version v1.3.11 does not have the changes you referenced (

bbolt/cmd/bbolt/main.go

Line 69 in d128a10

func main() {

). It was confusing though because the README references this command. I suspect that's why others are tripping up as well

[ahrtr]

New features, including this one, only go into main branch.

So please try the main branch or v1.4.0-beta.0

[ahrtr]

Refer to https://github.com/etcd-io/bbolt/blob/main/CHANGELOG/CHANGELOG-1.4.md