Revert "Completely new cross-platform API introduced" (#957)

This reverts commit 0def20c.

Temporarily reverting to fix long-tail issues with internal usage
patterns.

Author: natebosch

pkgs/platform/.gitignore

@@ -4,7 +4,8 @@
 .dart_tool/
 .pub/
 build/
-doc/
+packages
+.packages
 
 # Include when developing application packages.
 pubspec.lock

pkgs/platform/CHANGELOG.md

@@ -1,17 +1,3 @@
-## 3.2.0-wip
-
-* New non-backwards compatible API.
-  Use `Platform.current` to access the current platform,
-  and `Platform.current.native` to either get access to native
-  platform information, or get a `null` on non-native platforms.
-  Similarly `Platform.current.web` is only non-`null` on the web.
-
-  Mocking APIs are moved to a separate library to ensure they are
-  only used for testing, and to allow better performance in production.
-
-  Legacy APIs are deprecated, but retained and emulated using the new API.
-  Use `dart fix` to migrate off the deprecated API.
-
 ## 3.1.7-wip
 
 - Run `dart format` with the new style.

pkgs/platform/README.md

@@ -1,51 +1,10 @@
-[![Pub](https://img.shields.io/pub/v/platform.svg)](https://pub.dev/packages/platform)
+[![Pub](https://img.shields.io/pub/v/platform.svg)](https://pub.dartlang.org/packages/platform)
 
 A generic platform abstraction for Dart.
 
-### Cross-platform platform API
-Provides access to platform specific information of the current runtime platform
-through a cross-platform API.
+Like `dart:io`, `package:platform` supplies a rich, Dart-idiomatic API for
+accessing platform-specific information.
 
-On a native platform, the `NativePlatform` class in this package provides a
-lightweight wrapper around the static `Platform` properties of `dart:io`,
-with the same rich, Dart-idiomatic API for querying the current runtime.
-
-On the web, there is no `NativePlatform` object, and cross-platform client code
-can avoid dependencies on such properties simply by checking if
-`Platform.current.nativePlatform` is `null`.
-Instead web code has a `Platform.current.browserPlatform` values that is
-a non-`null` `BrowserPlatform`.
-
-Example:
-```dart
-import 'package:platform/platform.dart';
-
-void main() {
-  switch (Platform.current) {
-    case Platform(:var nativePlatform?):
-      // `nativePlatform` has `dart:io`'s `Platform` properties.
-      print(
-        'Running on ${nativePlatform.operatingSystem} v.'
-        '${nativePlatform.operatingSystemVersion}',
-      );
-    case Platform(:var browserPlatform?):
-      // `browserPlatform` has version information from `windows.userAgent`.
-      print('Running on ${browserPlatform.userAgent}');
-  }
-}
-```
-
-### Code size
-
-Using platform-specific properties like `Platform.isLinux` as branch conditions
-will allow a production compiler to completely omit the branch
-that it knows it's not currently compiling for.
-
-### Testing and Mocking
-
-In tests, the `package:platform/testing.dart` library provides ways to mock
-platform objects with custom tailored configurations,
-and allows `Zone` based overriding of the `Platform.current` value.
-> [!NOTE]
-> The testing library should only be used in tests, since its mere presence
-> may affect how much code a compiled program will retain.
+`package:platform` provides a lightweight wrapper around the static `Platform`
+properties that exist in `dart:io`. However, it uses instance properties rather
+than static properties, making it possible to mock out in tests.

pkgs/platform/analysis_options.yaml

@@ -4,6 +4,3 @@ analyzer:
   errors:
     # Allow having TODOs in the code
     todo: ignore
-    # Increase the pressure?
-    deprecated_member_use: warning
-    deprecated_member_use_from_same_package: warning

pkgs/platform/example/bin/example.dart

@@ -0,0 +1,15 @@
+import 'package:platform/platform.dart';
+
+void main(List<String> arguments) {
+  const LocalPlatform platform = LocalPlatform();
+
+  print('Operating System: ${platform.operatingSystem}.');
+  print('Local Hostname: ${platform.localHostname}.');
+  print('Number of Processors: ${platform.numberOfProcessors}.');
+  print('Path Separator: ${platform.pathSeparator}.');
+  print('Locale Name: ${platform.localeName}.');
+  print('Stdin Supports ANSI: ${platform.stdinSupportsAnsi}.');
+  print('Stdout Supports ANSI: ${platform.stdoutSupportsAnsi}.');
+  print('Executable Arguments: ${platform.executableArguments}.');
+  print('Dart Version: ${platform.version}.');
+}