.
EarwigBot یک ربات پایتون که ویرایش ویکیپدیا و تعامل با مردم بیش از IRC و nbsp است؛ این فایل فراهم می کند مروری اساسی نحوه نصب و راه اندازی ربات. اطلاعات بیشتر در اسناد / دایرکتوری (آنلاین موجود در PyPI) واقع شده است.
تاریخ
توسعه آغاز شد، بر اساس چارچوب Pywikipedia، در اوایل سال 2009. تصویب برای کار مشت خود را، یک آشکارساز نقض کپی رایت، از مه انجام شد، و ربات در حال اجرا به طور مداوم از زمانی که (به استثنای ژانویه / فوریه 2011). در حال حاضر دسته چند برنامه در حال انجام اعم از نسل آمار به دسته پاکسازی، و وظایف بر روی تقاضا مانند رده قالب برچسب زدن. از آنجا که آغاز شده در حال اجرا، ربات تا کنون بیش از 50000 ویرایشهای ساخته شده است.
پروژه به آن بازنویسی از ابتدا در اوایل آوریل 2011 شروع شده، در نتیجه در حال حرکت به دور از چارچوب Pywikipedia و اجازه می دهد برای کد کمتر به طور کلی، یکپارچه سازی بهتر بین قطعات ربات، و تعمیر و نگهداری آسان تر است.
نصب
این بسته شامل earwigbot هسته ای، خلاصه به اندازه کافی است که آن را باید قابل استفاده و قابل تنظیم توسط هر کسی در حال اجرا به یک ربات بر روی یک سایت مدیاویکی باشد. از آنجا که مبتنی بر مولفه است، اجزای IRC را می توان در صورت تمایل غیر فعال است. دستورات IRC و وظایف ربات های خاص به عنوان مثال من از EarwigBot که من کاربر به طور متوسط احساس نیاز در دسترس خواهد بود از مخزن earwigbot-پلاگین می باشد.
توصیه برای اجرای آزمون واحد ربات را قبل از نصب. اجرای آزمون setup.py پایتون از دایرکتوری ریشه پروژه. توجه داشته باشید که برخی از آزمایشات نیاز به اتصال به اینترنت، و دیگران ممکن است مدتی طول بکشد تا اجرا شود. پوشش در حال حاضر و نه ناقص.
نصب
ربات ذخیره داده های آن در یک "دایرکتوری"، از جمله فایل و پایگاه داده پیکربندی آن است. همچنین این محل که در آن شما خواهد شد دستورات IRC سفارشی و وظایف ربات، که بعدا توضیح داده خواهد شد قرار دهید. مهم نیست که در آن این شاخه است، تا زمانی که ربات می تواند به آن ارسال.
شروع ربات با مسیر earwigbot / به / کار / دیر، و یا فقط earwigbot اگر دایرکتوری دایرکتوری جاری است. این متوجه خواهید شد که هیچ فایل config.yml وجود دارد و شما را از طریق فرآیند نصب.
است وجود دارد در حال حاضر هیچ راهی برای ویرایش فایل config.yml از درون ربات پس از آن ایجاد شده است، اما YAML فرمت بسیار ساده و آسان است، بنابراین شما باید قادر به ایجاد تغییرات لازم خود را داشته باشد. اتمام توضیح YAML در ویکیپدیا کمک کنید.
پس از نصب، ربات شروع خواهد شد. این به این معنی آن را به سرورهای IRC آن شده است برای، وظایف برنامه ربات پیکربندی شده برای اجرا در زمان های خاص (در IRC به عنوان دستورات) اتصال، و پس از آن منتظر دستورالعمل. برای یک لیست از دستورات، می گویند "کمک!" (دستورات پیام پیشوند با یک علامت تعجب هستند).
شما می توانید ربات در هر زمان با کنترل + C، همان متوقف به عنوان یک برنامه پایتون طبیعی شما را متوقف، و آن را امتحان کنید به خروج با خیال راحت. شما همچنین می توانید "! ترک" فرمان در IRC استفاده کنید.
سفارشی
ربات دایرکتوری کار شامل دایرکتوری فرعی دستورات و دایرکتوری فرعی وظایف. دستورات IRC سفارشی را می توان در سابق قرار داده شده، در حالی که وظایف ربات ویکی سفارشی به دومی بروید. در حال توسعه ماژول های سفارشی از طریق اسناد و مدارک ربات در PyPI در زیر توضیح داده، و با جزئیات بیشتر (یا در اسناد / دیر).
توجه داشته باشید که دستورات سفارشی خواهد شد ساخته شده است در دستورات و وظایف با همین نام زیر پا بگذارند.
ربات و BotConfig
earwigbot.bot.Bot کلاس اصلی EarwigBot است. شما لازم نیست به نمونه خودتان این را، اما آن را خوب به با ویژگی ها و روش های آن آشنا، به این دلیل که راه اصلی برای برقراری ارتباط با بخش های دیگر ربات است. شی بدون عنوان یک ویژگی از دستورات و وظایف (به عنوان مثال، self.bot) قابل دسترسی است.
earwigbot.config.BotConfig اطلاعات پیکربندی فروشگاه برای ربات. رشته مستندساز آن توضیح می دهد که هر صفت برای استفاده، اما اساسا هر "گره" (یکی از config.components، ویکی، IRC، دستورات، وظایف، و ابرداده) نقشه به بخش فایل config.yml ربات است. برای مثال، اگر config.yml شامل چیزی شبیه به:
IRC:
& nbsp؛ در ظاهر:
& nbsp؛ از نیک: MyAwesomeBot
& nbsp؛ در کانال:
و nbsp؛ - "## earwigbot"
و nbsp؛ - "#channel"
و nbsp؛ - "# دیگر کانال"
... پس از آن config.irc ["ظاهر"] ["نیک"] خواهد بود "MyAwesomeBot" و config.irc ["ظاهر"] ["کانال"] خواهد شد ["earwigbot ##"، "#channel"، "# دیگر کانال"].
دستورات IRC سفارشی
دستورات سفارشی زیر از earwigbot.commands.Command که نادیده گرفتن روند فرماندهی () (و چک اختیاری () و یا راه اندازی ()) روش می باشد.
ربات دارای یک انتخاب گسترده ای از ساخته شده است در دستورات و پلاگین ها را به عنوان نمونه کد عمل و / یا به دادن ایده های. شروع با آزمون و پس از اتمام chanops و afc_status برای برخی از اسکریپت پیچیده تر است.
وظایف ربات های سفارشی
وظایف سفارشی زیر از earwigbot.tasks.Task که باطل اجرا وظیفه را () (و راه اندازی اختیاری ()) روش می باشد.
وظیفه wikiproject_tagger ساخته شده است در برای یک کار نسبتا ساده را مشاهده کنید، یا afc_statistics برای یک پیچیده تر پلاگین.
ویکی مجموعه ابزارهای
پاسخ EarwigBot به چارچوب Pywikipedia ویکی مجموعه ابزارهای (earwigbot.wiki)، که به شما عمدتا از طریق bot.wiki دسترسی است.
bot.wiki فراهم می کند سه روش برای مدیریت سایت های - get_site ()، add_site ()، و remove_site (). سایت های اشیاء است که به سادگی نشان دهنده یک سایت مدیاویکی هستند. به عنوان مثال تنها از EarwigBot (یعنی یک شاخه تک) انتظار می رود که مربوط به یک سایت یا گروه از سایت های با استفاده از اطلاعات ورود به سایت همان (مثل همه ویکیهای WMF با CentralAuth) تنها.
بارگزاری سایت به طور پیش فرض خود را (که شما در طول راه اندازی برداشت) با سایت = bot.wiki.get_site ().
همه جنبه های مجموعه ابزار در اسناد پوشیده شده است. کاوش کد و docstrings خود را به یاد بگیرند که چگونه به استفاده از آن در یک دست بر روی بیش مد. برای مرجع، bot.wiki است یک نمونه از earwigbot.wiki.SitesDB به فایل sites.db در ربات را شاخه گره خورده است
مورد نیاز:.
پایتون
نظر یافت نشد