Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Next Next commit
Initial, unchanged snapshot of original repo.
  • Loading branch information
stuartmorgan-g committed Oct 9, 2023
commit 5dc916716e5f31d2d4199106ad558bdb568bf349
38 changes: 38 additions & 0 deletions packages/process/.github/workflows/process.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
name: Process Package

on:
push:
branches: [ master ]
pull_request:
branches: [ master ]
workflow_dispatch:

jobs:
correctness:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@5a4ac9002d0be2fb38bd78e4b4dbde5606d7042f
- uses: dart-lang/setup-dart@9a04e6d73cca37bd455e0608d7e5092f881fd603
with:
sdk: dev
- name: Install dependencies
run: dart pub upgrade
- name: Verify formatting
run: dart format --output=none --set-exit-if-changed .
- name: Analyze project source
run: dart analyze --fatal-infos
test:
runs-on: ${{ matrix.os }}
strategy:
matrix:
os: [ubuntu-latest, macos-latest, windows-latest]
sdk: [stable, beta, dev]
steps:
- uses: actions/checkout@5a4ac9002d0be2fb38bd78e4b4dbde5606d7042f
- uses: dart-lang/setup-dart@9a04e6d73cca37bd455e0608d7e5092f881fd603
with:
sdk: ${{ matrix.sdk }}
- name: Install dependencies
run: dart pub upgrade
- name: Run Tests
run: dart test
17 changes: 17 additions & 0 deletions packages/process/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
### Dart template
# Don’t commit the following directories created by pub.
.buildlog
.dart_tool
.pub/
build/
packages
.packages

# Include when developing application packages.
pubspec.lock

# IDE
.project
.settings
.idea
.c9
6 changes: 6 additions & 0 deletions packages/process/AUTHORS
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# Below is a list of people and organizations that have contributed
# to the Process project. Names should be added to the list like so:
#
# Name/Organization <email address>

Google Inc.
188 changes: 188 additions & 0 deletions packages/process/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,188 @@
#### 5.0.0

* Remove the `covariant` keyword from `stderrEncoding` and `stdoutEncoding`
parameters.
* Update dependencies to work on Dart 3.
* Bumped min SDK dependency to nearest non-prerelease version (2.14.0)

#### 4.2.4

* Mark `stderrEncoding` and `stdoutEncoding` parameters as nullable again,
now that the upstream SDK issue has been fixed.

#### 4.2.3

* Rollback to version 4.2.1 (https://github.com/google/process.dart/issues/64)

#### 4.2.2

* Mark `stderrEncoding` and `stdoutEncoding` parameters as nullable.

#### 4.2.1

* Added custom exception types `ProcessPackageException` and
`ProcessPackageExecutableNotFoundException` to provide extra
information from exception conditions.

#### 4.2.0

* Fix the signature of `ProcessManager.canRun` to be consistent with
`LocalProcessManager`.

#### 4.1.1

* Fixed `getExecutablePath()` to only return path items that are
executable and readable to the user.

#### 4.1.0

* Fix the signatures of `ProcessManager.run`, `.runSync`, and `.start` to be
consistent with `LocalProcessManager`'s.
* Added more details to the `ArgumentError` thrown when a command cannot be resolved
to an executable.

#### 4.0.0

* First stable null safe release.

#### 4.0.0-nullsafety.4

* Update supported SDK range.

#### 4.0.0-nullsafety.3

* Update supported SDK range.

#### 4.0.0-nullsafety.2

* Update supported SDK range.

#### 4.0.0-nullsafety.1

* Migrate to null-safety.
* Remove record/replay functionality.
* Remove implicit casts in preparation for null-safety.
* Remove dependency on `package:intl` and `package:meta`.

#### 3.0.13

* Handle `currentDirectory` throwing an exception in `getExecutablePath()`.

#### 3.0.12

* Updated version constraint on intl.

#### 3.0.11

* Fix bug: don't add quotes if the file name already has quotes.

#### 3.0.10

* Added quoted strings to indicate where the command name ends and the arguments
begin otherwise, the file name is ambiguous on Windows.

#### 3.0.9

* Fixed bug in `ProcessWrapper`

#### 3.0.8

* Fixed bug in `ProcessWrapper`

#### 3.0.7

* Renamed `Process` to `ProcessWrapper`

#### 3.0.6

* Added class `Process`, a simple wrapper around dart:io's `Process` class.

#### 3.0.5

* Fixes for missing_return analysis errors with 2.10.0-dev.1.0.

#### 3.0.4

* Fix unit tests
* Update SDK constraint to 3.

#### 3.0.3

* Update dependency on `package:file`

#### 3.0.2

* Remove upper case constants.
* Update SDK constraint to 2.0.0-dev.54.0.
* Fix tests for Dart 2.

#### 3.0.1

* General cleanup

#### 3.0.0

* Cleanup getExecutablePath() to better respect the platform

#### 2.0.9

* Bumped `package:file` dependency

### 2.0.8

* Fixed method getArguments to qualify the map method with the specific
String type

### 2.0.7

* Remove `set exitCode` instances

### 2.0.6

* Fix SDK constraint.
* rename .analysis_options file to analaysis_options.yaml.
* Use covariant in place of @checked.
* Update comment style generics.

### 2.0.5

* Bumped maximum Dart SDK version to 2.0.0-dev.infinity

### 2.0.4

* relax dependency requirement for `intl`

### 2.0.3

* relax dependency requirement for `platform`

#### 2.0.2

* Fix a strong mode function expression return type inference bug with Dart
1.23.0-dev.10.0.

#### 2.0.1

* Fixed bug in `ReplayProcessManager` whereby it could try to write to `stdout`
or `stderr` after the streams were closed.

#### 2.0.0

* Bumped `package:file` dependency to 2.0.1

#### 1.1.0

* Added support to transparently find the right executable under Windows.

#### 1.0.1

* The `executable` and `arguments` parameters have been merged into one
`command` parameter in the `run`, `runSync`, and `start` methods of
`ProcessManager`.
* Added support for sanitization of command elements in
`RecordingProcessManager` and `ReplayProcessManager` via the `CommandElement`
class.

#### 1.0.0

* Initial version
24 changes: 24 additions & 0 deletions packages/process/CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
# How to contribute

We'd love to accept your patches and contributions to this project. There are
just a few small guidelines you need to follow.

## Contributor License Agreement

Contributions to this project must be accompanied by a Contributor License
Agreement. You (or your employer) retain the copyright to your contribution,
this simply gives us permission to use and redistribute your contributions as
part of the project. Head over to <https://cla.developers.google.com/> to see
your current agreements on file or to sign a new one.

You generally only need to submit a CLA once, so if you've already submitted one
(even if it was for a different project), you probably don't need to do it
again.

## Code reviews

All submissions, including submissions by project members, require review. We
use GitHub pull requests for this purpose. Consult [GitHub Help] for more
information on using pull requests.

[GitHub Help]: https://help.github.com/articles/about-pull-requests/
26 changes: 26 additions & 0 deletions packages/process/LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
Copyright 2017, the Dart project authors. All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are
met:

* Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above
copyright notice, this list of conditions and the following
disclaimer in the documentation and/or other materials provided
with the distribution.
* Neither the name of Google Inc. nor the names of its
contributors may be used to endorse or promote products derived
from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
15 changes: 15 additions & 0 deletions packages/process/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# Process

[![Build Status -](https://travis-ci.org/google/process.dart.svg?branch=master)](https://travis-ci.org/google/process.dart)
[![Coverage Status -](https://coveralls.io/repos/github/google/process.dart/badge.svg?branch=master)](https://coveralls.io/github/google/process.dart?branch=master)

A generic process invocation abstraction for Dart.

Like `dart:io`, `package:process` supplies a rich, Dart-idiomatic API for
spawning OS processes.

Unlike `dart:io`, `package:process`:

- Can be used to implement custom process invocation backends.
- Comes with a record-replay implementation out-of-the-box, making it super
easy to test code that spawns processes in a hermetic way.
6 changes: 6 additions & 0 deletions packages/process/analysis_options.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
include: package:lints/recommended.yaml

analyzer:
errors:
# Allow having TODOs in the code
todo: ignore
8 changes: 8 additions & 0 deletions packages/process/lib/process.dart
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
// Copyright (c) 2017, the Dart project authors. Please see the AUTHORS file
// for details. All rights reserved. Use of this source code is governed by a
// BSD-style license that can be found in the LICENSE file.

export 'src/interface/exceptions.dart';
export 'src/interface/local_process_manager.dart';
export 'src/interface/process_manager.dart';
export 'src/interface/process_wrapper.dart';
Loading