منصوبے کے بارے میں

FinanceDatabase ایک اوپن سورس Python پیکیج ہے جو مالیاتی آلات کا ایک بڑا، منتخب حوالہ جاتی ڈیٹا بیس فراہم کرتا ہے۔ اس میں 300,000 سے زائد علامات شامل ہیں جو ایکویٹیز (تقریباً 112,690، 11 شعبوں، 80 صنعتوں، 117 ممالک اور 84 ایکسچینجز میں)، ETFs (تقریباً 36,481، 313 خاندانوں اور 44 زمروں میں)، فنڈز (تقریباً 57,853، 1,540 خاندانوں میں)، انڈیکس (تقریباً 91,181)، کرنسیاں (تقریباً 2,556)، کریپٹو کرنسیاں (تقریباً 3,367) اور منی مارکیٹس (تقریباً 1,367) پر محیط ہیں۔ یہ پروجیکٹ واضح طور پر مارکیٹ ڈیٹا یا بنیادی اعداد و شمار کا ذریعہ نہیں ہے۔ اس کے بجائے، یہ مصنوعات کی درجہ بندی اور میٹا ڈیٹا پر توجہ مرکوز کرتا ہے: ہر علامت کے لیے یہ ٹکر، نام، کرنسی، شعبہ، صنعتی گروپ، صنعت، ایکسچینج، مارکیٹ، ملک، ریاست، شہر، زپ کوڈ، ویب سائٹ، مارکیٹ کیپ کیٹیگری، ISIN، CUSIP اور FIGI شناخت کنندگان محفوظ کرتا ہے۔ یہ اسے کسی مخصوص ملک، شعبے یا صنعت میں موجود مصنوعات کو دریافت کرنے اور دیگر مالیاتی ڈیٹا ورک فلو کو افزودہ کرنے کے لیے مفید بناتا ہے (مصنف اسے اصل قیمت اور بنیادی ڈیٹا کے لیے الگ FinanceToolkit پیکیج کے ساتھ جوڑتا ہے)۔ تنصیب ایک ہی `pip install financedatabase -U` کمانڈ سے ہوتی ہے، جس کے بعد پیکیج کو `import financedatabase as fd` کے طور پر درآمد کیا جاتا ہے۔ ہر اثاثہ کلاس کو ایک کلاس کے طور پر پیش کیا جاتا ہے (مثال کے طور پر `fd.Equities()`) اور ایک بار مثال بننے کے بعد اسے `select(...)` کے ذریعے کلیدی فلٹرز جیسے `country`، `sector`، `industry`، `exchange`، `market`، `currency`، `market_cap` اور `only_primary_listing` کے ساتھ استفسار کیا جا سکتا ہے۔ فلٹرز یا تو ایک واحد قدر قبول کرتے ہیں یا قدروں کی فہرست، جس صورت میں کوئی بھی مماثلت واپس کی جاتی ہے۔ ایک `show_options(...)` مددگار ہر کالم کے لیے دستیاب الگ الگ قدروں کی فہرست دیتا ہے، اختیاری طور پر دیگر فلٹرز کے ذریعے محدود، تاکہ صارفین مکمل ڈیٹا فائلوں کو لوڈ کیے بغیر درجہ بندی کو دریافت کر سکیں۔ چونکہ ایک ہی کمپنی متعدد ایکسچینجز پر درج ہو سکتی ہے، نتائج میں نقل شدہ کمپنیاں شامل ہو سکتی ہیں؛ `only_primary_listing` پرچم یا واضح `exchange`/`market` فلٹر اسے محدود کرتا ہے۔ بنیادی ڈیٹا CSV فائلوں کے طور پر محفوظ کیا جاتا ہے، جسے پروجیکٹ ایک جان بوجھ کر ڈیزائن کا انتخاب قرار دیتا ہے: کوڈنگ کے تجربے کے بغیر شراکت دار ٹکرز کو شامل، ترمیم یا حذف کرنے کے لیے فائلوں میں براہ راست ترمیم کر سکتے ہیں، اور README میں CONTRIBUTING.md گائیڈ کے ذریعے کمیونٹی شراکت کی دعوت شامل ہے۔ یہ پیکیج PyPI پر تقسیم کیا جاتا ہے، متعدد Python ورژنز کی حمایت کرتا ہے، اور Jeroen Bouma کے زیرِ انتظام ہے۔ یہ ان تمام لوگوں کے لیے تجارتی حوالہ جاتی ڈیٹا فراہم کنندگان کا ایک مفت، کمیونٹی پر مبنی متبادل کے طور پر پیش کیا گیا ہے جو عالمی مالیاتی مصنوعات کی کائنات کا ایک وسیع، فلٹر کے قابل جائزہ چاہتے ہیں۔