fimber 0.1.2

  • README.md
  • CHANGELOG.md
  • Example
  • Installing
  • Versions
  • 84

fimber #

Extensible logging for Flutter.

Based on famous Android logging library - Timber, this is library for simplify logging for Flutter. Using similar (as far as Dart lang allows) method API with same concepts for tree and planting logging tree.

Getting Started #

To start add using it:

  • Add fimber to pubspec.yaml
dependencies:
  fimber: ^0.1.0
  • remember about import
import 'fimber.dart';

  • Initialize logging tree on start of your application

void main() {
  Fimber.addTree(DebugTree());
  runApp(new MyApp());
}
 
  • Start using it with static methods:
import 'fimber.dart';


void main() {
  var parameter = 343.0;
  // use directly
  Fimber.i("Test message $argument");
  Fimber.i("Extra error message", ex: Exception("Test thorwable"));
  
  // other log levels
  Fimber.d("DEBUG");
  Fimber.v("VERBOSE");
  Fimber.w("WARN");
  
}

This will log the value and grab a TAG from stacktrace - that is little costly and if more logs will be done per second.

  • Create tagged version of Fimber and use its instance inside class, you can create logger for a dart file or for a class.
var logger = FimberLog("MY_TAG");

void main() {
  
  logger.d("Test message");
}

// or inside a class
class SomeBloc {
  var logger = FimberLog("SomeBloc");
  String fetchMessage() {
    logger.d("About to fetch some data.");
    //...
    var data = "load something";

    logger.d("Retrived data (len = ${data.length}");
    return data;
  }
}

TODO - road map #

  • un-plant single tree
  • Make this Dart only Logger and use flutter dependency only for plugins
  • withLogger blocks
  • Add Tree for platform specific log/tag logging via channels - plugins
  • Add Crashlytics plugin (maybe other remote logger tools) with flutter_crashlytics

Licence #


   Copyright 2018 Mateusz Perlak

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.

[0.1.2] - only dart package form fimber

  • small changes around packaging and removing any flutter references
  • revert to print from debugPrint for dart only support.
  • DebugTree got printLog method to override to support other solution to print formatted log line tou output stream, will be helpful in AndroidDebugTree (for example).
  • Updates to stacktrace dumping for DebugTree and added method to extract stacktrace

[0.1.1] - Small updates

Small updates

[0.1.0] - First Version

Initial version with Fimber debugging and DebugTree

example/example.dart

import 'package:fimber/fimber.dart';

void main() {
  // plant a tree - DebugTree()
  Fimber.plantTree(DebugTree());

  Fimber.d("Test message", ex: Exception("test error"));
  var parameter = 100.0;
  Fimber.w("Test message with parameter: $parameter");

  var logger = FimberLog("MY_TAG");
  logger.d("Test message", ex: Exception("test error"));
  logger.w("Test message with parameter: $parameter");

  // save auto tag generation on each call in call block.
  Fimber.withTag("TEST BLOCK", (log) {
    log.d("Started block");
    for (var i = 0; i >= 1; i++) {
      log.d("value: $i");
    }
    log.i("End of block");
  });


}

Use this package as a library

1. Depend on it

Add this to your package's pubspec.yaml file:


dependencies:
  fimber: ^0.1.2

2. Install it

You can install packages from the command line:

with pub:


$ pub get

with Flutter:


$ flutter packages get

Alternatively, your editor might support pub get or flutter packages get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:


import 'package:fimber/fimber.dart';
  
Version Uploaded Documentation Archive
0.1.10 Feb 3, 2019 Go to the documentation of fimber 0.1.10 Download fimber 0.1.10 archive
0.1.9 Jan 22, 2019 Go to the documentation of fimber 0.1.9 Download fimber 0.1.9 archive
0.1.8 Jan 12, 2019 Go to the documentation of fimber 0.1.8 Download fimber 0.1.8 archive
0.1.7 Dec 19, 2018 Go to the documentation of fimber 0.1.7 Download fimber 0.1.7 archive
0.1.6 Dec 18, 2018 Go to the documentation of fimber 0.1.6 Download fimber 0.1.6 archive
0.1.5 Dec 6, 2018 Go to the documentation of fimber 0.1.5 Download fimber 0.1.5 archive
0.1.4 Nov 30, 2018 Go to the documentation of fimber 0.1.4 Download fimber 0.1.4 archive
0.1.3 Nov 27, 2018 Go to the documentation of fimber 0.1.3 Download fimber 0.1.3 archive
0.1.2 Nov 24, 2018 Go to the documentation of fimber 0.1.2 Download fimber 0.1.2 archive
0.1.1 Nov 8, 2018 Go to the documentation of fimber 0.1.1 Download fimber 0.1.1 archive

All 11 versions...

Popularity:
Describes how popular the package is relative to other packages. [more]
75
Health:
Code health derived from static analysis. [more]
100
Maintenance:
Reflects how tidy and up-to-date the package is. [more]
80
Overall:
Weighted score of the above. [more]
84
Learn more about scoring.

We analyzed this package on Feb 14, 2019, and provided a score, details, and suggestions below. Analysis was completed with status completed using:

  • Dart: 2.1.0
  • pana: 0.12.13

Platforms

Detected platforms: Flutter, web, other

No platform restriction found in primary library package:fimber/fimber.dart.

Health suggestions

Format lib/fimber.dart.

Run dartfmt to format lib/fimber.dart.

Maintenance issues and suggestions

Homepage URL doesn't exist. (-20 points)

At the time of the analysis the homepage field https://github.com/magillus/flutter-fimber/fimber was unreachable.

Dependencies

Package Constraint Resolved Available
Direct dependencies
Dart SDK >=2.0.0-dev.68.0 <3.0.0
Dev dependencies
test ^1.5.1