|
Question |
Answer |
W tym podręczniku będziemy mówić o pisaniu „czystego” kodu. start learning
|
|
In this handbook we're going to talk about writing "clean" code.
|
|
|
Jest to temat, który trochę mnie dezorientował, gdy zaczynałem pracę jako programista i odkryłem, że ma on wiele niuansów i możliwych interpretacji. start learning
|
|
It's a topic that used to confuse me a bit when I was starting out as a programmer, and I find that it has many nuances and possible interpretations.
|
|
|
Zatem w tym artykule porozmawiamy o tym, co oznacza termin „czysty kod”, dlaczego jest on ważny i jak możemy ocenić, czy baza kodu jest czysta, czy nie. start learning
|
|
So in this article we'll talk about what the term "clean code" means, why it's important, how can we assess whether a codebase is clean or not.
|
|
|
Poznasz także najlepsze praktyki i konwencje, których możesz przestrzegać, aby Twój kod był czystszy. start learning
|
|
You'll also learn some best practices and conventions you can follow to make your code cleaner.
|
|
|
Czysty kod to termin używany do opisania kodu komputerowego, który jest łatwy do odczytania, zrozumienia i konserwacji. start learning
|
|
Clean code is a term used to describe computer code that is easy to read, understand, and maintain.
|
|
|
Czysty kod jest napisany w sposób prosty, zwięzły i wyrazisty. start learning
|
|
Clean code is written in a way that makes it simple, concise, and expressive.
|
|
|
Jest zgodny z zestawem konwencji, standardów i praktyk, które ułatwiają czytanie i przestrzeganie. start learning
|
|
It follows a set of conventions, standards, and practices that make it easy to read and follow.
|
|
|
Czysty kod jest wolny od złożoności, nadmiarowości i innych zapachów kodu oraz antywzorców, które mogą utrudniać konserwację, debugowanie i modyfikowanie. start learning
|
|
Clean code is free from complexity, redundancy, and other code smells and anti-patterns that can make it difficult to maintain, debug, and modify.
|
|
|
Nie mogę przecenić znaczenia czystego kodu. start learning
|
|
I can't overstate the importance of clean code.
|
|
|
Nie mogę przecenić znaczenia czystego kodu. start learning
|
|
I can't overstate the importance of clean code.
|
|
|
Gdy kod jest łatwy do odczytania i zrozumienia, ułatwia programistom pracę nad bazą kodu. start learning
|
|
When code is easy to read and understand, it makes it easier for developers to work on the codebase.
|
|
|
Może to prowadzić do zwiększenia produktywności i zmniejszenia liczby błędów. start learning
|
|
This can lead to increased productivity and reduced errors.
|
|
|
|
start learning
|
|
|
|
|
Półkula północna to połowa Ziemi położona na północ od równika. start learning
|
|
The Northern Hemisphere is the half of Earth that is north of the Equator.
|
|
|
|
start learning
|
|
|
|
|
|
start learning
|
|
|
|
|
nadal mnie przewyższał we wszystkich meczach start learning
|
|
he continued to surpass me at all games
|
|
|
|
start learning
|
|
|
|
|
obawa - oznacza martwienie się o coś start learning
|
|
concern - means worried about something
|
|
|
wspomnieć - odnieść się do (czegoś) krótko i bez wchodzenia w szczegóły. start learning
|
|
mention - refer to (something) briefly and without going into detail.
|
|
|
Nie wspomniałam jeszcze o tym Williamowi start learning
|
|
I haven't mentioned it to William yet
|
|
|
Ekstremalne zjawiska pogodowe nie pokazały, że rządy odpowiednio poradziły sobie z wyzwaniami. start learning
|
|
Extreme weather events didn't show that governments have dealt adequately with the challenges.
|
|
|
|
start learning
|
|
|
|
|
spakuj swoje marzenia - gotowy i chętny do realizacji swoich aspiracji. start learning
|
|
pack your dreams - ready and willing to pursue your aspirations.
|
|
|
serce kompasu - ktoś, kto ma silną chęć podróżowania start learning
|
|
compass heart - someone who has a strong desire to travel
|
|
|
bilet do odkrycia - możliwość uczenia się i odkrywania nowych rzeczy start learning
|
|
ticket to discovery - opportunity to learn and explore new things
|
|
|
zaplanuj wspomnienia - aby stworzyć niezapomniane wrażenia start learning
|
|
map out memories - to create memorable experiences
|
|
|
skrzydła wolności - poczucie wyzwolenia i przygody start learning
|
|
wings of freedom - feeling of liberation and adventure
|
|
|
paszport do przygody - możliwość wyruszenia w ekscytujące podróże start learning
|
|
passport to adventure - opportunity to embark on exciting travels
|
|
|
|
start learning
|
|
|
|
|
|
start learning
|
|
we will send you an itinerary
|
|
|
|
start learning
|
|
|
|
|
|
start learning
|
|
|
|
|
|
start learning
|
|
|
|
|
rozproszone przesyłanie strumieniowe start learning
|
|
|
|
|
|
start learning
|
|
|
|
|
|
start learning
|
|
|
|
|
|
start learning
|
|
|
|
|
Jestem pewien, że większość czytelników spotkała się z sytuacją, w której odwiedzasz swój kod zaledwie kilka miesięcy później i trudno ci zrozumieć, co zrobiłeś wcześniej. start learning
|
|
And I am sure most readers have faced the situation where you visit your code only a few months later and have a hard time understanding what you did before.
|
|
|
Jak tworzyć znaczące nazwy start learning
|
|
How to Create Meaningful Names
|
|
|
Nie używaj komentarzy do wyjaśnienia, dlaczego użyto zmiennej. Jeśli nazwa wymaga komentarza, zamiast pisać komentarz, poświęć trochę czasu na zmianę nazwy tej zmiennej. start learning
|
|
Do not use comments to explain why a variable is used. If a name requires a comment, then you should take your time to rename that variable instead of writing a comment.
|
|
|
Jeśli nazwa wymaga komentarza, to nie zdradza swojego zamysłu. start learning
|
|
If a name requires a comment, then the name does not reveal its intent.
|
|
|
|
start learning
|
|
|
|
|
|
start learning
|
|
|
|
|
Są zbędne i należy je usunąć. start learning
|
|
They are redundant and should be removed.
|
|
|
|
start learning
|
|
|
|
|
Jeśli nie potrafisz wymówić jakiegoś imienia, nie możesz o nim rozmawiać tak, żeby nie zabrzmiało głupio. start learning
|
|
If you can't pronounce a name, you can't discuss it without sounding silly.
|
|
|
Upewnij się, że robią tylko jedną rzecz start learning
|
|
Make Sure They Just Do One Thing
|
|
|
Tylko oni powinni to zrobić. start learning
|
|
|
|
|
Dobrym sposobem sprawdzenia jest próba wyodrębnienia innej funkcji o innej nazwie. start learning
|
|
One good way to check is to try to extract another function with a different name.
|
|
|
i przyzwyczajenie się do tego zajmie trochę czasu. start learning
|
|
and it will take some time to get used to.
|
|
|
Ale gdy już to opanujesz, Twój kod będzie wyglądał na znacznie dojrzalszy i na pewno będzie łatwiej go refaktoryzować, zrozumieć i przetestować. start learning
|
|
But once you get the hang of it, your code will look much more mature, and it will be more easily refactorable, understandable, and testable for sure.
|
|
|
Hermetyzuj warunki warunkowe w funkcjach start learning
|
|
Encapsulate Conditionals in Functions
|
|
|
Oto fragment kodu z mojego projektu szkolnego. start learning
|
|
Here is a piece of code from a school project of mine.
|
|
|
Obrzydliwe, prawda? Zgadzam się. start learning
|
|
|
|
|
Funkcje powinny mieć dwa lub mniej argumentów, im mniej, tym lepiej. start learning
|
|
Functions should have two or fewer arguments, the fewer the better.
|
|
|
Argumenty flagowe w naturalny sposób zaprzeczają zasadzie pojedynczej odpowiedzialności. start learning
|
|
Flag arguments naturally contradict the principle of single responsibility.
|
|
|
Skutki uboczne to niezamierzone konsekwencje Twojego kodu. start learning
|
|
Side effects are unintended consequences of your code.
|
|
|
Mogą powodować nieprzyjemne błędy. start learning
|
|
They can result in some nasty bugs.
|
|
|
Powtarzanie kodu może być źródłem wszelkiego zła w oprogramowaniu. start learning
|
|
Code repetition may be the root of all evil in software.
|
|
|
Zduplikowany kod oznacza, że w przypadku zmiany logiki musisz zmienić elementy w wielu miejscach i jest to bardzo podatne na błędy. start learning
|
|
Duplicate code means you need to change things in multiple places when there is a change in logic and it is very error prone.
|
|
|
Wtedy, gdy zmienią się nazwy zmiennych lub nazw metod, staje się to nieistotne, ale nadal nikt ich nie usuwa. start learning
|
|
Then when variable names or method names change, it gets irrelevant but still nobody deletes it.
|
|
|
Czyste kodowanie nie jest umiejętnością, którą można nabyć z dnia na dzień. start learning
|
|
Clean coding is not a skill that can be acquired overnight.
|
|
|
