feat: implement intitle method

Author: sundowndev

doc.go

@@ -0,0 +1,19 @@
+/*
+Package dorkgen is a Go package to generate dork requests for popular search engines such as Google, DuckDuckGo and Bing.
+It allows you to define requests programmatically and convert them into string.
+You can use it as following:
+
+package main
+
+import "github.com/sundowndev/dorkgen"
+
+func main() {
+	dork := &dorkgen.GoogleSearch{}
+	// dork := &dorkgen.DuckDuckGo{}
+	// dork := &dorkgen.Bing{}
+
+	dork.Site("example.com").Intext("text").ToString()
+	// returns: site:example.com "text"
+}
+*/
+package dorkgen

dorkgen.go

@@ -1,8 +1,8 @@
 package dorkgen
 
-// EngineFactory is the main interface for
+// engineFactory is the main interface for
 // search engine implementations.
-type EngineFactory interface {
+type engineFactory interface {
 	Site(string) *GoogleSearch
 	ToString() string
 	ToURL() string

google.go

@@ -14,11 +14,12 @@ const (
 	relatedTag  = "related:"
 	extTag      = "ext:"
 	excludeTag  = "-"
+	intitleTag  = "intitle:"
 )
 
 // GoogleSearch is the Google implementation for Dorkgen
 type GoogleSearch struct {
-	EngineFactory
+	engineFactory
 	tags []string
 }
 
@@ -109,3 +110,9 @@ func (e *GoogleSearch) Group(value string) *GoogleSearch {
 	e.tags = append(e.tags, "("+value+")")
 	return e
 }
+
+// Intitle ...
+func (e *GoogleSearch) Intitle(value string) *GoogleSearch {
+	e.tags = append(e.tags, concat(intitleTag, value, true))
+	return e
+}

google_test.go

@@ -8,118 +8,134 @@ import (
 
 var dork *GoogleSearch
 
-func TestToUrl(t *testing.T) {
-	dork = &GoogleSearch{}
+func TestInit(t *testing.T) {
+	assert := assert.New(t)
 
-	result := dork.
-		Site("example.com").
-		ToURL()
+	t.Run("should convert to URL correctly", func(t *testing.T) {
+		dork = &GoogleSearch{}
 
-	assert.Equal(t, result, "https://www.google.com/search?q=site%3Aexample.com", "they should be equal")
-}
+		result := dork.
+			Site("example.com").
+			ToURL()
 
-func TestSite(t *testing.T) {
-	dork = &GoogleSearch{}
+		assert.Equal(result, "https://www.google.com/search?q=site%3Aexample.com", "they should be equal")
+	})
 
-	result := dork.
-		Site("example.com").
-		ToString()
+	t.Run("should handle site tag correctly", func(t *testing.T) {
+		dork = &GoogleSearch{}
 
-	assert.Equal(t, result, "site:example.com", "they should be equal")
-}
+		result := dork.
+			Site("example.com").
+			ToString()
 
-func TestIntext(t *testing.T) {
-	dork = &GoogleSearch{}
+		assert.Equal(result, "site:example.com", "they should be equal")
+	})
 
-	result := dork.
-		Intext("text").
-		ToString()
+	t.Run("should handle intext tag correctly", func(t *testing.T) {
+		dork = &GoogleSearch{}
 
-	assert.Equal(t, result, "\"text\"", "they should be equal")
-}
+		result := dork.
+			Intext("text").
+			ToString()
 
-func TestInurl(t *testing.T) {
-	dork = &GoogleSearch{}
+		assert.Equal(result, "\"text\"", "they should be equal")
+	})
 
-	result := dork.
-		Inurl("index.php").
-		ToString()
+	t.Run("should handle inurl tag correctly", func(t *testing.T) {
+		dork = &GoogleSearch{}
 
-	assert.Equal(t, result, "inurl:\"index.php\"", "they should be equal")
-}
+		result := dork.
+			Inurl("index.php").
+			ToString()
 
-func TestFiletype(t *testing.T) {
-	dork = &GoogleSearch{}
+		assert.Equal(result, "inurl:\"index.php\"", "they should be equal")
+	})
 
-	result := dork.
-		Filetype("pdf").
-		ToString()
+	t.Run("should handle rrrrr tag correctly", func(t *testing.T) {
+		dork = &GoogleSearch{}
 
-	assert.Equal(t, result, "filetype:\"pdf\"", "they should be equal")
-}
+		result := dork.
+			Filetype("pdf").
+			ToString()
 
-func TestCache(t *testing.T) {
-	dork = &GoogleSearch{}
+		assert.Equal(result, "filetype:\"pdf\"", "they should be equal")
+	})
 
-	result := dork.
-		Cache("www.google.com").
-		ToString()
+	t.Run("should handle cache tag correctly", func(t *testing.T) {
+		dork = &GoogleSearch{}
 
-	assert.Equal(t, result, "cache:\"www.google.com\"", "they should be equal")
-}
+		result := dork.
+			Cache("www.google.com").
+			ToString()
 
-func TestRelated(t *testing.T) {
-	dork = &GoogleSearch{}
+		assert.Equal(result, "cache:\"www.google.com\"", "they should be equal")
+	})
 
-	result := dork.
-		Related("www.google.com").
-		ToString()
+	t.Run("should handle related tag correctly", func(t *testing.T) {
+		dork = &GoogleSearch{}
 
-	assert.Equal(t, result, "related:\"www.google.com\"", "they should be equal")
-}
+		result := dork.
+			Related("www.google.com").
+			ToString()
 
-func TestExt(t *testing.T) {
-	dork = &GoogleSearch{}
+		assert.Equal(result, "related:\"www.google.com\"", "they should be equal")
+	})
 
-	result := dork.
-		Ext("(doc | pdf | xls | txt | xml)").
-		ToString()
+	t.Run("should handle ext tag correctly", func(t *testing.T) {
+		dork = &GoogleSearch{}
 
-	assert.Equal(t, result, "ext:(doc | pdf | xls | txt | xml)", "they should be equal")
-}
+		result := dork.
+			Ext("(doc | pdf | xls | txt | xml)").
+			ToString()
 
-func TestExclude(t *testing.T) {
-	dork = &GoogleSearch{}
+		assert.Equal(result, "ext:(doc | pdf | xls | txt | xml)", "they should be equal")
+	})
 
-	result := dork.
-		Exclude("html").
-		Exclude("htm").
-		Exclude("php").
-		Exclude("md5sums").
-		ToString()
+	t.Run("should handle exclude tag correctly", func(t *testing.T) {
+		dork = &GoogleSearch{}
 
-	assert.Equal(t, result, "-html -htm -php -md5sums", "they should be equal")
-}
+		result := dork.
+			Exclude("html").
+			Exclude("htm").
+			Exclude("php").
+			Exclude("md5sums").
+			ToString()
 
-func TestOr(t *testing.T) {
-	dork = &GoogleSearch{}
+		assert.Equal(result, "-html -htm -php -md5sums", "they should be equal")
+	})
 
-	result := dork.
-		Site("facebook.com").
-		Or().
-		Site("twitter.com").
-		ToString()
+	t.Run("should handle or tag correctly", func(t *testing.T) {
+		dork = &GoogleSearch{}
 
-	assert.Equal(t, result, "site:facebook.com OR site:twitter.com", "they should be equal")
-}
+		result := dork.
+			Site("facebook.com").
+			Or().
+			Site("twitter.com").
+			ToString()
+
+		assert.Equal(result, "site:facebook.com OR site:twitter.com", "they should be equal")
+	})
+
+	t.Run("should handle group tag correctly", func(t *testing.T) {
+		dork = &GoogleSearch{}
+
+		result := dork.
+			Site("linkedin.com").
+			Group((&GoogleSearch{}).Intext("1").Or().Intext("2").ToString()).
+			ToString()
+
+		assert.Equal(result, "site:linkedin.com (\"1\" OR \"2\")", "they should be equal")
+	})
 
-func TestGroup(t *testing.T) {
-	dork = &GoogleSearch{}
+	t.Run("should handle rrrrr tag correctly", func(t *testing.T) {
+		dork = &GoogleSearch{}
 
-	result := dork.
-		Site("linkedin.com").
-		Group((&GoogleSearch{}).Intext("1").Or().Intext("2").ToString()).
-		ToString()
+		result := dork.
+			Site("linkedin.com").
+			Group((&GoogleSearch{}).Intext("1").Or().Intext("2").ToString()).
+			Intitle("jordan").
+			ToString()
 
-	assert.Equal(t, result, "site:linkedin.com (\"1\" OR \"2\")", "they should be equal")
+		assert.Equal(result, "site:linkedin.com (\"1\" OR \"2\") intitle:\"jordan\"", "they should be equal")
+	})
 }