성태의 닷넷 이야기
홈 주인
모아 놓은 자료
프로그래밍
질문/답변
사용자 관리
사용자
메뉴
아티클
외부 아티클
유용한 코드
온라인 기능
MathJax 입력기
최근 덧글
[정성태] Get Started with Milvus Vector DB i...
[정성태] cyberark/PipeViewer - A tool that...
[정성태] WinForms in a 64-Bit world – our st...
[정성태] 예제에서 SELECT_SQL도 내부적으로는 SqlCommand/...
[victor] SELECT_LINQ SELECT_SQL 같은 쿼리인...
[victor] 답변 갑사합니다. 예외(Exception)가 났습니다. ...
[정성태] 일단, 위의 방식대로 하면 예외(Exception) 없이 잘 동...
[정성태] Windows 10 (버전 1809)에 이런 기능이 ^^ 추가되...
[정성태] pde windbg extension ; https://lea...
[정성태] // GetEnumerator extensions for Ran...
글쓰기
제목
이름
암호
전자우편
HTML
홈페이지
유형
제니퍼 .NET
닷넷
COM 개체 관련
스크립트
VC++
VS.NET IDE
Windows
Team Foundation Server
디버깅 기술
오류 유형
개발 환경 구성
웹
기타
Linux
Java
DDK
Math
Phone
Graphics
사물인터넷
부모글 보이기/감추기
내용
<div style='display: inline'> <h1 style='font-family: Malgun Gothic, Consolas; font-size: 20pt; color: #006699; text-align: center; font-weight: bold'>파이썬 - PyPI 패키지 만들기 (2) long_description, cmdclass 옵션</h1> <p> 지난 글에 이어,<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > 파이썬 - PyPI 패키지 만들기 ; <a target='tab' href='https://www.sysnet.pe.kr/2/0/12863'>https://www.sysnet.pe.kr/2/0/12863</a> </pre> <br /> 약간의 옵션을 좀 더 정리해보겠습니다.<br /> <br /> 우선, 이전의 setup.py로는,<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > from setuptools import setup, find_packages import netutil setup( name="net-util", description="utility functions for networking", version=netutil.__version__, author=netutil.__author__, author_email="techsharer@outlook.com", url="https://www.sysnet.pe.kr", license="Ms-PL", packages=find_packages(exclude=[]), install_requires=["requests>=2.22.0"]," ) </pre> <br /> PyPI에 올렸을 때 소개가 이렇게 비어 있습니다.<br /> <br /> <img onclick='toggle_img(this)' class='imgView' alt='pypi_adv_1.png' src='/SysWebRes/bbs/pypi_adv_1.png' /><br /> <br /> 이 부분을 채우려면, long_description 속성을 채우면 되는데요, 재미있게도 어차피 setup.py가 파이썬 스크립트 파일이기 때문에 함수를 이용해 처리하는 것도 가능합니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > ...[생략]... <span style='color: blue; font-weight: bold'>def readme(): with open('README.md', 'rb') as f: return f.read().decode('utf-8') </span> setup( name="net-util", description="utility functions for networking", <span style='color: blue; font-weight: bold'>long_description=readme()</span>, <span style='color: blue; font-weight: bold'>long_description_content_type='text/markdown',</span> ...[생략]... install_requires=["requests>=2.22.0"], ) </pre> <br /> 또한, 해당 텍스트는 text/plain, text/x-rst, text/markdown 형식을 지원하므로 원하는 것을 선택해 파일로 만들어 두면 됩니다. 그래서 대충 이렇게 README.md를 만들어 두면,<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > # net-util 패키지 테스트를 위해 만든 예제 프로젝트입니다. ```python >>> import netutil >>> print(netutil.iputil.get_public_ip()) 220.127.177.110 ``` ## Installing net-util and Supported Versions net-util is available on PyPI: ```console $ python -m pip install netutil ``` </pre> <br /> <a target='tab' href='https://pypi.org/project/net-util/'>https://pypi.org/project/net-util/</a>에서 그 결과를 확인할 수 있습니다. ^^<br /> <br /> <hr style='width: 50%' /><br /> <br /> setup.py에서 좀 특별한 옵션이라면 바로 기존 패키징 코드를 사용자 정의할 수 있는 cmdclass 옵션입니다. 이 옵션을 활용하면 "python setup.py [cmd]"에 해당하는 명령어의 "[cmd]" 작업을 사용자 정의할 수 있습니다. 가령 [cmd]로 bdist_wheel을 사용하는 경우라면, 다음과 같이 bdist_wheel 작업을 확장할 수 있습니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > import netutil <span style='color: blue; font-weight: bold'>from wheel.bdist_wheel import bdist_wheel as _bdist_wheel</span> from setuptools import setup, find_packages class UserCode(<span style='color: blue; font-weight: bold'>_bdist_wheel</span>): def run(self): print('pre-process ===============================================') <span style='color: blue; font-weight: bold'>_bdist_wheel.run(self)</span> print('post-process ==============================================') setup( name="net-util", description="utility functions for networking", long_description=readme(), long_description_content_type='text/markdown', cmdclass={<span style='color: blue; font-weight: bold'>'bdist_wheel'</span>: UserCode}, ...[생략]... ) </pre> <br /> 그럼 실행 시 다음과 같은 결과를 확인할 수 있습니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > C:\temp> <span style='color: blue; font-weight: bold'>python setup.py bdist_wheel</span> running bdist_wheel pre-process =============================================== running build running build_py installing to build\bdist.win-amd64\wheel running install running install_lib creating build\bdist.win-amd64\wheel creating build\bdist.win-amd64\wheel\netutil ...[생략]... adding 'netutil/network_logger.py' adding 'net_util-1.0.0.2.dist-info/METADATA' adding 'net_util-1.0.0.2.dist-info/WHEEL' adding 'net_util-1.0.0.2.dist-info/top_level.txt' adding 'net_util-1.0.0.2.dist-info/RECORD' removing build\bdist.win-amd64\wheel post-process ============================================== </pre> <br /> 위의 경우 단순히 pre/post 처리를 했지만 <a target='tab' href='https://coderedirect.com/questions/125361/how-to-force-a-python-wheel-to-be-platform-specific-when-building-it'>고급스럽게는 해당 [cmd] 작업의 내부 단계들을 가로채서 사용자 정의</a>하는 것도 가능합니다.<br /> <br /> 사실 저런 식의 pre/post 작업이라면 그냥 단순하게 setup(...) 호출의 앞/뒤로 코드를 수행해도 유사한 결과를 얻습니다. (혹은, 아예 빌드 스크립트 차원에서 "python setup.py ..." 호출 전/후에 처리해도 되고.)<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > print('pre-process ===============================================') setup( name="net-util", description="utility functions for networking", long_description=readme(), long_description_content_type='text/markdown', # cmdclass={'bdist_wheel': UserCode}, ...[생략]... ) print('post-process ==============================================') </pre> <br /> 참고로, cmdclass는 결국 "[cmd]"에 따라 달라지기 때문에 배포 패키징 명령어가 바뀐다면 그에 맞게 조정해야 합니다. 예를 들어 "python setup.py sdist"로 하는 경우라면 아래와 같이 코드가 바뀌게 됩니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > <span style='color: blue; font-weight: bold'>from distutils.command.sdist import sdist as _sdist</span> class UserCode(<span style='color: blue; font-weight: bold'>_sdist</span>): def run(self): <span style='color: blue; font-weight: bold'>_sdist</span>.run(self) setup( name="net-util", description="utility functions for networking", long_description=readme(), long_description_content_type='text/markdown', <span style='color: blue; font-weight: bold'>cmdclass={'sdist': UserCode},</span> ...[생략]... ) </pre> </p><br /> <br /><hr /><span style='color: Maroon'>[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]</span> </div>
첨부파일
스팸 방지용 인증 번호
1017
(왼쪽의 숫자를 입력해야 합니다.)