Flutter插件nohfibu的使用方法

Flutter插件nohfibu的使用方法

在本文中，我们将探索如何在Flutter应用中使用一个名为nohfibu的未知功能插件。该插件主要用于财务会计，并且基于复式记账法（由Luca Paciolo首次提出）。

入门指南

首先，我们需要安装nohfibu插件。你可以通过多种方式安装它，例如使用pubspec.yaml文件或直接从源码中运行。

使用 pubspec.yaml 安装

如果你使用的是pubspec.yaml文件，可以添加以下依赖：

dependencies:
  nohfibu:

然后运行flutter pub get来获取新的依赖项。

直接从源码中运行

你也可以直接从源码中运行nohfibu插件。这需要克隆仓库并运行脚本。

使用 nohfibu 插件

一旦安装了nohfibu插件，我们就可以开始使用它来执行一些基本操作，例如数据转换和会计分析。

数据转换

nohfibu 提供了一个转换器，用于将旧数据转换为CSV格式，以便导入到新的 Dart fibu 中。

dart run bin/wbconvert.dart --help

示例输出：

###  bboett@videopi:fibu$ dart run bin/wbconvert.dart --help
###  bin/wbconvert.dart: Warning: Interpreting this as package URI, 'package:nohfibu/wbconvert.dart'.
###  applying args: lang:de base:null out:null help:true strict:false  rest: []
###  -l, --lang           Language setting
###  		     (defaults to "de")
###  -f, --file           Basename of the dataset
###  -o, --output         output name
###  -?, --[no-]help      Help about the options
###  -s, --[no-]strict    enforce old WB-Style parsing

要实际进行转换，可以使用以下命令：

dart run bin/wbconvert.dart -f <your kpl file> -s

这将生成一个CSV文件，可以进一步处理。

会计分析

nohfibu 还提供了对CSV文件进行会计分析的功能。例如：

$ dart run bin/nohfibu.dart --help # to test directly from the source dir
$ nohfibu --help # if you have activated the project, or precompiled
$ nohfibu -r -b assets/wbsamples/sample # will analyze the .csv file and produce a .lst result file
$ nohfibu  -b assets/wbsamples/sample -f MERCH # will try to fill in new journal lines following the MERCH receipe (in the .csv file under OPS)

示例代码

下面是一个完整的示例代码，展示了如何在Flutter应用中使用nohfibu插件。

import 'dart:io';

import 'package:nohfibu/fibusettings.dart';
import 'package:nohfibu/csv_handler.dart';
import 'package:nohfibu/nohfibu.dart';

/// Launcher for the accounting analysis
///
/// -r launches the analysis
/// -b <name> set the base name to work on
///
/// Issues a result file with the accounting analysis
class Fibu {
  bool strict = false;

  ///book holds the accounting plan and the journal
  Book book = Book();

  ///CTOR
  Fibu({this.strict = false});

  /// launch the financial analysis, meaning, making the account extracts, fill in the final state
  /// of the accounts, and compare the 4 blocks of account (aktiva/passiva, expenses/income)
  /// to validate the accounting period
  String execute() {
    print("asked to run!");
    book.execute(); //TODO we should report if there were errors....

    String result = book.toString() + "\n";
    result += book.kpl.toString(extracts: true);
    result += "=" * 20 + "    Analysis    " + "=" * 20 + "\n";
    //result += "Aktiva    \n"+ (book.kpl.get("1")).toString(recursive: true)+"\n";
    result += book.kpl.analysis();
    return result;
  }
}

///to have a command line version of this program
void main(List<String> arguments) //async
{
  //print("incoming : $arguments");
  ///add command line argument parsing
  FibuSettings settings = FibuSettings();
  settings.parser.addFlag('run',
      abbr: 'r', defaultsTo: false, help: "run the accounting process");
  settings.init(arguments);
  Fibu fibu = Fibu();

  //print("result of arg run... : ${argResults["help"]}\n");
  //print("result of arg run... : ${argResults["help"]} sh: ${argResults["\?"]}\n");

  if (settings["help"] || settings["error"]) {
    print(settings.usage);
    exit(0);
  }

  ///provided a basename was given, a file with the data can be loaded , the CsvHandler class, reads in the csv
  /// and fills the book
  if (settings["base"] != null && settings["base"].isNotEmpty) {
    //print("opening file ${settings["base"]}");
    String basename = settings["base"];
    String fname = basename + ".csv";
    var handler = CsvHandler();
    handler.load(book: fibu.book, conf: settings);
    if (settings["run"]) {
      String result = fibu.execute();
      fname = (settings["output"].isNotEmpty)
          ? settings["output"]
          : basename + ".lst";
      //print ("retrieved\n$result");
      File(fname).writeAsString(result).then((file) {
        print("write seems successful, please check $fname");
      });
    } else
      print(
          "book so far: ${fibu.book} you need to set run if you want a compilation");
  } else
    print("no file to load");
  print("end of processing");
}