📑 Код-ревью для начинающих: советы и ориентиры из практики

Текст пригодится разработчикам и лидам, которые еще близко не знакомы с код-ревью или хотят упорядочить свои знания, узнать лайфхаки из практики.

Clean Code #статьи #CodeReview

Clean Code #test #oop

Выберите правильный вариант 👇🏼

🧑‍💻 В теле функции все должно быть на одном уровне абстракции

private void showArticelErrorIfNeed(Article article) {
   if (validateArticle(article)) {
       String errorMessage = "Article " + article.getName() + " is incorrect";
       showArticleError(errorMessage);
   } else  {
       hideArticleError();
   }
}

Вычисление значения локальной переменной errorMessage имеет более низкий уровень абстракции, чем остальной код внутри функции. Поэтому код java "Article " + article.getName() + " is incorrect" лучше вынести в отдельную функцию.

Clean Code #совет #cleancode #java

Keen

Разнообразные инструменты для сбора данных, анализа и визуализации. Бесплатно до 50 000 событий в месяц. Нет необходимости перестраивать конвейер данных, Keen уже построил его для вас. Воспользуйтесь преимуществами полностью управляемой мультитенантной архитектуры данных и не отвлекайтесь от создания приложений.

📑 Сайт

Clean Code #инструменты

Как общаются программы / Что такое API, REST, CRUD и CLI

Из этого выпуска рубрики "Знать как" вы узнаете о том, что такое API, REST, RESTFull, CRUD, CLI и как весь этот зверинец связан между собой. Все эти технологии помогают нам общаться с машинами, а машинам общаться друг с другом.

📺 YouTube

Clean Code #видео #api

🔥 Лучшее на канале за неделю

1. Код-ревью для начинающих: советы и ориентиры из практики.

2. Keen — разнообразные инструменты для сбора данных, анализа и визуализации.

3. Programming Kubernetes.

📑 Инженеры Apple и Adobe представили нейросеть для управления освещением на фотографиях

Разработчики из Apple, Adobe и Университетского колледжа Лондона представили нейросеть, помогающую в реальном времени управлять естественным освещением на фотографиях. Пока для примера доступны только несколько изображений.

Clean Code #новости #Apple #Adobe

🧑‍💻 Имена функций в Python

Имена функций должны состоять из маленьких букв, а слова разделяться символами подчеркивания — это необходимо, чтобы увеличить читабельность.

Стиль mixedCase допускается в тех местах, где уже преобладает такой стиль, для сохранения обратной совместимости.

Clean Code #совет #cleancode #python

MassCode

Менеджер фрагментов кода с открытым исходным кодом. Он предоставляет красивый и понятный интерфейс для управления всеми вашими фрагментами кода и шпаргалками. Работает на Windows, Mac и Linux.

📑 Сайт

Clean Code #инструменты

Clean Code #test #patterns

Выберите правильный вариант 👇🏼

Clean Code #test #oop

Выберите правильный вариант 👇🏼

🧑‍💻 Наименование функции и передаваемых параметров должно сообщать о том, что делает функция

▍Часть 1

Причиной выделения блока кода в отдельную функцию может являться желание в пояснении, что делает код. Для этого нужно дать подходящее название функции и параметрам функции.

public Product find(String a) { … }

Непонятно по какому полю будет происходить поиск, что передается на вход функции.

Лучше переделать в следующий вид:

@Nullable
public Product findProductById(@NonNull String id) { … }

Продолжение следует...

Clean Code #совет #cleancode #java

📖 The Data Science Design Manual
🖋 Steven S. Skiena, 2017

Этот увлекательный учебник представляет собой введение в быстро развивающуюся междисциплинарную область науки о данных. В нем основное внимание уделяется ключевым навыкам, необходимым для создания систем сбора, анализа и интерпретации данных. Этот легкий для чтения текст идеально подходит для студентов и аспирантов, приступающих к изучению курса «Введение в науку о данных». Практикующие в смежных областях сочтут эту книгу идеальной и для самостоятельного изучения.

💾 Скачать книгу

Clean Code #книги #DataScience

🧑‍💻 Наименование функции и передаваемых параметров должно сообщать о том, что делает функция

▍Часть 2

@Nullable
public Product findProductById(@NonNull String id) { … }

Название функции говорит, что происходит поиск Product по полю id. На вход функция принимает не “null” значение. Если Product не найдется, то вернется “null”.

Роберт К. Мартин советует использовать параметры в качестве части названия функции:

public void add(Product product) { … }

Вызов функции может выглядеть так:

add(product);

На проектах такой способ встречается редко. Лучше данный способ не использовать и писать полностью название:

public void addProduct(Product product){ … }

Clean Code #совет #cleancode #java

КАК ЧИТАТЬ ИСХОДНЫЕ КОДЫ

Способ, который помогает развиваться и улучшать ваши качества как разработчика заключается в чтении чужих исходных кодов.

📺 YouTube

Clean Code #видео

🔥 Лучшее на канале за неделю

1. The Data Science Design Manual.

2. MassCode — менеджер фрагментов кода с открытым исходным кодом.

3. Имена функций в Python.

Matplotlib

Библиотека двумерных числовых построений. Она отлично подходит для анализа данных и создания высококачественных фигур различного формата, включая интерактивные графики и схемы.

📑 Сайт

Clean Code #инструменты