කෝඩ් එක දෝෂ රහිතව ධාවනය වුනාම, සැබෑ වැඩ ඇරඹුනා. පළමු කොටසෙහි පලග්ඡින් නිර්මාණය කර, ලොකල් පරීක්ෂණයක් තුළ සාර්ථකව ක්රියාත්මක කිරීම ගැන කතා කළා. දැන් ඒ පලග්ඡින් Anthropic මාර්කට්පලේස් වෙත පළ කිරීමේ ගැටළු ගැන අවධානය යොමු කරමු.
ලොකල් පරිසරය සහ මාර්කට්පලේස් පරිසරය අතර ඇති වෙනස්කම් නිසා බොහෝ අය අඩු අඩු වැරදි වලට මුහුණ දෙයි. ලොකල් පරිසරය ඔබට එකම සැසිය නැවත පූරණය කර, ප්රොම්ප්ට් වෙනස් කර, කේතය නැවත ධාවනය කිරීමට ඉඩ දෙයි. එහෙත් මාර්කට්පලේස් එක පිරිසිදු කන්ටේනරයක පලග්ඡින් ක්රියාත්මක කර, manifest එක සත්යාපනය කර, PyPI වෙතින් සියලු dependency ගත කරයි.
manifest එකේ කඩිනම් සැකසීම – ලොකල් පරිසරයේ අනිවාර්ය නොවූ වගුවක් මාර්කට්පලේස්ෙහි අනිවාර්ය වේ. required_python_version සහ runtime_dependencies වැනි ක්ෂේත්රයන් නිවැරදිව ඇතුළත් නොකළහොත්, කේතය පරිගණකයේ සාර්ථකව ධාවනය වුවත්, එකම විමර්ශනයේදී පූර්ණයෙන්ම ප්රතික්ෂේප කරයි. එබැවින් manifest එකට එකම සත්ය සම්පූර්ණය ලෙස කටයුතු කර, නව dependency එකක් එක් කළ විටම ඒක යාවත්කාලීන කර, Anthropic භාවිතා කරන validation script එක දේශීයව ධාවනය කර බලන්න.
entry point නාමකරණය – මාර්කට්පලේස්ෙහි main නම් callable එකක් module එකේ entry_point ලෙස තිබිය යුතුය. Refactor එකක් අතරදී එය වෙනස් කළහොත්, ලොග් වල වැරදි පෙනෙන්නේ නැතත්, සබමිෂන් අසාර්ථක වේ. එබැවින් wrapper එකක් නිර්මාණය කර, ඇතුළත implementation එක වෙනස් වූවත් public interface එක අඛණ්ඩව පවත්වා ගත හැක.
ශ්රී ලංකාවට ඇති වැදගත්කම
ශ්රී ලංකාවේ AI හා API සංවර්ධකයන්ට මේ පළග්ඡින් ප්රකාශන ක්රියාවලිය ඉතා ප්රයෝජනවත් වේ. නිවැරදි manifest සහ dependency pinning ක්රමවේදය අනුගමනය කිරීමෙන්, ලොකල් පරිසරයේ පරීක්ෂණයක් පමණක් නොව, ජාත්යන්තර මට්ටමේ පළග්ඡින් සාර්ථක කර ගැනීමට හැකියාව ලැබේ. මෙය විශ්ව විද්යාල සිසුන්ට, ස්ථානීය startup කණ්ඩායම්වලට, සහ IT සමාගම්වලට ඉගෙනුම, වේගවත් නිෂ්පාදනය, හා අඩු පරීක්ෂණ කාලය ලබා දේ.
- සමහර විට dependency version ගැටළුව නිසා පළග්ඡින් අසාර්ථක වීම වැළැක්විය හැක.
- manifest එකේ සියලු ක්ෂේත්ර නිවැරදිව පුරවා, automated validator එක පසුබැසීමක් නොකරයි.
- ඉදිරි සංස්කරණ වලදී wrapper එකක් භාවිතා කර, internal refactor වලින් පළග්ඡින් අඩංගු වීම තහවුරු කරයි.
ඉතා සුළු පියවරයක් ලෙස pip freeze > requirements.txt භාවිතා කර, ඒක runtime_dependencies වලට යොදීමෙන් reproducible environment එකක් සකස් කර, reviewers ලා අඩු අවදානමක් ලබා දේ.
අවසන් වශයෙන්, PyPI වෙතින් package එක ලබාගැනීමට අවශ්ය metadata (pyproject.toml) සම්පූර්ණයෙන්ම පිරවීමත්, license, classifiers වැනි තොරතුරු නිවැරදිව ඇතුළත් කිරීමත් අත්යවශ්ය වේ. මෙයින් පළග්ඡින් එකේ සාර්ථක පළ කිරීමේ හැකියාව වැඩිවේ.
අදම මේ ක්රමවේද අනුගමනය කර, ඔබේ Claude පලග්ඡින් එක මාර්කට්පලේස්ෙහි අඩු පියවරකින් පළකරන්න.
