Refactor source API (#1846)

* refactor source API and syft json source block

Signed-off-by: Alex Goodman <alex.goodman@anchore.com>

* update source detection and format test utils

Signed-off-by: Alex Goodman <alex.goodman@anchore.com>

* generate list of all source metadata types

Signed-off-by: Alex Goodman <wagoodman@users.noreply.github.com>

* extract base and root normalization into helper functions

Signed-off-by: Alex Goodman <wagoodman@users.noreply.github.com>

* preserve syftjson model package name import ref

Signed-off-by: Alex Goodman <wagoodman@users.noreply.github.com>

* alias should not be a pointer

Signed-off-by: Alex Goodman <wagoodman@users.noreply.github.com>

---------

Signed-off-by: Alex Goodman <alex.goodman@anchore.com>
Signed-off-by: Alex Goodman <wagoodman@users.noreply.github.com>

syft/file/cataloger/filedigest/cataloger_test.go

@@ -75,7 +75,7 @@ func TestDigestsCataloger(t *testing.T) {
 		t.Run(test.name, func(t *testing.T) {
 			c := NewCataloger(test.digests)
 
-			src, err := source.NewFromDirectory("test-fixtures/last/")
+			src, err := source.NewFromDirectoryPath("test-fixtures/last/")
 			require.NoError(t, err)
 
 			resolver, err := src.FileResolver(source.SquashedScope)
@@ -94,7 +94,7 @@ func TestDigestsCataloger_MixFileTypes(t *testing.T) {
 
 	img := imagetest.GetFixtureImage(t, "docker-archive", testImage)
 
-	src, err := source.NewFromImage(img, "---")
+	src, err := source.NewFromStereoscopeImageObject(img, testImage, nil)
 	if err != nil {
 		t.Fatalf("could not create source: %+v", err)
 	}

syft/file/cataloger/filemetadata/cataloger_test.go

@@ -20,7 +20,7 @@ func TestFileMetadataCataloger(t *testing.T) {
 
 	c := NewCataloger()
 
-	src, err := source.NewFromImage(img, "---")
+	src, err := source.NewFromStereoscopeImageObject(img, testImage, nil)
 	if err != nil {
 		t.Fatalf("could not create source: %+v", err)
 	}

syft/file/cataloger/internal/all_regular_files_test.go

@@ -27,7 +27,7 @@ func Test_allRegularFiles(t *testing.T) {
 
 				img := imagetest.GetFixtureImage(t, "docker-archive", testImage)
 
-				s, err := source.NewFromImage(img, "---")
+				s, err := source.NewFromStereoscopeImageObject(img, testImage, nil)
 				require.NoError(t, err)
 
 				r, err := s.FileResolver(source.SquashedScope)
@@ -41,7 +41,7 @@ func Test_allRegularFiles(t *testing.T) {
 		{
 			name: "directory",
 			setup: func() file.Resolver {
-				s, err := source.NewFromDirectory("test-fixtures/symlinked-root/nested/link-root")
+				s, err := source.NewFromDirectoryPath("test-fixtures/symlinked-root/nested/link-root")
 				require.NoError(t, err)
 				r, err := s.FileResolver(source.SquashedScope)
 				require.NoError(t, err)

syft/file/test-fixtures/req-resp/.gitignore

@@ -0,0 +1,2 @@
+path/to/abs-inside.txt
+path/to/the/abs-outside.txt

syft/file/test-fixtures/req-resp/path/to/rel-inside.txt

@@ -0,0 +1 @@
+./the/file.txt

syft/file/test-fixtures/req-resp/path/to/the/file.txt

@@ -0,0 +1 @@
+file-1

syft/file/test-fixtures/req-resp/path/to/the/rel-outside.txt

@@ -0,0 +1 @@
+../../../somewhere/outside.txt

syft/file/test-fixtures/req-resp/root-link

@@ -0,0 +1 @@
+./

syft/file/test-fixtures/req-resp/somewhere/outside.txt

@@ -0,0 +1 @@
+file-2