2013-01-21 3 views
4

필자가 작성한 Python 패키지 배포판을 개발 중이므로 PyPI에 게시 할 수 있습니다. 그것은의 distutils 작업 내 처음, setuptools에는 핍, setup.py를 배포하고 모든 것을 그리고 내가 예상했던 것보다 상당히 가파른의 학습 곡선 와 조금 사투를 벌인거야 :)파이썬 배포판의 사용 사례는 무엇입니까?

내가 가졌다 일부 테스트 데이터 파일을 setup.py의 data_files 매개 변수에 지정하여 tarball에 포함 된 이 될 때까지 여기에서 다른 게시물을 찾을 때까지 을 MANIFEST.in 파일로 가리킬 때까지 약간의 문제가 있습니다. 그때 난 당신이 이 타르볼/우편에 포함 무엇을 (MANIFEST.in 사용) 그들이 easy_install을 할이든 (에 따라 당신이 setup.py 무엇을 지정 ) 때 사용자의 파이썬 환경에 설치됩니다이라는 개념에 흡착 아주 다른 두 가지; 일반적으로 실제로 설치되는 것보다 더 많은 수의 타르볼이 더 많습니다.

이것은 즉시 나를 위해 코드 냄새를 일으켰으며 이 배포판의 하나 이상의 유스 케이스 여야한다는 것을 깨달았습니다. 나는 에 고정되어 있었고 easy_install 또는 pip를 사용하여 라이브러리를 설치했습니다. 그리고 제가 개발중인 최종 사용자에 대한 부분적인 이해가있는 작업 제품을 개발하고 있다는 것을 깨달았습니다. "? 내가이 배포 를 제공하고 다른 하나의 파이썬 환경에 설치 이외의 파이썬 배포본 에 대한 사용 사례는 무엇을 그들에 대해 가장 상관이야?"

그래서 제 질문은 이것이다 그것은에서 소스 제어 (자식)에서의 모든 것을 포함하는 분별있는 일이

  • 가 : 여기

    아직 대답에 그 곰 내가 파악하지 않은 작업 문제 중 일부입니다 소스 배포판? github 시대에 누군가가 소스 배포본을 다운로드하여 전체 프로젝트 소스에 액세스 할 수 있습니까? 아니면 내 github repo에 대한 링크를 게시해야합니까? 모든 것을 포함하여 배포판을 부 풀리지 않고 단지 을 설치하려는 사람들에게 다운로드하는 데 더 오래 걸리시겠습니까?

  • readthedocs.org에서 설명서를 호스팅 할 예정입니다. 소스에문서의 HTML 버전을 포함 시키려면 어떤 의미가 있습니까?

  • 누구나 python setup.py test을 사용하여 소스에서 테스트를 실행합니까? 그렇다면 어떤 역할을하고 있으며 어떤 상황에 처해 있습니까? 내가 내가 그 일을하는 데 귀찮게해야하는지 모르겠다면 내가 누구인지, 누가 만들어야합니까 그게 효과가 있습니다.당신은 소스 배포판에 포함 할하지만 어쩌면 설치하지 않을 수 있습니다

답변

3

어떤 것들은 다음과 같습니다

  • 패키지의 라이센스
  • 테스트 스위트
  • 문서 (아마도 처리 양식을
  • 소스 배포를 빌드하는 데 사용되는 추가 스크립트 가능

버전 제어에서 관리하는 내용의 대부분 또는 일부가 생성되는 파일 일 수 있습니다.

온라인 또는 버전 관리를 통해 해당 파일을 사용할 수있는 이유는 사용자가 자신이 실행중인 코드와 일치하는 문서 또는 테스트 버전을 가지고 있다는 것을 알기 위해서입니다.

최신 버전의 온라인 문서 만 호스팅하는 경우 어떤 이유로 이전 버전을 사용해야하는 사람에게는 유용하지 않을 수 있습니다. 버전 관리의 팁에있는 테스트 스위트는 소스 배포본의 코드 버전과 호환되지 않을 수 있습니다 (예 : 그 이후 추가 된 기능을 테스트하는 경우). 올바른 버전의 문서 또는 테스트를 얻으려면 버전 관리를 통해 소스 배포에 해당하는 태그를 찾아야합니다 (개발자가 트리에 태그를 지정하는 경우). 원본 배포판에서 파일을 사용할 수있게하면이 문제를 피할 수 있습니다.

테스트 스위트를 실행하고자하는 사람들은 파이썬 모듈을 다양한 Linux 배포판에 패키지화하고 때로는 자신의 환경에서 테스트 실패와 관련된 버그 보고서를받는 경우가 있습니다. 필자는 버그가 발생했을 때 다른 사람들의 모듈의 테스트 스위트를 사용했고 저자가 내 환경에서 기대하는대로 외부 코드가 작동하는지 확인하려고합니다.

+0

이 James에게 감사드립니다. – scanny

관련 문제