Merge pull request #14 from dart-lang/merge-gcloud-package

transfer package:gcloud

.github/workflows/gcloud.yml

@@ -0,0 +1,73 @@
+name: package:gcloud
+permissions: read-all
+
+on:
+  pull_request:
+    branches: [ main ]
+    paths:
+      - '.github/workflows/gcloud.yml'
+      - 'pkgs/gcloud/**'
+  push:
+    branches: [ main ]
+    paths:
+      - '.github/workflows/gcloud.yml'
+      - 'pkgs/gcloud/**'
+  schedule:
+    - cron: '0 0 * * 0' # weekly
+
+env:
+  PUB_ENVIRONMENT: bot.github
+
+jobs:
+  # Check code formatting and static analysis on a single OS (linux)
+  # against Dart dev.
+  analyze:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: pkgs/gcloud
+    strategy:
+      fail-fast: false
+      matrix:
+        sdk: [dev]
+    steps:
+      - uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332
+      - uses: dart-lang/setup-dart@0a8a0fc875eb934c15d08629302413c671d3f672
+        with:
+          sdk: ${{ matrix.sdk }}
+      - id: install
+        name: Install dependencies
+        run: dart pub get
+      - name: Check formatting
+        run: dart format --output=none --set-exit-if-changed .
+        if: always() && steps.install.outcome == 'success'
+      - name: Analyze code
+        run: dart analyze --fatal-infos
+        if: always() && steps.install.outcome == 'success'
+
+  # Run tests on a matrix consisting of two dimensions:
+  # 1. OS: ubuntu-latest, (macos-latest, windows-latest)
+  # 2. release channel: dev
+  test:
+    needs: analyze
+    runs-on: ${{ matrix.os }}
+    defaults:
+      run:
+        working-directory: pkgs/gcloud
+    strategy:
+      fail-fast: false
+      matrix:
+        # Add macos-latest and/or windows-latest if relevant for this package.
+        os: [ubuntu-latest]
+        sdk: [2.19.0, dev]
+    steps:
+      - uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332
+      - uses: dart-lang/setup-dart@0a8a0fc875eb934c15d08629302413c671d3f672
+        with:
+          sdk: ${{ matrix.sdk }}
+      - id: install
+        name: Install dependencies
+        run: dart pub get
+      - name: Run VM tests
+        run: dart test --platform vm -P ci
+        if: always() && steps.install.outcome == 'success'

pkgs/gcloud/.gitignore

@@ -0,0 +1,6 @@
+.dart_tool/
+pubspec.lock
+packages
+.pub
+.packages
+.idea

pkgs/gcloud/.status

@@ -0,0 +1,39 @@
+*/packages/*: Skip
+*/*/packages/*: Skip
+*/*/*/packages/*: Skip
+
+# We do not run the e2e tests inside the build/ directory in order to prevent
+# ./tools/test.py from running several e2e in parallel.
+build/test/db_all_e2e_test: Skip
+build/test/storage/e2e_test: Skip
+build/test/pubsub/pubsub_e2e_test: Skip
+
+# This test is slow because
+# - eventual consistency forces us to put in sleep()s
+# - it does e2e testing
+# - it combines several tests to avoid concurrent tests touching the same data
+test/db_all_e2e_test: Slow, Pass
+
+# This test is slow because
+# - it does e2e testing
+test/pubsub/pubsub_e2e_test: Slow, Pass
+
+[ $browser ]
+build/test/storage/e2e_test: Skip
+test/storage/e2e_test: Skip
+
+build/test/db_all_e2e_test: Skip
+test/db_all_e2e_test: Skip
+
+build/test/pubsub/pubsub_e2e_test: Skip
+test/pubsub/pubsub_e2e_test: Skip
+
+# Imports common_e2e.dart, which uses dart:io
+build/test/storage/storage_test: Skip
+test/storage/storage_test: Skip
+
+build/test/pubsub/pubsub_test: Skip
+test/pubsub/pubsub_test: Skip
+
+[ $compiler == dart2js ]
+*: Skip

pkgs/gcloud/AUTHORS

@@ -0,0 +1,6 @@
+# Below is a list of people and organizations that have contributed
+# to the Dart project. Names should be added to the list like so:
+#
+#   Name/Organization <email address>
+
+Google Inc.

pkgs/gcloud/CHANGELOG.md

@@ -0,0 +1,264 @@
+## 0.8.14
+- Support override metadata properties in `copyObject`.
+
+## 0.8.13
+- Support the latest version `^13.0.0` of the `googleapis` package.
+
+## 0.8.12
+- Support the latest version 12.0.0 of the `googleapis` package.
+
+## 0.8.11
+- After the first `Page` created by `Datastore.withRetry()` retries were not
+  happening. This is now fixed, ensuring that `Page.next()` will always retry
+  when `Datastore` is wrapped with `Datastore.withRetry()`.
+- Calling with `wait: false` in `Subscription.pull(wait: false)` for `PubSub`
+  have been deprecated.
+
+## 0.8.10
+
+- Widen the SDK constraint to support Dart 3.0
+- Support retrying Datastore operations.
+
+## 0.8.9
+
+- Support the latest version 1.0.0 of the `http` package.
+- Support the latest version 12.0.0 of the `googleapis` package.
+
+## 0.8.8
+
+- Require Dart 2.19
+- Add topics in `pubspec.yaml`.
+
+## 0.8.7
+
+- Fix `Bucket.write` when size is below 1MB.
+
+## 0.8.6
+
+- Throttle streams piped into `Bucket.write` when the size is not known
+  beforehand.
+- Support the latest version 9.0.0 of the `googleapis` package.
+
+## 0.8.5
+
+- Support the latest version 7.0.0 of the `googleapis` package.
+
+## 0.8.4
+
+- Support the latest version 6.0.0 of the `googleapis` package.
+
+## 0.8.3
+
+- Support the latest version of the `googleapis` package.
+
+## 0.8.2
+
+ * **BREAKING CHANGE:** `Page.next()` throws if `Page.isLast`, this change only
+   affects code not migrated to null-safety, when paging through results in
+   pub-sub and storage without checking `Page.isLast`.
+   Code fully migrated to null-safety will have experienced a runtime null check
+   error, and paging code for datastore already throw an `Error`.
+
+## 0.8.1
+
+ * `lookupOrNull` method in `DatastoreDB` and `Transaction`. 
+
+## 0.8.0
+
+ * Require Dart 2.12 or later
+ * Migration to null safety.
+
+## 0.7.3
+ * Fixed issue in reflection code affecting `Model<int>` and `Model<String>`,
+   but not `Model<dynamic>`.
+
+## 0.7.2
+
+ * Added `delimiter` to `Bucket.list` and `Bucket.page`
+   (`0.7.1` only added them the implementation).
+
+## 0.7.1
+
+ * Added `delimiter` to `Bucket.list` and `Bucket.page`.
+ * Fix typing of `ExpandoModel` to `ExpandoModel<T>` as we should have done in
+   version `0.7.0`.
+
+## 0.7.0+2
+
+ * Upgrade dependency on `_discoveryapis_commons`, changing `ApiRequestError`
+   from an `Error` to an `Exception`. Version constraints on
+   `_discoveryapis_commons` allows both new and old versions.
+
+## 0.7.0+1
+
+ * Fix path separator in Bucket.list().
+
+## 0.7.0
+
+ * **BREAKING CHANGE:** Add generics support for `Model.id`.  
+   It is now possible to define the type of the id a model has (either `String`
+   or `int`). A model can now be defined as
+   `class MyModel extends Model<String> {}` and `myModel.id` will then
+   be of type `String` and `myModel.key` of type `Key<String>`.
+
+## 0.6.4
+
+ * Require minimum Dart SDK `2.3.0`.
+
+## 0.6.3
+
+ * Added `DatastoreDB.lookupValue()`
+
+## 0.6.2
+
+ * Fixed bug in `Transaction.rollback()`.
+
+## 0.6.1
+
+ * Added examples.
+ * Fixed formatting and lints.
+ * Allow `Model` classes to contain constructors with optional or named
+   arguments (as long as they're annotated with `@required`).
+ * Add generics support to `withTransaction()`.
+
+## 0.6.0+4
+
+ * Updated package description.
+ * Added an example showing how to use Google Cloud Storage.
+
+## 0.6.0+3
+
+ * Fixed code formatting and lints.
+
+## 0.6.0+2
+
+* Support the latest `pkg:http`.
+
+## 0.6.0+1
+
+* Add explicit dependency to `package:_discoveryapis_commons`
+* Widen sdk constraint to <3.0.0
+
+## 0.6.0
+
+* **BREAKING CHANGE:** Add generics support. Instead of writing
+  `db.query(Person).run()` and getting back a generic `Stream<Model>`, you now
+  write `db.query<Person>().run()` and get `Stream<Person>`.
+  The same goes for `.lookup([key])`, which can now be written as
+  `.lookup<Person>([key])` and will return a `List<Person>`.
+
+## 0.5.0
+
+* Fixes to support Dart 2.
+
+## 0.4.0+1
+
+* Made a number of strong-mode improvements.
+
+* Updated dependency on `googleapis` and `googleapis_beta`.
+
+## 0.4.0
+
+* Remove support for `FilterRelation.In` and "propertyname IN" for queries:
+  This is not supported by the newer APIs and was originally part of fat-client
+  libraries which performed multiple queries for each item in the list.
+
+* Adds optional `forComparison` named argument to `Property.encodeValue` which
+  will be set to `true` when encoding a value for comparison in queries.
+
+* Upgrade to newer versions of `package:googleapis` and `package:googleapis_beta`
+
+## 0.3.0
+
+* Upgrade to use stable `package:googleapis/datastore/v1.dart`.
+
+* The internal [DatastoreImpl] class takes now a project name without the `s~`
+  prefix.
+
+## 0.2.0+14
+
+* Fix analyzer warning.
+
+## 0.2.0+13
+
+* Remove crypto dependency and upgrade dart dependency to >=1.13 since
+  this dart version provides the Base64 codec.
+
+## 0.2.0+11
+
+* Throw a [StateError] in case a query returned a kind for which there was no
+  model registered.
+
+## 0.2.0+10
+
+* Address analyzer warnings.
+
+## 0.2.0+9
+
+* Support value transformation in `db.query().filter()`.
+* Widen constraint on `googleapis` and `googleapis_beta`.
+
+## 0.2.0+8
+
+* Widen constraint on `googleapis` and `googleapis_beta`.
+
+## 0.2.0+4
+
+* `Storage.read` now honors `offset` and `length` arguments.
+
+## 0.2.0+2
+
+* Widen constraint on `googleapis/googleapis_beta`
+
+## 0.2.0+1
+
+* Fix broken import of package:googleapis/common/common.dart.
+
+## 0.2.0
+
+* Add support for Cloud Pub/Sub.
+* Require Dart version 1.9.
+
+## 0.1.4+2
+
+* Enforce fully populated entity keys in a number of places.
+
+## 0.1.4+1
+
+* Deduce the query partition automatically from query ancestor key.
+
+## 0.1.4
+
+* Added optional `defaultPartition` parameter to the constructor of
+  `DatastoreDB`.
+
+## 0.1.3+2
+
+* Widened googleapis/googleapis_beta constraints in pubspec.yaml.
+
+## 0.1.3+1
+
+* Change the service scope keys to non-private symbols.
+
+## 0.1.3
+
+* Widen package:googleapis dependency constraint in pubspec.yaml.
+* Bugfix in `package:appengine/db.dart`: Correctly handle ListProperties
+of length 1.
+
+## 0.1.2
+
+* Introduced `package:gcloud/service_scope.dart` library.
+* Added global getters for getting gcloud services from the current service
+scope.
+* Added an `package:gcloud/http.dart` library using service scopes.
+
+## 0.1.1
+
+* Increased version constraint on googleapis{,_auth,_beta}.
+
+* Removed unused imports.
+
+## 0.1.0
+
+* First release.