Light

google / files.dart Goto Github PK

View Code? Open in Web Editor NEW

20.0 16.0 8.0 35 KB

A filesystem API with implementations for multiple environments

License: BSD 3-Clause "New" or "Revised" License

Dart 96.72% Shell 1.61% HTML 1.67%

files.dart's Introduction

files.dart

Status

This package is deprecated. For a more full-featured replacement, see package:file or similar.

Overview

This package defines filesystem APIs that can be implemented for different environments such as dart:io, Chrome Apps, or network filesystems.

The API includes FileSystem, File and Directory classes with interfaces similar to those in dart:io, excluding synchronous operations and constructors.

All File and Directory implementations should not have public constructors, and instances should only be retreived via a FileSystem instance. This ensures that code that uses the interfaces defined here can work with any implementations.

files.dart's People

Contributors

Stargazers

Watchers

Forkers

devoncarew adam-singer himanshuranjan30 neotim isabella232 test-mass-forker-org-1 ghas-results thecodeofmontecristo

files.dart's Issues

publish on pub.dartlang.org

Just a tracking issue, so I know when I can start using it from there.

unused import dart:async

unused import dart:async as Futures and Streams already implemented in dart:core as per Dart 2.1

in-memory FileSystem implementation

This would be useful for things like mocking when testing.

chrome app FileSystem implementation

Based on the https://github.com/dart-gde/chrome.dart package.

Hard to understand which well known principles of programming you use.

abstract class HtmlFileSystemEntry implements FileSystemEntry {
  HtmlFileSystemEntry._(this._fs, this._path);
}

This class is an abstract class.
This class is a public class.
This class with a private constructor.

Public abstract class with a private constructor.

How can be called such programming techniques?

This technique only useful for the static classes.

Eg.

abstract class Platform {
  Platform._internal();

  static final int foo = 0;
}

This class is an abstract class (cannot be instantiated).
This class is a public class (cannot be used anywhere).
This class with a private constructor (cannot be instantiated).

What wrong with this approach?

abstract class HtmlFileSystemEntry implements FileSystemEntry {
}

class _HtmlFileSystemEntry implements HtmlFileSystemEntry {
  _HtmlFileSystemEntry(this._fs, this._path);
}

Of cource, if you really need HtmlFileSystemEntry interface.

P.S.

I know that you (possible) like a Dartish way.
But Dartish way (beloved by ahe) are not a right way for the many serious programmers.

This is because, if your HtmlFileSystemEntry is an interface purpose type then it has a wrong design.

abstract class HtmlFileSystemEntry implements FileSystemEntry {
  final HtmlFileSystem _fs;
  final String _path;

  HtmlFileSystemEntry._(this._fs, this._path);

  String get path => _path;
}

Remeber: I cannot use it as an interface.

// Missing concrete implementation 
// of getter 'HtmlFileSystemEntry._path',
// getter 'HtmlFileSystemEntry._fs'
// getter 'HtmlFileSystemEntry.path'
class MyHtmlFileSystemEntry implements HtmlFileSystemEntry {
}

If I cannot use it as an interface then why it is a

Public
Abstract
Has a private constructor

Where is a logic?

drone.io tests

Set up drone.io to test on each commit.

Recommend Projects

React

A declarative, efficient, and flexible JavaScript library for building user interfaces.
Vue.js

🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
Typescript

TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
TensorFlow

An Open Source Machine Learning Framework for Everyone
Django

The Web framework for perfectionists with deadlines.
Laravel

A PHP framework for web artisans
D3

Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

javascript

JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
web

Some thing interesting about web. New door for the world.
server

A server is a program made to process requests and deliver data to clients.
Machine learning

Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Visualization

Some thing interesting about visualization, use data art
Game

Some thing interesting about game, make everyone happy.

Recommend Org

Facebook

We are working to build community through open source technology. NB: members must have two-factor auth.
Microsoft

Open source projects and samples from Microsoft.
Google

Google ❤️ Open Source for everyone.
Alibaba

Alibaba Open Source for everyone
D3

Data-Driven Documents codes.
Tencent

China tencent open source team.