'Kevin Moore' via Dart Misc
2018-02-27 22:37:46 UTC
*If you care about what's in .gitignore files for Dart/Flutter projects â
or if you create documents or tools that deal with such things, keep
reading...*
*tl;dr: docs/templates that deal with .gitignore should start include
.dart_tool *
*Details:*
- The pub tool <https://www.dartlang.org/tools/pub> often creates a
'.pub' directory in a Dart package to cache snapshots for package binaries.
- We have other tools â like package:build
<https://github.com/dart-lang/build> â that also needs to cache
artifacts.
- We've decided to standardize on `.dart_tool` as the place all tools
should put their package-level caches
- Instead of inventing a new "dot" directory for every tool â and
then having to educate folks to ignore it.
- Convention: .dart_tool/*name_of_package*
- pub will start using .dart_tool/pub soon
- Commit has already landed in the pub repo: https://github.com/dart-
lang/pub/commit/68a6c12602d564316bc9aa0f115ad625d825effe
<https://github.com/dart-lang/pub/commit/68a6c12602d564316bc9aa0f115ad625d825effe>
- Need to sync pub into the SDK for this to go live:
https://github.com/dart-lang/sdk/issues/32030
<https://github.com/dart-lang/sdk/issues/32030>
- build tools have used .dart_tool/build for a while now
We already document .dart_tool on our site: https://www.dartlang.
org/guides/libraries/private-files
We've also updated stagehand templates: https://github.com/
dart-lang/stagehand/commit/937a17da1c89c048a62b0b311ab1e1092fc0d40b
or if you create documents or tools that deal with such things, keep
reading...*
*tl;dr: docs/templates that deal with .gitignore should start include
.dart_tool *
*Details:*
- The pub tool <https://www.dartlang.org/tools/pub> often creates a
'.pub' directory in a Dart package to cache snapshots for package binaries.
- We have other tools â like package:build
<https://github.com/dart-lang/build> â that also needs to cache
artifacts.
- We've decided to standardize on `.dart_tool` as the place all tools
should put their package-level caches
- Instead of inventing a new "dot" directory for every tool â and
then having to educate folks to ignore it.
- Convention: .dart_tool/*name_of_package*
- pub will start using .dart_tool/pub soon
- Commit has already landed in the pub repo: https://github.com/dart-
lang/pub/commit/68a6c12602d564316bc9aa0f115ad625d825effe
<https://github.com/dart-lang/pub/commit/68a6c12602d564316bc9aa0f115ad625d825effe>
- Need to sync pub into the SDK for this to go live:
https://github.com/dart-lang/sdk/issues/32030
<https://github.com/dart-lang/sdk/issues/32030>
- build tools have used .dart_tool/build for a while now
We already document .dart_tool on our site: https://www.dartlang.
org/guides/libraries/private-files
We've also updated stagehand templates: https://github.com/
dart-lang/stagehand/commit/937a17da1c89c048a62b0b311ab1e1092fc0d40b
--
For other discussions, see https://groups.google.com/a/dartlang.org/
For HOWTO questions, visit http://stackoverflow.com/tags/dart
To file a bug report or feature request, go to http://www.dartbug.com/new
---
You received this message because you are subscribed to the Google Groups "Dart Misc" group.
To unsubscribe from this group and stop receiving emails from it, send an email to misc+***@dartlang.org.
For other discussions, see https://groups.google.com/a/dartlang.org/
For HOWTO questions, visit http://stackoverflow.com/tags/dart
To file a bug report or feature request, go to http://www.dartbug.com/new
---
You received this message because you are subscribed to the Google Groups "Dart Misc" group.
To unsubscribe from this group and stop receiving emails from it, send an email to misc+***@dartlang.org.