반응형

python 코드 리팩토링 규칙을 고양이에게 설명하는 픽셀 아트 by DALL·E 3

 

개요

  • 최근 python 코드를 리팩토링하는 일이 많은데, 그 이유는 분석을 잘하기 위해서다.
  • 기존 시스템 코드 대부분이 남이 만든 코드가 90% 이상인데, 읽기 좋은 코드는 아니다. 
  • 물론, 리팩토링을 하지 않아도 분석 할 수는 있다.
  • 하지만, 나는 리팩토링을 했다. 왜?
  • 기존 코드를 그대로 분석 vs 리팩토링 + 가독성 개선 후 분석 에 들어가는 리소스(시간)만 봤을때
    후자가 더 효율적이기 때문이다. (이 이야기는 여기서 길게 할 필요는 없으므로 생략한다..)
  • 여튼, 리팩토링을 계속 하면서 반복되는 패턴이 생겨, 이 글에서 규칙을 정리하려 한다.
  • 보편적인 python 코딩 컨벤션의 기본적인 내용도 일부 포함된다.

규칙

  1. import 문 정리
    • import 문을 알파벳 순서로 정렬한다.
    • IDE를 통해 없는 package 를 자동으로 import 하면, 알아서 적절한 곳에 배치할 수 있다.
    • isort 를 사용하는 방법도 있다.
    • import 문 순서가 안맞더라도 사실 코드 분석에 크게 영향이 있진 않지만, 안맞으면 거슬린다..
  2. 네이밍 스타일
    • https://peps.python.org/pep-0008/#naming-conventions
    • PEP8에 네이밍 스타일에 대한 설명을 읽어보면 도움이된다.
    • 변수, 함수이름은 snake_case
    • 함수는 PascalCase
    • Pylint 나 IDE의 intellisense 에서도 PEP 에 맞지 않는 스타일에 대해 경고 알림을 얻을 수 있다.
    • 레거시 코드에서 이런 기본적인 네이밍 스타일이 안지켜지면 너무 속상하다.
  3. 클래스
    • 클래스 없이 많은 함수가 나열된 py 파일을 보면 한숨나온다.
    • 기본적으로 모듈(.py 파일)과 클래스는 1:1 대응을 선호한다. ( 그렇게 안되는 경우도 당연히 있다.)
    • 클래스 멤버 함수 네이밍
      • python에서 공식적인 private 함수는 없지만, 관례상 _로 시작하곤 한다.
        • ex> def _my_private_method(self):
      • 멤버 변수, 함수의 정의 순서도 가독성에 많은 영향을 끼친다.
      • writer는 reader 에게 중요한 정보가 먼저 보이도록 고려하며 작성해야한다.
      • 멤버 정의 순서
        • 클래스 상수: _MY_CONSTANT
        • __init__ 함수
        • 오버라이딩 함수: @override
        • public 함수: my_public()
        • private 함수: _my_private()
        • 호출 계층 깊이가 얕은 함수
        • 호출 계층 깊이가 깊은 함수
  4. 데코레이터 표기하기
    • @override
    • @deprecated
    • @property
    • 기타 등등 알맞은 데코레이터 표기로 가독성을 개선하면 코드가 읽기 수월하다.
  5.  기타
    • IDE 가 알려주는 경고는 웬만하면 모두 해결하기.
      • for key in my_dict -> for key, value in my_dict.items()
    • early return
    • 함수 호출 계층 참고하기. (vscode F12)
      • 어디서 호출되고 사용되는지 참고하여, 리팩토링 후 영향도를 고려한다.
반응형
반응형

https://support.google.com/adsense/answer/7402253?hl=ko 

 

애드센스 계정 만들기 - Google 애드센스 고객센터

도움이 되었나요? 어떻게 하면 개선할 수 있을까요? 예아니요

support.google.com

  1. https://adsense.google.com/start/로 이동합니다.
  2. 시작하기를 클릭합니다.
  3. Google 계정에 로그인합니다.
  4. 광고를 게재할 사이트의 URL을 입력합니다. URL을 입력하는 방법을 자세히 알아보세요.나중에 사이트를 추가하려면 이 입력란을 비워두고 아직 사이트가 없습니다를 선택합니다.

 

과연 승인이 될까요?

--

검토 결과 내용 추가하도록 하겠습니다.

반응형
반응형

windows 탐색기의 파일 검색 기능으로 검색이 잘 안되곤 합니다.

그래서 listary 같은 툴을 사용하곤하는데, cmd로 찾는 방버도 있습니다.

성능이 우수하진 않지만, cli 로 찾을 수 있다는 장점이 있어요.

C:\>where /R c:\windows notepad.exe

 

반응형
반응형

In C90, main() must have an explicit return statement at the end to avoid undefined behaviour. In C99 and newer, you may omit the return statement from main(). If you do, and main() finished, there is an implicit return 0.

 

C90에선 main() 함수에서 무조건 반환 타입을 정의 해야했지만,

C99부터 묵시적으로 return 0 를 수행하기 때문에 생략가능해졌다.

 

참고 : https://stackoverflow.com/questions/204476/what-should-main-return-in-c-and-c

반응형

+ Recent posts