تعلّم Go بالاختبارات

تثبيت Go وتجهيز بيئة عمل منتجة

Mon, 01 Jan 0001 00:00:00 +0000

تثبيت Go وتجهيز بيئة عمل منتجة

تعليمات تثبيت Go الرسمية متاحة هنا.

بيئة Go

وحدات Go (Modules)

أضافت Go 1.11 الوحدات، وهي وضع البناء الافتراضي منذ Go 1.16، لذلك لا يُنصح باستخدام GOPATH.

تحل الوحدات مشكلات إدارة الاعتماديات (dependencies) واختيار الإصدارات والبناء القابل للتكرار (reproducible builds)، كما أنها تتيح تشغيل كود Go خارج GOPATH.

قليل من السياق: ماذا كان قبل الوحدات؟ قبل Go 1.11، كانت أدوات Go تعتمد على قاعدة اسمها GOPATH، وهو متغير بيئة يشير إلى مجلد واحد على جهازك (عادة ~/go) يجب أن يعيش داخله كل كود Go. كل مشروع وكل اعتمادية وكل حزمة مترجَمة كانت تُخزَّن تحت ذلك المجلد. أي أنك لم تكن تستطيع إنشاء مجلد في أي مكان والبدء في كتابة Go، لأن المترجم لن يعرف كيف يحل الـ imports خارج GOPATH.

مرحبًا بالعالم

Mon, 01 Jan 0001 00:00:00 +0000

مرحبًا بالعالم

يمكنك العثور على كل كود هذا الفصل هنا

من التقاليد أن يكون أول برنامج تكتبه بأي لغة جديدة هو Hello, World.

أنشئ مجلدًا في أي مكان تريده
ضع داخله ملفًا جديدًا اسمه hello.go واكتب فيه الكود التالي

package main

import "fmt"

func main() {
	fmt.Println("Hello, world")
}

ولتشغيله اكتب go run hello.go.

كيف يعمل هذا؟

عند كتابة برنامج في Go، سيكون لديك حزمة main معرَّفة بداخلها دالة main. والحزم (packages) هي طريقة لتجميع كود Go المرتبط ببعضه.

الأعداد الصحيحة

Mon, 01 Jan 0001 00:00:00 +0000

الأعداد الصحيحة

يمكنك العثور على كل كود هذا الفصل هنا

تعمل الأعداد الصحيحة كما تتوقع. لنكتب دالة Add لتجربة الأمر. أنشئ ملف اختبار اسمه adder_test.go واكتب فيه هذا الكود.

ملاحظة: يمكن لملفات مصدر Go أن تحتوي على package واحدة فقط لكل مجلد. تأكد من تنظيم ملفاتك في حزم خاصة بها. إليك شرحًا جيدًا لهذا.

ورُبما يبدو مجلد مشروعك هكذا:

learnGoWithTests
 |
 |-> helloworld
 | |- hello.go
 | |- hello_test.go
 |
 |-> integers
 | |- adder_test.go
 |
 |- go.mod
 |- README.md

اكتب الاختبار أولًا

package integers

import "testing"

func TestAdder(t *testing.T) {
	sum := Add(2, 2)
	expected := 4

	if sum != expected {
		t.Errorf("expected '%d' but got '%d'", expected, sum)
	}
}

ستلاحظ أننا نستخدم %d بدلًا من %q في نصوص التنسيق، لأننا نريد طباعة عدد صحيح لا نص.

التكرار

Mon, 01 Jan 0001 00:00:00 +0000

التكرار

يمكنك العثور على كل كود هذا الفصل هنا

لتكرار عمل ما في Go، ستحتاج إلى for. فلا توجد في Go كلمات مفتاحية مثل while وdo وuntil، وكل ما يمكنك استخدامه هو for. وهذا شيء جيد!

لنكتب اختبارًا لدالة تكرر حرفًا خمس مرات.

لا يوجد جديد حتى الآن، لذا جرّب كتابته بنفسك للتدريب.

اكتب الاختبار أولًا

package iteration

import "testing"

func TestRepeat(t *testing.T) {
	repeated := Repeat("a")
	expected := "aaaaa"

	if repeated != expected {
		t.Errorf("expected %q but got %q", expected, repeated)
	}
}

جرّب تشغيل الاختبار

./repeat_test.go:6:14: undefined: Repeat

المصفوفات والشرائح

Mon, 01 Jan 0001 00:00:00 +0000

المصفوفات والشرائح

يمكنك العثور على كل كود هذا الفصل هنا

تتيح لك المصفوفات (arrays) تخزين عدة عناصر من النوع نفسه في متغير واحد بترتيب معين.

وعندما يكون لديك مصفوفات، فمن الشائع جدًا أن تحتاج إلى المرور عليها عنصرًا عنصرًا. لذا دعنا نستخدم معرفتنا الجديدة بـ for لبناء دالة Sum تأخذ مصفوفة أرقام وتُرجع المجموع.

لنستخدم مهاراتنا في التطوير الموجه بالاختبار.

اكتب الاختبار أولًا

أنشئ مجلدًا جديدًا للعمل فيه. ثم أنشئ ملفًا جديدًا اسمه sum_test.go وضع فيه ما يلي:

Structs والـ Methods والـ Interfaces

Mon, 01 Jan 0001 00:00:00 +0000

Structs والـ Methods والـ Interfaces

يمكنك العثور على كل كود هذا الفصل هنا

لنفترض أننا نحتاج إلى بعض كود الهندسة لحساب محيط مستطيل بمعلومية الارتفاع والعرض. يمكننا كتابة دالة Perimeter(width float64, height float64)، حيث float64 مخصصة للأعداد العشرية مثل 123.45.

ومن المفترض أن تكون دورة التطوير الموجه بالاختبار مألوفة لك تمامًا الآن.

اكتب الاختبار أولًا

func TestPerimeter(t *testing.T) {
	got := Perimeter(10.0, 10.0)
	want := 40.0

	if got != want {
		t.Errorf("got %.2f want %.2f", got, want)
	}
}

هل لاحظت نص التنسيق الجديد؟ الحرف f مخصص لـ float64، و.2 تعني طباعة منزلتين عشريتين.

المؤشرات والأخطاء

Mon, 01 Jan 0001 00:00:00 +0000

المؤشرات والأخطاء

يمكنك العثور على كل كود هذا الفصل هنا

تعرّفنا في القسم السابق على الـ structs التي تتيح لنا تجميع عدد من القيم المرتبطة بمفهوم واحد.

وقد ترغب في مرحلة ما في استخدام الـ structs لإدارة الحالة (state)، مع كشف methods تتيح للمستخدمين تغيير تلك الحالة بالطريقة التي تتحكم بها أنت.

قطاع التقنية المالية (fintech) يعشق Go و… البيتكوين؟ فلنُظهر إذن ما يمكننا بناؤه من نظام مصرفي مذهل.

لننشئ struct اسمه Wallet يتيح لنا إيداع Bitcoin.

الـ Maps

Mon, 01 Jan 0001 00:00:00 +0000

الـ Maps

يمكنك العثور على كل كود هذا الفصل هنا

في المصفوفات والشرائح، رأيت كيف تخزّن القيم بالترتيب. والآن سننظر إلى طريقة لتخزين العناصر حسب key (مفتاح) والبحث عنها بسرعة.

تتيح لك الـ Maps تخزين العناصر بطريقة تشبه القاموس؛ فيمكنك التفكير في الـ key كأنها الكلمة، وفي الـ value كأنه التعريف. وهل توجد طريقة أفضل لتعلّم الـ Maps من بناء قاموسنا الخاص؟

أولًا، بافتراض أن لدينا بالفعل بعض الكلمات وتعريفاتها في القاموس، فإذا بحثنا عن كلمة ينبغي أن يُرجع لنا تعريفها.

حقن الاعتماديات (Dependency Injection)

Mon, 01 Jan 0001 00:00:00 +0000

حقن الاعتماديات (Dependency Injection)

يمكنك العثور على كل كود هذا الفصل هنا

من المفترض أنك قرأت فصل الـ structs من قبل، لأننا سنحتاج إلى بعض الفهم للـ interfaces هنا.

هناك الكثير من سوء الفهم حول حقن الاعتماديات في أوساط البرمجة. آمل أن يوضح لك هذا الدليل أنّ:

لا تحتاج إلى إطار عمل (framework)
وأنه لا يزيد تصميمك تعقيدًا
وأنه يسهّل الاختبار
وأنه يتيح لك كتابة دوال عامة رائعة.

نريد كتابة دالة تسلّم على شخص، تمامًا كما فعلنا في فصل hello-world، لكننا هذه المرة سنختبر الطباعة الفعلية.

الـ Mocking

Mon, 01 Jan 0001 00:00:00 +0000

الـ Mocking

يمكنك العثور على كل كود هذا الفصل هنا

طُلب منك كتابة برنامج يعدّ تنازليًا من 3، ويطبع كل رقم في سطر جديد (مع توقف لمدة ثانية واحدة)، وعندما يصل إلى الصفر يطبع “Go!” ويخرج.

3
2
1
Go!

سنعالج هذا بكتابة دالة اسمها Countdown ثم نضعها داخل برنامج main ليصبح الأمر هكذا:

package main

func main() {
	Countdown()
}

ومع أن هذا برنامج بسيط للغاية، فإن اختباره اختبارًا كاملًا سيقتضي منا كما في كل مرة اتباع منهج تكراري و_موجه بالاختبار_.

التزامن (Concurrency)

Mon, 01 Jan 0001 00:00:00 +0000

التزامن (Concurrency)

يمكنك العثور على كل كود هذا الفصل هنا

إليك البداية: كتب زميل لك دالة اسمها CheckWebsites تفحص حالة قائمة من عناوين URL.

package concurrency

type WebsiteChecker func(string) bool

func CheckWebsites(wc WebsiteChecker, urls []string) map[string]bool {
	results := make(map[string]bool)

	for _, url := range urls {
		results[url] = wc(url)
	}

	return results
}

تُرجع الدالة خريطة (map) تربط كل عنوان URL تم فحصه بقيمة منطقية (boolean): true لاستجابة جيدة، وfalse لاستجابة سيئة.

الـ Select

Mon, 01 Jan 0001 00:00:00 +0000

الـ Select

يمكنك العثور على كل كود هذا الفصل هنا

طُلب منك أن تكتب دالة اسمها WebsiteRacer تأخذ رابطين (URLs) و"تتسابق" بينهما بإرسال طلب HTTP GET إلى كل منهما، ثم تُرجع الرابط الذي عاد أولًا. وإذا لم يعد أي منهما خلال 10 ثوانٍ، فعليها أن تُرجع error.

ولهذا سنستخدم:

net/http لإجراء استدعاءات HTTP.
net/http/httptest لمساعدتنا في اختبارها.
الـ goroutines.
select لمزامنة العمليات.

اكتب الاختبار أولًا

لنبدأ بشيء بسيط (naive) لننطلق منه.

الـ Reflection

Mon, 01 Jan 0001 00:00:00 +0000

الـ Reflection

يمكنك العثور على كل كود هذا الفصل هنا

من X

تحدي golang: اكتب دالة walk(x interface{}, fn func(string)) تأخذ struct اسمه x وتستدعي fn على كل حقول النصوص الموجودة بداخله. مستوى الصعوبة: العودية.

لفعل ذلك سنحتاج إلى استخدام الـ Reflection.

الـ Reflection في الحوسبة هو قدرة برنامج على فحص بنيته الخاصة، ولا سيما عبر الأنواع؛ وهو شكل من أشكال البرمجة الفوقية (metaprogramming). وهو أيضًا مصدر كبير للحيرة.

من مدونة Go: الـ Reflection

الـ Sync

Mon, 01 Jan 0001 00:00:00 +0000

الـ Sync

يمكنك العثور على كل كود هذا الفصل هنا

نريد أن نصنع عدّادًا (counter) يمكن استخدامه بأمان في الـ concurrency.

سنبدأ بعدّاد غير آمن ونتحقق من أن سلوكه سليم في بيئة أحادية الـ thread.

ثم نستعرض عدم أمانه عبر اختبار تُحاول فيه عدة goroutines استخدام العدّاد في الوقت نفسه، ثم نصلح المشكلة.

اكتب الاختبار أولًا

نريد أن تمنحنا واجهة برمجتنا (API) method لزيادة العدّاد ثم استرجاع قيمته.

func TestCounter(t *testing.T) {
	t.Run("incrementing the counter 3 times leaves it at 3", func(t *testing.T) {
		counter := Counter{}
		counter.Inc()
		counter.Inc()
		counter.Inc()

		if counter.Value() != 3 {
			t.Errorf("got %d, want %d", counter.Value(), 3)
		}
	})
}

جرّب تشغيل الاختبار

./sync_test.go:9:14: undefined: Counter

اكتب أصغر قدر من الكود ليعمل الاختبار وافحص مخرجاته الفاشلة

لنعرّف Counter.

الـ Context

Mon, 01 Jan 0001 00:00:00 +0000

الـ Context

يمكنك العثور على كل كود هذا الفصل هنا

كثيرًا ما تُطلق البرمجيات عمليات طويلة الأمد وشرهة للموارد (وغالبًا في صورة goroutines). وإذا أُلغيت العملية التي تسببت في ذلك أو فشلت لسبب ما، فستحتاج إلى إيقاف هذه العمليات بطريقة متسقة في كل أنحاء تطبيقك.

وإذا لم تدِر ذلك، فقد يبدأ تطبيقك الـ Go السريع الذي تفتخر به في الظهور بمشكلات أداء يصعب تتبعها.

في هذا الفصل سنستخدم حزمة context لمساعدتنا في إدارة العمليات طويلة الأمد.

مقدمة إلى الاختبارات القائمة على الخصائص (Property Based Tests)

Mon, 01 Jan 0001 00:00:00 +0000

الأرقام الرومانية

يمكنك العثور على كل كود هذا الفصل هنا

قد تطلب بعض الشركات منك أداء تمرين الأرقام الرومانية (Roman Numeral Kata) ضمن عملية المقابلة. وسيوضح لك هذا الفصل كيف تتعامل معه مستعينًا بالتطوير الموجه بالاختبار (TDD).

سنكتب دالة تحوّل عددًا عربيًا (الأعداد من 0 إلى 9) إلى رقم روماني.

إن لم تكن قد سمعت عن الأرقام الرومانية، فهي الطريقة التي كان الرومان يكتبون بها الأعداد.

تبنيها بلصق رموز بعضها ببعض، وتلك الرموز تمثل أعدادًا.

الرياضيات

Mon, 01 Jan 0001 00:00:00 +0000

الرياضيات

يمكنك العثور على كل كود هذا الفصل هنا

مهما بلغت قوة الحواسيب الحديثة في إجراء عمليات جمع هائلة بسرعة البرق، فنادرًا ما يستخدم المطور العادي أي رياضيات في عمله. لكن ليس اليوم! سنستخدم اليوم الرياضيات لحل مشكلة حقيقية. وليست رياضيات مملة - سنستخدم حساب المثلثات والمتجهات وكل تلك الأشياء التي كنت تقول دائمًا إنك لن تحتاج إليها بعد الثانوية.

المشكلة

تريد أن تصنع صورة SVG لساعة. لا ساعة رقمية - لا، فتلك ستكون سهلة - بل ساعة عقارب، لها عقارب. ولا تبحث عن شيء فخم، فقط دالة لطيفة تأخذ Time من حزمة time وتُخرج SVG لساعة بكل عقاربها - الساعات والدقائق والثواني - مشيرة في الاتجاه الصحيح. فما مدى صعوبة ذلك؟

قراءة الملفات

Mon, 01 Jan 0001 00:00:00 +0000

قراءة الملفات

في هذا الفصل سنتعلم كيف نقرأ بعض الملفات، ونستخرج منها بعض البيانات، ونفعل شيئًا مفيدًا.

تخيّل أنك تعمل مع صديقك على بناء برمجيات تدوين. الفكرة أن يكتب الكاتب منشوراته بصيغة markdown، مع بعض البيانات الوصفية (metadata) في أعلى الملف. وعند بدء التشغيل، سيقرأ خادم الويب مجلدًا ليبني بعض Posts، ثم تستخدم دالة NewHandler منفصلة تلك Posts كمصدر بيانات لخادم المدونة.

القوالب (Templating)

Mon, 01 Jan 0001 00:00:00 +0000

القوالب (Templating)

يمكنك العثور على كل كود هذا الفصل هنا

نعيش في عالم يريد فيه الجميع بناء تطبيقات ويب بأحدث صيحة رائجة من إطارات عمل الواجهات الأمامية، مبنية فوق غيغابايتات من JavaScript المُحوَّلة (transpiled)، وتعمل مع نظام بناء بالغ التعقيد؛ لكن ربما لا يكون ذلك ضروريًا دائمًا.

وأود القول إن معظم مطوري Go يقدّرون سلسلة أدوات بسيطة ومستقرة وسريعة، لكن عالم الواجهات الأمامية كثيرًا ما يخفق في تقديم ذلك.

كثيرة هي المواقع التي لا تحتاج إلى أن تكون تطبيقات صفحة واحدة (SPA). فـ HTML و CSS طريقتان رائعتان لتقديم المحتوى، ويمكنك استخدام Go لبناء موقع يقدّم HTML.

الـ Generics

Mon, 01 Jan 0001 00:00:00 +0000

الـ Generics

يمكنك العثور على كل كود هذا الفصل هنا

سيقدّم لك هذا الفصل مقدمة عن الـ generics، ويُزيل أي تحفظات قد تكون لديك تجاهها، ويعطيك فكرة عن كيفية تبسيط بعض كودك في المستقبل. وبعد قراءته ستعرف كيف تكتب:

دالة تأخذ وسائط من نوع generic
نوع بيانات generic

دوال المساعدة في اختباراتنا (`AssertEqual`, `AssertNotEqual`)

لاستكشاف الـ generics سنكتب بعض دوال المساعدة (test helpers).

التحقق من الأعداد الصحيحة

لنبدأ بشيء بسيط ثم نتقدم خطوة بخطوة نحو هدفنا

إعادة زيارة المصفوفات والشرائح مع الـ Generics

Mon, 01 Jan 0001 00:00:00 +0000

إعادة زيارة المصفوفات والشرائح مع الـ Generics

كود هذا الفصل تكملة لفصل المصفوفات والشرائح، وتجده هنا

ألقِ نظرة على كل من SumAll وSumAllTails اللتين كتبناهما في المصفوفات والشرائح. وإذا لم تكن تحتفظ بنسختك، فانسخ الكود من فصل المصفوفات والشرائح مع الاختبارات.

// Sum calculates the total from a slice of numbers.
func Sum(numbers []int) int {
	var sum int
	for _, number := range numbers {
		sum += number
	}
	return sum
}

// SumAllTails calculates the sums of all but the first number given a collection of slices.
func SumAllTails(numbersToSum ...[]int) []int {
	var sums []int
	for _, numbers := range numbersToSum {
		if len(numbers) == 0 {
			sums = append(sums, 0)
		} else {
			tail := numbers[1:]
			sums = append(sums, Sum(tail))
		}
	}

	return sums
}

هل ترى نمطًا متكررًا؟

مقدمة إلى اختبارات القبول

Mon, 01 Jan 0001 00:00:00 +0000

مقدمة إلى اختبارات القبول

في $WORK، كنا نواجه حاجة متكررة إلى “الإيقاف الرشيق” (graceful shutdown) لخدماتنا. فالإيقاف الرشيق يضمن أن نظامك يُنهي عمله كما ينبغي قبل إنهائه. ومثال من الحياة الواقعية: شخص يحاول إنهاء مكالمة هاتفية على نحو لائق قبل الانتقال إلى الاجتماع التالي، بدلًا من إغلاقها في منتصف الجملة.

سيقدّم هذا الفصل مقدمة عن الإيقاف الرشيق في سياق خادم HTTP، وعن كيفية كتابة “اختبارات القبول” (acceptance tests) لتمنح نفسك ثقة في سلوك كودك.

توسيع نطاق اختبارات القبول

Mon, 01 Jan 0001 00:00:00 +0000

توسيع نطاق اختبارات القبول

هذا الفصل تكملة لفصل مقدمة إلى اختبارات القبول. ويمكنك العثور على كود هذا الفصل النهائي على GitHub.

اختبارات القبول ضرورية، وهي تؤثر تأثيرًا مباشرًا في قدرتك على تطوير نظامك بثقة عبر الزمن، وبكلفة تغيير معقولة.

وهي أيضًا أداة بديعة تساعدك في التعامل مع الكود القديم (legacy code). فحين تواجه قاعدة كود ضعيفة بلا أي اختبارات، قاوم الرغبة في البدء بإعادة الهيكلة. واكتب بدلًا من ذلك بعض اختبارات القبول لتصنع لنفسك شبكة أمان تتيح لك تغيير داخل النظام بحرية دون التأثير في سلوكه الخارجي الوظيفي. فاختبارات القبول لا تهتم بالجودة الداخلية، لذا فهي مناسبة جدًا لهذه المواقف.

العمل بدون الـ Mocks والـ Stubs والـ Spies

Mon, 01 Jan 0001 00:00:00 +0000

العمل بدون الـ Mocks والـ Stubs والـ Spies

يتعمّق هذا الفصل في عالم الـ test doubles، ويستكشف كيف تؤثر في عملية الاختبار والتطوير. سنكشف حدود الـ mocks والـ stubs والـ spies التقليدية، ثم نقدّم نهجًا أكثر كفاءة وقابلية للتكيّف باستخدام الـ fakes والـ contracts.

باختصار

الـ Mocks والـ spies والـ stubs تشجعك على ترميز افتراضاتك حول سلوك اعتمادياتك بشكل ارتجالي (ad-hoc) في كل اختبار.
وهذه الافتراضات لا يُتحقق منها عادةً إلا يدويًا، ما يهدد فائدة مجموعة اختباراتك.
أما الـ fakes والـ contracts فتمنحاننا طريقة أكثر استدامة لإنشاء test doubles بافتراضات مُتحقق منها، وبإعادة استخدام أفضل من البدائل الأخرى.

هذا الفصل أطول من المعتاد، فلنأخذ نفسًا قصيرًا، ابدأ باستكشاف مستودع الأمثلة. وبالأخص، ألقِ نظرة على اختبار planner.

قائمة تحقق إعادة الهيكلة

Mon, 01 Jan 0001 00:00:00 +0000

خطوة إعادة الهيكلة، قائمة تحقق البداية

إعادة الهيكلة (refactoring) مهارة تصبح، بفعل التدريب الكافي، طبيعة ثانية سهلة في معظم الحالات.

وكثيرًا ما يُخلط بين هذا النشاط وتغييرات تصميمية أكبر، لكنهما منفصلان. والتمييز بين إعادة الهيكلة وغيرها من أنشطة البرمجة مفيد لأنه يتيح لي العمل بوضوح وانضباط.

إعادة الهيكلة مقابل أنشطة أخرى

إعادة الهيكلة ليست سوى تحسين للكود الموجود دون تغيير السلوك؛ ولذلك لا ينبغي أن تضطر الاختبارات إلى التغيير.

ولهذا فهي الخطوة الثالثة في دورة التطوير الموجه بالاختبار (TDD). فبعد أن تضيف سلوكًا واختبارًا يسنده، ينبغي أن تكون إعادة الهيكلة نشاطًا لا يتطلب أي تغيير في كود اختبارك. أنت تفعل شيئًا آخر إذا كنت “تعيد هيكلة” كود ما وتضطر إلى تغيير الاختبارات في الوقت نفسه.

مقدمة

Mon, 01 Jan 0001 00:00:00 +0000

بناء تطبيق

الآن، وبعد أن استوعبت — كما نأمل — قسم أساسيات Go، أصبحت لديك قاعدة صلبة في أغلب ميزات لغة Go وكيفية ممارسة التطوير الموجه بالاختبار.

سيتناول هذا القسم القادم بناء تطبيق.

كل فصل سيبني على الفصل السابق، موسّعًا وظائف التطبيق كما يملي علينا مالك المنتج (product owner).

سنقدّم مفاهيم جديدة تساعدك على كتابة كود رائع، لكن أغلب المادة الجديدة ستكون تعرّفًا بما يمكن إنجازه باستخدام المكتبة القياسية (standard library) في Go.

خادم HTTP

Mon, 01 Jan 0001 00:00:00 +0000

خادم HTTP

يمكنك العثور على كل كود هذا الفصل هنا

طُلب منك إنشاء خادم ويب يستطيع المستخدمون من خلاله تتبع عدد المباريات التي فاز بها اللاعبون.

GET /players/{name} ينبغي أن تُرجع رقمًا يدل على إجمالي عدد مرات الفوز
POST /players/{name} ينبغي أن تسجّل فوزًا لذلك الاسم، ويزيد العدد مع كل POST تالٍ

سنتبع نهج التطوير الموجه بالاختبار، فنصل إلى برنامج يعمل بأسرع ما نستطيع، ثم نجري تحسينات صغيرة متكررة حتى نصل إلى الحل. وباتباعنا هذا النهج:

JSON والتوجيه والدمج

Mon, 01 Jan 0001 00:00:00 +0000

JSON والتوجيه والدمج

يمكنك العثور على كل كود هذا الفصل هنا

في الفصل السابق أنشأنا خادم ويب لتخزين عدد المباريات التي فاز بها اللاعبون.

ولمالك المنتج (product owner) متطلب جديد: نقطة نهاية (endpoint) جديدة اسمها /league تُرجع قائمة بكل اللاعبين المخزَّنين. وتريد أن تُعاد هذه القائمة على هيئة JSON.

إليك الكود الذي وصلنا إليه حتى الآن

// server.go
package main

import (
	"fmt"
	"net/http"
	"strings"
)

type PlayerStore interface {
	GetPlayerScore(name string) int
	RecordWin(name string)
}

type PlayerServer struct {
	store PlayerStore
}

func (p *PlayerServer) ServeHTTP(w http.ResponseWriter, r *http.Request) {
	player := strings.TrimPrefix(r.URL.Path, "/players/")

	switch r.Method {
	case http.MethodPost:
		p.processWin(w, player)
	case http.MethodGet:
		p.showScore(w, player)
	}
}

func (p *PlayerServer) showScore(w http.ResponseWriter, player string) {
	score := p.store.GetPlayerScore(player)

	if score == 0 {
		w.WriteHeader(http.StatusNotFound)
	}

	fmt.Fprint(w, score)
}

func (p *PlayerServer) processWin(w http.ResponseWriter, player string) {
	p.store.RecordWin(player)
	w.WriteHeader(http.StatusAccepted)
}

// in_memory_player_store.go
package main

func NewInMemoryPlayerStore() *InMemoryPlayerStore {
	return &InMemoryPlayerStore{map[string]int{}}
}

type InMemoryPlayerStore struct {
	store map[string]int
}

func (i *InMemoryPlayerStore) RecordWin(name string) {
	i.store[name]++
}

func (i *InMemoryPlayerStore) GetPlayerScore(name string) int {
	return i.store[name]
}

// main.go
package main

import (
	"log"
	"net/http"
)

func main() {
	server := &PlayerServer{NewInMemoryPlayerStore()}
	log.Fatal(http.ListenAndServe(":5000", server))
}

يمكنك العثور على الاختبارات المقابلة في الرابط أعلى الفصل.

الـ IO والترتيب

Mon, 01 Jan 0001 00:00:00 +0000

الإدخال والإخراج والترتيب

يمكنك العثور على كل كود هذا الفصل هنا

في الفصل السابق واصلنا تطوير تطبيقنا بإضافة نقطة نهاية (endpoint) جديدة هي /league. وفي الطريق تعلّمنا كيفية التعامل مع JSON، وتضمين الأنواع (embedding types)، والتوجيه (routing).

مالكة المنتج (product owner) منزعجة بعض الشيء لأن البرنامج يفقد النتائج عند إعادة تشغيل الخادم؛ والسبب أن تنفيذنا للمخزن (store) موجود في الذاكرة. وهي أيضًا غير راضية لأننا لم نستنتج أن نقطة النهاية /league ينبغي أن تُرجع اللاعبين مرتبين حسب عدد الانتصارات!

سطر الأوامر وهيكل المشروع

Mon, 01 Jan 0001 00:00:00 +0000

سطر الأوامر وهيكل المشروع

يمكنك العثور على كل كود هذا الفصل هنا

يريد مالك المنتج (product owner) الآن أن يتحوّل (pivot) بتقديم تطبيق ثانٍ - تطبيق سطر أوامر.

وفي الوقت الحالي، سيكفي أن يكون قادرًا على تسجيل فوز لاعب عندما يكتب المستخدم Ruth wins. والقصد أن يصبح في النهاية أداة تساعد المستخدمين على لعب البوكر.

ويريد مالك المنتج أن تكون قاعدة البيانات مشتركة بين التطبيقين، حتى يتحدّث الدوري وفق الانتصارات المسجّلة في التطبيق الجديد.

الوقت

Mon, 01 Jan 0001 00:00:00 +0000

الوقت

يمكنك العثور على كل كود هذا الفصل هنا

يريد منّا مالك المنتج (product owner) أن نوسّع وظائف تطبيق سطر الأوامر الخاص بنا بمساعدة مجموعة من الأشخاص على لعب البوكر تكساس هولدم (Texas-Holdem Poker).

معلومات بالقدر الكافي عن البوكر

لن تحتاج إلى معرفة الكثير عن البوكر، يكفي أن تعرف أنه في فترات زمنية معينة يجب إبلاغ جميع اللاعبين بقيمة “الرهان الإجباري” (blind) المتزايدة باطراد.

سيساعدنا تطبيقنا على تتبّع موعد ارتفاع قيمة الرهان الإجباري، ومقدارها الجديد.

إعادة زيارة الوقت مع testing/synctest

Mon, 01 Jan 0001 00:00:00 +0000

إعادة زيارة الوقت مع testing/synctest

يمكنك العثور على كل كود هذا الفصل هنا

في فصل الوقت منحنا تطبيق البوكر الطرفي (poker CLI) القدرة على جدولة تنبيهات “الرهان الأعمى يرتفع الآن” باستخدام time.AfterFunc. كان اختبار هذا صعبًا: فـ time.AfterFunc يشغّل دالة الاستدعاء (callback) في goroutine خاصة به بعد مرور مدة حقيقية، ولا يمكنك مقارنة الدوال في Go، لذا لم نستطع بسهولة فحص ما تمت جدولته.

حللنا ذلك بأداة مألوفة: حقن الاعتماديات (dependency injection). عرّفنا واجهة (interface) اسمها BlindAlerter، وفي اختباراتنا استبدلنا التنفيذ الحقيقي بـ spy يسجّل فقط ما طُلب منه جدولته، هكذا تقريبًا:

الـ WebSockets

Mon, 01 Jan 0001 00:00:00 +0000

الـ WebSockets

يمكنك العثور على كل كود هذا الفصل هنا

في هذا الفصل سنتعلّم كيف نستخدم WebSockets لتحسين تطبيقنا.

مراجعة سريعة للمشروع

لدينا تطبيقان في قاعدة كود البوكر

تطبيق سطر الأوامر. يطلب من المستخدم إدخال عدد اللاعبين في اللعبة. ومنذ تلك اللحظة يبلّغ اللاعبين بقيمة “الرهان الإجباري” (blind bet) التي تزداد بمرور الوقت. ويمكن للمستخدم في أي لحظة إدخال "{Playername} wins" لإنهاء اللعبة وتسجيل الفائز في مخزن (store).
تطبيق الويب. يتيح للمستخدمين تسجيل الفائزين في الألعاب ويعرض جدول الترتيب. ويتشارك المخزن نفسه مع تطبيق سطر الأوامر.

الخطوات التالية

مالكة المنتج (product owner) سعيدة جدًا بتطبيق سطر الأوامر، لكنها تفضّل لو استطعنا نقل تلك الوظائف إلى المتصفح. فهي تتخيّل صفحة ويب بها مربع نص يتيح للمستخدم إدخال عدد اللاعبين، وعندما يرسل النموذج (form) تعرض الصفحة قيمة الرهان الإجباري وتحدّثها تلقائيًا عند الحاجة. وكما في تطبيق سطر الأوامر، يمكن للمستخدم إعلان الفائز فيُحفظ في قاعدة البيانات.

تنفيذ أوامر النظام (OS Exec)

Mon, 01 Jan 0001 00:00:00 +0000

تنفيذ أوامر النظام (OS Exec)

يمكنك العثور على كل الكود هنا

يسأل keith6014 على reddit

أُنفّذ أمرًا باستخدام os/exec.Command() يُنتج بيانات XML. وسيُنفَّذ هذا الأمر داخل دالة اسمها GetData().

ولكي أختبر GetData()، لديّ بعض بيانات الاختبار (testdata) التي أنشأتها.

في ملف _test.go لديّ TestGetData يستدعي GetData()، لكنه سيستخدم os.exec، وأريد بدلًا من ذلك أن يستخدم بيانات اختباري.

فما الطريقة الجيدة لتحقيق ذلك؟ هل ينبغي عند استدعاء GetData أن يكون لديّ وضع “test” بعلامة ما ليقرأ ملفًا، مثل GetData(mode string)؟

أنواع الأخطاء

Mon, 01 Jan 0001 00:00:00 +0000

أنواع الأخطاء

يمكنك العثور على كل كود هذا الفصل هنا

إنشاء أنواع خاصة بك للأخطاء يمكن أن يكون طريقة أنيقة لترتيب كودك، وتجعل كودك أسهل استخدامًا واختبارًا.

يسأل Pedro على Gopher Slack

إذا كنت أنشئ خطأ مثل fmt.Errorf("%s must be foo, got %s", bar, baz)، فهل هناك طريقة لاختبار التساوي دون مقارنة قيمة النص؟

لنصنع دالة تساعدنا على استكشاف هذه الفكرة.

// DumbGetter will get the string body of url if it gets a 200
func DumbGetter(url string) (string, error) {
	res, err := http.Get(url)

	if err != nil {
		return "", fmt.Errorf("problem fetching from %s, %v", url, err)
	}

	if res.StatusCode != http.StatusOK {
		return "", fmt.Errorf("did not get 200 from %s, got %d", url, res.StatusCode)
	}

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body) // ignoring err for brevity

	return string(body), nil
}

ليس نادرًا أن تكتب دالة قد تفشل لأسباب مختلفة، ونريد أن نتأكد أننا نتعامل مع كل سيناريو بشكل صحيح.

قارئ يراعي الـ Context

Mon, 01 Jan 0001 00:00:00 +0000

قارئ يراعي الـ Context

يمكنك العثور على كل كود هذا الفصل هنا

يوضح هذا الفصل كيف نطوّر بالاختبار أولًا io.Reader يراعي الـ context، كما كتبه Mat Ryer وDavid Hernandez في مدونة The Pace Dev.

قارئ يراعي الـ context؟

أولًا، مقدمة سريعة عن io.Reader.

إذا كنت قد قرأت فصولًا أخرى في هذا الكتاب فستكون قد صادفت io.Reader عند فتح الملفات وترميز JSON ومهام شائعة أخرى متنوعة. إنه تجريد بسيط لقراءة البيانات من شيء ما

إعادة زيارة معالجات HTTP

Mon, 01 Jan 0001 00:00:00 +0000

إعادة زيارة معالجات HTTP

يمكنك العثور على كل كود هذا الفصل هنا

يحتوي هذا الكتاب بالفعل على فصل عن اختبار معالج HTTP، لكن هذا الفصل سيقدّم نقاشًا أوسع حول تصميم المعالجات، ليكون اختبارها بسيطًا.

سنلقي نظرة على مثال واقعي، وكيف يمكننا تحسين طريقة تصميمه بتطبيق مبادئ مثل مبدأ المسؤولية الواحدة (single responsibility principle) وفصل الاهتمامات (separation of concerns). ويمكن تحقيق هذه المبادئ باستخدام الواجهات (interfaces) وحقن الاعتماديات (dependency injection). وبهذا سنوضح أن اختبار المعالجات أمر بسيط للغاية في الحقيقة.

لماذا اختبارات الوحدة وكيف تجعلها تعمل لصالحك

Mon, 01 Jan 0001 00:00:00 +0000

لماذا اختبارات الوحدة وكيف تجعلها تعمل لصالحك

إليك رابطًا لفيديو أتحدث فيه عن هذا الموضوع

وإذا لم تكن من محبي الفيديو، فإليك نسخة مكتوبة ومطوّلة عن الموضوع.

البرمجيات

وعد البرمجيات هو أنها قابلة للتغيير. ولهذا تُسمى soft ware؛ فهي طيّعة مقارنة بالعتاد (hardware). وينبغي أن يكون فريق الهندسة العظيم أصلًا مذهلًا للشركة، إذ يكتب أنظمة تستطيع أن تتطور مع الأعمال لتواصل تقديم القيمة.

فلماذا نحن بهذا السوء في ذلك؟ كم مشروعًا تسمع عنه يفشل فشلًا تامًا؟ أو يصبح “قديمًا” (legacy) ولا بد من إعادة كتابته بالكامل (وكثيرًا ما تفشل إعادة الكتابة أيضًا!)

الأنماط المضادة (Anti-patterns)

Mon, 01 Jan 0001 00:00:00 +0000

الأنماط المضادة (Anti-patterns)

من وقت لآخر، تحتاج إلى مراجعة تقنياتك في التطوير الموجه بالاختبار (TDD) وتذكير نفسك بالسلوكيات التي ينبغي تجنبها.

عملية TDD بسيطة من حيث المفهوم، لكنك ستجدها وأنت تمارسها تتحدى مهاراتك في التصميم. لا تظن أن هذا يعني أن TDD صعب، فالصعب هو التصميم!

يسرد هذا الفصل عددًا من الأنماط المضادة في TDD والاختبار، وكيفية علاجها.

عدم ممارسة TDD إطلاقًا

بالطبع، من الممكن كتابة برمجيات رائعة دون TDD، لكن كثيرًا من المشكلات التي رأيتها في تصميم الكود وجودة الاختبارات كان سيكون من الصعب جدًا الوصول إليها لو اتُّبع نهج منضبط في TDD.

المساهمة

Mon, 01 Jan 0001 00:00:00 +0000

المساهمة

المساهمات مرحّب بها جدًا. وآمل أن يصبح هذا بيتًا رائعًا لأدلة تعلّم Go عبر كتابة الاختبارات. فكّر في إرسال PR أو إنشاء issue، ويمكنك فعل ذلك من هنا.

ما نبحث عنه

تعليم ميزات Go (مثل أشياء كهذه: if وselect والـ structs والـ methods وغيرها).
عرض وظائف مثيرة للاهتمام داخل المكتبة القياسية. وإظهار كم هو سهل اتباع TDD لخادم HTTP مثلًا.
إظهار كيف يمكن لأدوات Go، مثل قياس الأداء وكاشفات التسابق (race detectors) وغيرها، أن تساعدك في الوصول إلى برمجيات رائعة.

وإذا لم تكن واثقًا من قدرتك على تقديم دليلك الخاص، فإن إنشاء issue لشيء تريد تعلّمه يظل مساهمة قيّمة.

قالب الفصل

Mon, 01 Jan 0001 00:00:00 +0000

قالب الفصل

مقدمة موجزة

تعلّم Go بالاختبارات

تثبيت Go وتجهيز بيئة عمل منتجة

تثبيت Go وتجهيز بيئة عمل منتجة

بيئة Go

وحدات Go (Modules)

مرحبًا بالعالم

مرحبًا بالعالم

كيف يعمل هذا؟

الأعداد الصحيحة

الأعداد الصحيحة

اكتب الاختبار أولًا

التكرار

التكرار

اكتب الاختبار أولًا

جرّب تشغيل الاختبار

المصفوفات والشرائح

المصفوفات والشرائح

اكتب الاختبار أولًا

Structs والـ Methods والـ Interfaces

Structs والـ Methods والـ Interfaces

اكتب الاختبار أولًا

المؤشرات والأخطاء

المؤشرات والأخطاء

الـ Maps

الـ Maps

حقن الاعتماديات (Dependency Injection)

حقن الاعتماديات (Dependency Injection)

الـ Mocking

الـ Mocking

التزامن (Concurrency)

التزامن (Concurrency)

الـ Select

الـ Select

اكتب الاختبار أولًا

الـ Reflection

الـ Reflection

الـ Sync

الـ Sync

اكتب الاختبار أولًا

جرّب تشغيل الاختبار

اكتب أصغر قدر من الكود ليعمل الاختبار وافحص مخرجاته الفاشلة

الـ Context

الـ Context

مقدمة إلى الاختبارات القائمة على الخصائص (Property Based Tests)

الأرقام الرومانية

الرياضيات

الرياضيات

المشكلة

قراءة الملفات

قراءة الملفات

القوالب (Templating)

القوالب (Templating)

الـ Generics

الـ Generics

دوال المساعدة في اختباراتنا (AssertEqual, AssertNotEqual)

التحقق من الأعداد الصحيحة

إعادة زيارة المصفوفات والشرائح مع الـ Generics

إعادة زيارة المصفوفات والشرائح مع الـ Generics

مقدمة إلى اختبارات القبول

مقدمة إلى اختبارات القبول

توسيع نطاق اختبارات القبول

توسيع نطاق اختبارات القبول

العمل بدون الـ Mocks والـ Stubs والـ Spies

العمل بدون الـ Mocks والـ Stubs والـ Spies

باختصار

قائمة تحقق إعادة الهيكلة

خطوة إعادة الهيكلة، قائمة تحقق البداية

إعادة الهيكلة مقابل أنشطة أخرى

مقدمة

بناء تطبيق

خادم HTTP

خادم HTTP

JSON والتوجيه والدمج

JSON والتوجيه والدمج

إليك الكود الذي وصلنا إليه حتى الآن

الـ IO والترتيب

الإدخال والإخراج والترتيب

سطر الأوامر وهيكل المشروع

سطر الأوامر وهيكل المشروع

الوقت

دوال المساعدة في اختباراتنا (`AssertEqual`, `AssertNotEqual`)