API change proposal and new examples

[epogrebnyak]

import boo

boo.download(year=2018, folder=".")
boo.read_dataframe(year=2018, folder=".", names="long", nrows=1000)

# ("text", "numeric")

(1100, "total_assets", "ta")

[epogrebnyak]

    [
        ("Наименование", "name"),
        ("ОКПО", "okpo"),
        ("ОКОПФ", "okopf"),
        ("ОКФС", "okfs"),
        ("ОКВЭД", "okved"),
        ("ИНН", "inn"),
        ("Код единицы измерения", "unit"),
        ("Тип отчета", "report_type"),
        ("Дата актуализации", "date_published"),
        # --  Баланс
        # --  Внеоборотные активы
        ("1100", "ta_fixed"),
        ("1150", "of"),
        ("1170", "ta_fixed_fin"),
        # --  Оборотные активы
        ("1200", "ta_current"),
        ("1210", "inventory"),
        ("1230", "receivables"),
        ("1240", "ta_current_fin"),
        ("1250", "cash"),
        ("1600", "ta"),
        # --  Пассивы
        ("1300", "tp_capital"),
        ("1360", "retained_earnings"),
        ("1400", "tp_long"),
        ("1410", "debt_long"),
        ("1500", "tp_short"),
        ("1510", "debt_short"),
        ("1520", "payables"),
        ("1700", "tp"),
        # --  ОПУ
        ("2110", "sales"),
        ("2120", "costs"),
        ("2200", "profit_oper"),
        # more items here
        ("2330", "exp_interest"),
        ("2300", "profit_before_tax"),
        ("2400", "profit_after_tax"),
        # -- ОДДС
        ("4400", "cf"),
        # -- Операционная деятельность
        ("4100", "cf_oper"),
        ("4110", "cf_oper_in"),
        ("4111", "cf_oper_in_sales"),
        ("4120", "cf_oper_out"),
        ("4121", "paid_to_supplier"),
        ("4122", "paid_to_worker"),
        ("4123", "paid_interest"),
        ("4124", "paid_profit_tax"),
        # -- Инвестицонная деятельность
        ("4200", "cf_inv"),
        ("4210", "cf_inv_in"),
        ("4220", "cf_inv_out"),
        ("4221", "paid_fa_investment"),
        # -- Финансовая деятельность
        ("4300", "cf_fin"),
        ("4310", "cf_fin_in"),
        ("4311", "cf_loan_in"),
        ("4312", "cf_eq_in_1"),
        ("4313", "cf_eq_in_2"),
        ("4314", "cf_bond_in"),
        ("4320", "cf_fin_out"),
        ("4321", "cf_eq_out"),
        ("4322", "cf_div_out"),
        ("4323", "cf_debt_out"),
    ]