PEP-8 හි මෙම කොටස මම දැක ඇත්තෙමි https://www.python.org/dev/peps/pep-0008/#package-and-module-names
මෙය මොඩියුලයක / පන්තියේ / පැකේජයක ගොනු නාමයට යොමු වේද යන්න මට පැහැදිලි නැත.
මට එක් එක් උදාහරණය තිබේ නම්, සුදුසු නම්, යටි ඉරි සහිත ගොනු නාම සියල්ලම කුඩා අකුරු විය යුතුද? හෝ වෙන දෙයක්?
Answers:
උපුටා දැක්වීම https://www.python.org/dev/peps/pep-0008/#package-and-module-names :
මොඩියුලවල කෙටි, සියලු කුඩා අකුරු තිබිය යුතුය. කියවීමේ හැකියාව වැඩි දියුණු කරන්නේ නම්, මොඩියුලයේ නමට යටි ලකුණු භාවිතා කළ හැකිය. අවධාරනය කිරීම අධෛර්යමත් කළද, පයිතන් පැකේජවල කෙටි, සියලු කුඩා අකුරු තිබිය යුතුය.
සඳහා පන්ති :
පන්ති නම් සාමාන්‍යයෙන් කැප්වර්ඩ්ස් සම්මුතිය භාවිතා කළ යුතුය.
සහ ශ්‍රිතය සහ (දේශීය) විචල්ය නම් විය යුත්තේ:
සිම්පල්, කියවීමේ හැකියාව වැඩි දියුණු කිරීම සඳහා අවශ්‍ය වචන අවධාරනය කරයි
මොඩියුලයක්, පන්තියක් සහ පැකේජයක් අතර වෙනස සඳහා මෙම පිළිතුර බලන්න :
- පයිතන් මොඩියුලය යනු හුදෙක් පයිතන් ප්‍රභව ගොනුවක් වන අතර එමඟින් පන්ති, කාර්යයන් සහ ගෝලීය විචල්‍යයන් නිරාවරණය කළ හැකිය.
- පයිතන් පැකේජයක් යනු හුදෙක් පයිතන් මොඩියුලයේ (නාම) නාමාවලියකි.
එබැවින් PEP 8 ඔබට මෙසේ කියයි :
PEP 8 පවසන්නේ නම් කෙටි විය යුතු බවයි ; මෙම පිළිතුර විචල්ය නම් නිර්මාණය කිරීමේදී සැලකිල්ලට ගත යුතු දේ පිළිබඳ හොඳ දළ විශ්ලේෂණයක් ලබා දෙයි, එය වෙනත් නම් වලටද අදාළ වේ (පන්ති, පැකේජ ආදිය සඳහා):
- විචල්ය නම් සම්පූර්ණ විස්තර කරන්නන් නොවේ;
- අදහස් දැක්වීම්වල තබන්න;
- ඕනෑවට වඩා නිශ්චිත නමක් යනු විශේෂිත කේතයක් විය හැකිය;
- ඉක්මන් සොයා බැලීම සඳහා කෙටි විෂය පථ තබා ගන්න;
- කියවීමේ හැකියාව ගැන සිතමින් කාලය ගත කරන්න.
අවසන් කිරීම සඳහා, නම් කිරීමේ සම්මුතීන් පිළිබඳ හොඳ දළ විශ්ලේෂණයක් Google Python Style Guide හි දක්වා ඇත.
some> long> nameවෙනුවට somelongname?)
මෙන්න විවිධ වර්ගයේ පයිතන් නාම සම්මුතීන් සඳහා සබැඳියක්.
පයිතන් සඳහා වන මාර්ගෝපදේශය ගයිඩෝගේ නම් කිරීමේ සම්මුති නිර්දේශ මත පදනම් වේ.
FooBarඅතරFooBizදෙකම ගොනුව තුළට යා හැකියsomepkg/foobar.py(මේ අනුව :)from somepkg.foobar import FooBarනමුත් පන්තියටTimerErrorඇතුළට යා හැකියexcept/timer_error.py(මේ අනුවfrom except.timer_error import TimerError),CamelCaseසමහර විට ඉවත් කිරීමෙන් වචනය කියවීමට අපහසු වන බැවින්snake_caseගොනු නාමය සඳහා භාවිතා කළ හැකිය.