Neo-Python 0. 9. 1

مستندات کامل در مورد نحوه نصب ، پیکربندی و استفاده از Neo-Python را می توان در خواندن اسناد یافت.

کمک بگیرید یا کمک کنید

• اگر با مشکلی روبرو شدید ، مسئله جدیدی را باز کنید.
• یا پینگ ixje در Neo Discord.
• درخواست درخواست خوش آمدید. برای ایده ها به لیست شماره ها نگاهی بیندازید. شما می توانید در مورد عملکرد کیف پول ، تست های نوشتن یا مستندات یا هر ویژگی دیگری که به نظر شما عالی است کمک کنید.

شروع شدن

Neo-Python دارای دو وابستگی به سیستم است (همه چیز دیگر با PIP پوشیده شده است):

• سطح پایین
• پایتون 3. 7 (3. 6 و پایین پشتیبانی نمی شود)

ما یک ویدیوی YouTube را منتشر کرده ایم تا به شما کمک کند. فیلم های بسیار بیشتری در زیر کانال YouTube Cityofzion وجود دارد ، آنها را بررسی کنید.

اسکله

استفاده از Docker گزینه دیگری برای اجرای Neo-Python است. Dockerfiles به عنوان مثال در پوشه/docker ارائه شده است ، و ما یک تصویر در Docker Hub داریم که پس از انتشار Neo-Python برچسب گذاری شده است: https://hub. docker. com/r/cityofzion/neo-python/

نصب بومی

دستورالعمل های مربوط به تنظیم سیستم برای Neo-Python:

سطح پایین

اوس

نصب LevelDB

اوبونتو/دبیان 18. 04+

در زمان نوشتن این پیام ، مدیر بسته Ubuntu فقط Python 3. 7. 0 را لیست می کند. از آن زمان به نشت حافظه پرداخته شده است و توصیه می شود پایتون 3. 7. 3 یا جدیدتر را اجرا کنید. این راهنمای اوبونتو را در مورد چگونگی اضافه کردن یک PPA جایگزین به لیست منابع خود برای نصب یا نحوه تهیه آخرین نسخه به صورت دستی بخوانید.

Centos/Redhat/Fedora

توجه: - آزمایش نشده -

لطفاً در صورت بروز مشکلات ، reamde را اصلاح کنید. Python 3. 7. 3 را به دنبال این راهنمای Centos نصب کنید.

پنجره ها

در حال حاضر ، شما باید از زیر سیستم لینوکس با اوبونتو یا یک ماشین مجازی با لینوکس استفاده کنید. می توانید اطلاعات بیشتری و راهنمای تنظیم زیر سیستم لینوکس را در اینجا پیدا کنید.

نصب "Ubuntu" از Microsoft Store Ubuntu 16. 04 را نصب می کند. شما باید Ubuntu 18. 04 را از فروشگاه Microsoft که در اینجا یافت می شود نصب کنید: https://www. microsoft. com/en-us/p/ubuntu-1804/9n9tngvndl3q؟activetab=pivot٪3aoverviewtabab

برای اجرای بومی کمک کنید. به نظر می رسد نصب بسته بندی Python Pack Plyvel به پشتیبانی کامپایلر C ++ گره خورده به Visual Studio و کتابخانه ها نیاز دارد. به مستندات مراجعه کنید.

پایتون 3. 7+

Neo-Python با Python 3. 7 و بعد از آن سازگار است.

در *Nix Systems ، Python Python 3. 7 را از طریق مدیر بسته خود نصب کنید ، یا یک بسته نصب را از صفحه اصلی رسمی بارگیری کنید.

نصب

توصیه می شود همه وابستگی های پروژه را در محیط مجازی خود قرار دهید ، به این ترتیب ما نصب جهانی را که می تواند منجر به درگیری های نسخه شود ، آلوده نمی کنیم.

1. نصب از GitHub:

git کلون https://github. com/cityofzion/neo-python. git cd neo-python # اگر می خواهید از شاخه توسعه استفاده کنید ، اکنون با استفاده از پایتون 3. 7 ، محیط مجازی را ایجاد کنید و با استفاده از پایتون 3. 7 ایجاد کنید و به حالت دیگر فعال شوید و یا به حالت بعدی فعال شوید و یا به حالت بعدی فعال شوید. مرحله برای Python 3. 6 Python3. 7-m Venv VENV منبع Venv/Bin/Activate # بسته را به صورت قابل ویرایش (VENV) نصب PIP WHEE L-E نصب کنید.

1. از PYPI نصب کنید

# ایجاد پروژه dir mkdir myproject cd myproject # با استفاده از پایتون 3. 7 محیط مجازی ایجاد کنید و به مرحله بعدی برای پایتون 3. 6 python3. 7-m venv منبع venv/bin/bin/فعال (VENV) PIP Ne o-Python Wheel Ne o-Python را فعال کنید.

دویدن

پس از نصب الزامات و فعال کردن محیط ، استفاده از CLI (NP-Prompt) آسان است که گره را شروع می کند و امکان تعامل اساسی را فراهم می کند.

np-prompt NEO cli. Type 'help' to get started neo> show state Progress: 10926 / 11145 Block-cache length 0 Blocks since program start 0 Time elapsed 0.02598465 mins Blocks per min 0 TPS: 0 neo>

به طور پیش فرض ، CLI به TestNet متصل می شود (در زیر نحوه تغییر به Mainnet یا Privnet را ببینید).

بیایید برای یک بلوک در سرور فعلی توسط هش یا توسط بلوک شاخص پرس و جو کنیم:

np-prompt NEO cli. Type 'help' to get started neo>بلوک نمایش 122235<"hash": "0xf9d7bc6f337a6cbe124b92b90ad7b29e2628e78202ea2daa19ed93fdc779c0e6", "size": 686, "version": 0, "previousblockhash": "0x1f262a0979d6da0eabaaf54252fb2508564a99fee642a77ff0773671fe5fddb9", "merkleroot": "0x5d4f86734c2a53187aa96751b9180d69f85f9bd7875f2eb83a27666ad052ea1e", "time": 1496920870, "index": 122235, "nonce": "7847dea9df7571c1", "nextconsensus": "AdyQbbn6ENjqWDa5JNYMwN3ikNcA4JeZdk", "script": <"invocation": "40e5a7d23cb065308412d769ca2ba6dd974aa453d0c915c25a7d951488eaa6c4eff5bbe251f01725b959fb89e7dd631f7f41efd50897c466d75e8359154f6137bf402f690a98a44e5ecb22e7f20bb75bac40cac89f4805f4706ec9daf8e6ccc15def216d667423bb148e78db9461e288d7363f699741a0efb4c7c6c6dc902250cf3f4023ba2eb464aa8841cb2230c0f9f016a47c1e54e1f809da550743c33b0529b5996f4c5993a38bb73887e0b3fd7a093f6abd00d136048169a99cf34373560b8956408e816d0a0b018c348070da63f513b5b3332ef31914c420203b792f25048c1b8b397bc4bd47315be44491f7182be8aeca39035a2cd51a20da034820e5e1b5c0644052ce1cb6769e9dc9375ea96db8d538e6b2210a093c555f759ccf1d908f8c2fe3cf6236c4dade54ebca825a36e81049c7f4b149c1458c30b37460fc22581201f2", "verification": "55210209e7fd41dfb5c2f8dc72eb30358ac100ea8c72da18847befe06eade68cebfcb9210327da12b5c40200e9f65569476bbff2218da4f32548ff43b6387ec1416a231ee821034ff5ceeac41acf22cd5ed2da17a6df4dd8358fcb2bfb1a43208ad0feaab2746b21026ce35b29147ad09e4afe4ec4a7319095f08198fa8babbe3c56e970b143528d2221038dddc06ce687677a53d54f096d2591ba2302068cf123c1f2d75c2dddc542557921039dafd8571a641058ccc832c5e2111ea39b09c0bde36050914384f7a48bce9bf92102d02b1873a0863cd042cc717da31cea0d7cf9db32b74d4c72c01b0011503e2e2257ae">، "TX": [<"txid": "0x5d4f86734c2a53187aa96751b9180d69f85f9bd7875f2eb83a27666ad052ea1e", "size": 10, "type": "MinerTransaction", "version": 0, "attributes": [], "vout": [], "vin": [], "sys_fee": "0", "net_fee": "0", "scripts": [], "nonce": 3749016001>]> neo>

راه اندازی blockchain

اگر برای اولین بار از Neo-Python استفاده می کنید ، باید blockchain را همگام سازی کنید ، که ممکن است مدت زمان زیادی طول بکشد. در این پروژه شامل اسکریپت NP-Bootstrap برای بارگیری خودکار یک فهرست زنجیره ای برای شما است.

استفاده از NP-Bootstrap

$ np-bootstra p-h استفاده: np-bootstrap [-h] [-m] [-C پیکربندی] [-n] [-S] [--Datadir datadir] استدلال های اختیاری: -H ،--Help این کمک را نشان می دهدپیام و خرو ج-M ، -mainnet به جای پیکربندی پیش فرض TestNe t-C ، از mainnet استفاده کنید ، -پیکربند ی-کنفرانزنجیره ا-K ،-Keep-Bootstrap-File پرونده bootstrap بارگیری شده را نگه دارید-Datadir DataDir مسیر مطلق برای استفاده برای دایرکتوری های پایگاه داده

Testnet bootraping

برای بوت کردن blockchain testnet ، np-bootstrap را اجرا کنید ، یک فنجان قهوه تهیه کنید و صبر کنید. سپس ، پایگاه داده اعلان های TestNet را با N P-Bootstra p-n bootstrap کنید.

bootstrapping mainnet

برای بوت کردن blockchain mainnet ، n p-bootstra p-m را اجرا کنید و 8 فنجان قهوه (پرونده 9+ گیگابایتی) تهیه کنید. سپس ، پایگاه داده Notifications MainNet را با N P-Bootstra p-m -n bootstrap کنید.

نکته مهم: از پرونده های زنجیره ای از https://github. com/cityofzion/awesome-neo. git استفاده نکنید ، آنها با Neo-Python کار نخواهند کرد.

دستورات کیف پول اساسی

کیف پول ایجاد کیف پول باز کیف پول نزدیک (Verbose) بازسازی کیف پول (بلوک شروع) کیف پول واردات WIF EXPORT WIF کیف پول ارسال # (NEO/GAS) توکن کیف پول ارسال # nep5

برای لیست کاملی از دستورات از راهنما استفاده کنید.

در حال اجرا در Mainnet

برای اجرای سریع در MainNet ، می توانید از Argrent CL I-M (به عنوان مثال N P-Promp t-M) استفاده کنید ، برای اجرای در PrivNet می توانید ا ز-p استفاده کنید. حتماً جزئیات پارامترها را بررسی کنید:

$ np-promp t-h استفاده: np-prompt [-h] [-m |-P [میزبان] |-coznet |-C پیکربندی] [-t] [-v] [--datadir datadir] [-version] آرگومان های اختیاری: -H ،--Help این پیام راهنما را نشان می دهد و خرو ج-m ،-mainnet به جای پیش فرض از mainnet استفاده کنیدtestne t-p [host] ، -privnet [host] از یک شبکه خصوصی به جای پیش فرض testnet استفاده کنید ، به صورت اختیاری با استفاده از یک میزبان سفارشی (پیش فرض: 127. 0. 0. 1) -Coznet از شبکه Coz به جای پیکربندی پیش فرض TestNe t-C استفاده کنید،-پیکربندی-config از یک پرونده پیکربندی خا ص-t ،-تنظیم-تنظیم-موضوع استفاده کنید تا موضوع پیش فرض را برای بارگذاری از پرونده پیکربندی تنظیم کنید. پیش فرض: 'Dark' -V ، -نمایش وقایع قرارداد هوشمند به طور پیش فر ض-Datadir DataDir مسیر مطلق برای استفاده برای دایرکتوری های پایگاه داد ه-MaxPeers MaxPeers Max Peers برای استفاده برای پیوستن به P2 P-شماره نسخه برنامه نمایش و خروج

ورود به سیستم

در حال حاضر ، NP-Prompt به Prompt. log ثبت می شود

تست

توجه داشته باشید ما از یک پایگاه داده فیکسچین blockchain استفاده می کنیم (~15 مگابایت). این پرونده در repo نگه داشته نمی شود ، اما اولین بار که آزمایشات انجام می شود بارگیری می شود ، این می تواند مدتی طول بکشد (بسته به اتصال به اینترنت) ، اما فقط یک بار اتفاق می افتد.

دستورات مفید

استفاده از تست را انجام دهید ، پوشش را انجام دهید و اسناد را انجام دهید # فقط تست های نئو پیکون را اجرا کنید Pytho n-M Unittest Discover Neo # فقط آزمایشات Ne o-Boa را اجرا کنید Pytho n-M Unittest Discover Boa_Test

به روزرسانی شماره نسخه و انتشار نسخه های جدید Neo-Python

این یک لیست چک برای انتشار نسخه جدید است که در حال حاضر به معنی:

1. ادغام تغییرات از توسعه به استاد
2. تنظیم نسخه از EG. 0. 4. 6-DEV به 0. 4. 6 (که به طور خودکار یک برچسب/انتشار ایجاد کرده است)
3. در شاخه Dev ، نسخه را روی وصله بعدی تنظیم کنید ، به عنوان مثال. 0. 4. 7-dev
4. فشار آوردن به استاد ، توسعه و برچسب ها به GitHub

اطمینان حاصل کنید که در شعبه توسعه هستید و تمام تغییراتی را که می خواهید منتشر کنید ادغام شده اید. سپس این مراحل را دنبال کنید:

# فقط در صورتی که بخواهید دوباره شماره نسخه را افزایش دهید (به عنوان مثال دامنه از پچ به جزئی تغییر یافته است): # Bumpversion-بدون برچسب جزئی | عمده # به روزرسانی changeLog. rst: مطمئن شوید که همه تغییرات در آنجا وجود دارد و حذف `-dev`از شماره نسخه vi changeLog. rst git commi t-m" به روز شده ChangeLog برای انتشار "changeLog. rst # شعبه توسعه ادغام به Master Git Checkout Master Git Merge Development # شماره نسخه نسخه را تنظیم کنید و نسخه Tag Bumpversion را ایجاد کنید # سوئیچ را به داخل سوئیچ کنیدتوسعه Checkout Branch Git Branch Development # تعداد پچ را افزایش دهید و اضافه کردن `-dev` bumpversion-بدون برچسب # فشار به GitHub ، که همچنین بسته PYPI و Docker Hub Image Git Push Origin Master Development را به روز می کند-برچسب ها

عیب یابی

اگر با مشکل روبرو شدید ، این موارد را قبل از پاره کردن موهای خود بررسی کنید:

• بررسی کنید که از Python 3. 7. x استفاده می کنید
• وابستگی های پروژه را به روز کنید (Pip Instal l-e.)
• اگر با هر مشکلی روبرو شدید ، لطفاً به بخش نصب در اسناد نگاهی بیندازید ، و اگر این امر به باز کردن مسئله کمک نمی کند. ما سعی خواهیم کرد کمک کنیم.
• شما می توانید به ما در Neo Discord برسید ، یا به سادگی یک مسئله GitHub را مطرح کنید.

مجوز

• منبع باز MIT.
• مشارکت کنندگان: localhuman (خالق) ، metachris ، ixje و بسیاری دیگر

کمکهای مالی

پذیرفته شده در atemnpsjrvvsxmajw4zyjbsvuj6ur2mjqu